Package io.jmix.businesscalendar.model

Interface BusinessCalendar

All Known Implementing Classes:
BusinessCalendarImpl
public interface BusinessCalendar
Defines API to operate with date and time in terms of "business hours".

  • Method Summary

    Modifier and Type
    Method
    Description
    String
    getCode()
    Returns code of given business calendar which should be unique among all registered calendars.
    String
    getName()
    Returns human-readable name of given business calendar.
    String
    getSource()
    Returns source from which given calendar come from.
    boolean
    isBusinessDay(LocalDate date)
    Checks if provided date belongs to business days.
    boolean
    isBusinessTime(LocalDateTime dateTime)
    Checks if provided date-time belongs to business time.
    LocalDate
    minus(LocalDate date, int daysToSubtract)
    Returns a copy of provided date with the specified amount of business days subtracted.
    LocalDateTime
    minus(LocalDateTime dateTime, int hoursToSubtract)
    Returns a copy of provided date-time with the specified amount of business hours subtracted.
    LocalDateTime
    minus(LocalDateTime dateTime, Duration duration)
    Returns a copy of provided date-time with the specified duration in terms of working time subtracted.
    LocalDate
    plus(LocalDate date, int daysToAdd)
    Returns a copy of provided date with the specified amount of business days added.
    LocalDateTime
    plus(LocalDateTime dateTime, int hoursToAdd)
    Returns a copy of provided date-time with the specified amount of business hours added.
    LocalDateTime
    plus(LocalDateTime dateTime, Duration duration)
    Returns a copy of provided date-time with the specified duration in terms of working time added.

  • Method Details

    • getName

      String getName()
      Returns human-readable name of given business calendar.
      Returns:
      calendar's name

    • getCode

      String getCode()
      Returns code of given business calendar which should be unique among all registered calendars.
      Returns:
      calendar's unique identifier

    • getSource

      String getSource()
      Returns source from which given calendar come from. Possible variants are annotatedClass and database.
      Returns:
      calendar's source
      See Also:

    • isBusinessDay

      boolean isBusinessDay(LocalDate date)
      Checks if provided date belongs to business days.
      Parameters:
      date - date to be checked.
      Returns:
      true if this date is business day.

    • plus

      LocalDate plus(LocalDate date, int daysToAdd)
      Returns a copy of provided date with the specified amount of business days added.
      Parameters:
      date - source date.
      daysToAdd - count of business days to add.
      Returns:
      a LocalDate based on provided with the specified amount of provided business days added.

    • minus

      LocalDate minus(LocalDate date, int daysToSubtract)
      Returns a copy of provided date with the specified amount of business days subtracted.
      Parameters:
      date - source date.
      daysToSubtract - count of business days to subtract.
      Returns:
      a LocalDate based on provided with the specified amount of provided business days subtracted.

    • isBusinessTime

      boolean isBusinessTime(LocalDateTime dateTime)
      Checks if provided date-time belongs to business time.
      Parameters:
      dateTime - source date-time.
      Returns:
      true if provided date-time is business time.

    • plus

      LocalDateTime plus(LocalDateTime dateTime, int hoursToAdd)
      Returns a copy of provided date-time with the specified amount of business hours added.
      Parameters:
      dateTime - source date-time.
      hoursToAdd - count of working hours to added.
      Returns:
      a LocalDateTime based on provided date-time with the addition of provided working hours made.

    • minus

      LocalDateTime minus(LocalDateTime dateTime, int hoursToSubtract)
      Returns a copy of provided date-time with the specified amount of business hours subtracted.
      Parameters:
      dateTime - source date-time.
      hoursToSubtract - count of working hours to subtract.
      Returns:
      a LocalDateTime based on provided date-time with the extraction of provided working hours made.

    • plus

      LocalDateTime plus(LocalDateTime dateTime, Duration duration)
      Returns a copy of provided date-time with the specified duration in terms of working time added.

      Extra caution is needed when duration is obtained using the number of days. In this case the resulting date-time will be calculated by adding 24*days business hours that might be not desired behavior.

      Parameters:
      dateTime - source date-time.
      duration - duration in terms of working time to be added.
      Returns:
      a LocalDateTime based on provided date-time with the addition of provided duration made.

    • minus

      LocalDateTime minus(LocalDateTime dateTime, Duration duration)
      Returns a copy of provided date-time with the specified duration in terms of working time subtracted.

      Extra caution is needed when duration is obtained using the number of days. In this case the resulting date-time will be calculated by subtracting 24*days business hours that might be not desired behavior.

      Parameters:
      dateTime - source date-time.
      duration - duration in terms of working time to be subtracted.
      Returns:
      a LocalDateTime based on provided date-time with the extraction of provided duration made.