Options
All
  • Public
  • Public/Protected
  • All
Menu

Calendar for project scheduling, mixed by CoreCalendarMixin and BaseCalendarMixin. It is used to mark certain time intervals as "non-working" and ignore them during scheduling.

The calendar consists from several intervals. The intervals can be either static or recurrent.

tier

community

Hierarchy

Index

Properties

$project

The project instance, this entity belongs to.

cls

cls: string

A CSS class to add to non-working time elements rendered in the UI

iconCls

iconCls: string

A CSS class defining an icon to display inside non-working time elements rendered in the UI

ignoreTimeZone

ignoreTimeZone: boolean

If set to true, the calendar will ignore the project current timeZone setting. Used in the default "weekends" calendar

name

name: string

The calendar name

treatInconsistentIntervals

treatInconsistentIntervals: TreatInconsistentIntervals

A flag indicating how to treat invalid intervals produced by recurrence start/end rules. The recurrences could be misconfigured, producing unmatched start and end date instances.

The field supports the following set of values:

  • [TreatInconsistentIntervals.Skip Skip] - skip such intervals silently (default)
  • [TreatInconsistentIntervals.Throw Throw] - throw an exception when facing such invalid interval

unspecifiedTimeIsWorking

unspecifiedTimeIsWorking: boolean

The flag, indicating, whether the "unspecified" time (time that does not belong to any interval) is working (true) or not (false). Default value is true

Accessors

dateHelper

  • get dateHelper(): any
  • Returns the timezone-aware date helper if the project has one configured, otherwise returns the static DateHelper class.

    internal

    Returns any

Methods

accumulateWorkingTime

  • This method starts at the given date and moves forward or backward in time, depending on isForward. It stops moving as soon as it accumulates the durationMs milliseconds of working time and returns the date at which it has stopped and remaining duration - the AccumulateWorkingTimeResult object.

    Normally, the remaining duration will be 0, indicating the full durationMs has been accumulated. However, sometimes, calendar might not be able to accumulate enough working time due to various reasons, like if it does not contain enough working time - this case will be indicated with remaining duration bigger than 0.

    Parameters

    • date: Date
    • durationMs: Duration
    • isForward: boolean

    Returns AccumulateWorkingTimeResult

addInterval

addIntervals

calculateDurationMs

  • calculateDurationMs(startDate: Date, endDate: Date, allowNegative?: Boolean): Duration
  • Calculate the working time duration between the 2 dates, in milliseconds.

    Parameters

    • startDate: Date
    • endDate: Date
    • Default value allowNegative: Boolean = false

    Returns Duration

calculateEndDate

  • calculateEndDate(startDate: Date, durationMs: Duration): Date | null
  • Calculate the end date of the time interval which starts at startDate and has durationMs working time duration (in milliseconds).

    Parameters

    Returns Date | null

calculateStartDate

  • calculateStartDate(endDate: Date, durationMs: Duration): Date | null
  • Calculate the start date of the time interval which ends at endDate and has durationMs working time duration (in milliseconds).

    Parameters

    Returns Date | null

clearIntervals

  • clearIntervals(silent?: boolean): boolean
  • This method removes all intervals from the internal collection of the calendar

    Parameters

    • Optional silent: boolean

    Returns boolean

forEachAvailabilityInterval

  • forEachAvailabilityInterval(options: { endDate?: Date; isForward?: boolean; maxRange?: number; startDate?: Date }, func: (startDate: Date, endDate: Date, calendarCacheInterval: CalendarCacheInterval) => any, scope?: object): CalendarIteratorResult
  • The core iterator method of the calendar.

    Parameters

    • options: { endDate?: Date; isForward?: boolean; maxRange?: number; startDate?: Date }

      The options for iterator. Should contain at least one of the startDate/endDate properties which indicates what timespan to examine for availability intervals. If one of boundaries is not provided iterator function should return false at some point, to avoid infinite loops.

      Another recognized option is isForward, which indicates the direction in which to iterate through the timespan.

      • Optional endDate?: Date
      • Optional isForward?: boolean
      • Optional maxRange?: number
      • Optional startDate?: Date
    • func: (startDate: Date, endDate: Date, calendarCacheInterval: CalendarCacheInterval) => any

      The iterator function to call. It will be called for every distinct set of availability intervals, found in the given timespan. All the intervals, which are "active" for current interval are collected in the 3rd argument for this function - calendarCacheInterval. If iterator returns false (checked with ===) the iteration stops.

    • Optional scope: object

      The scope (this value) to execute the iterator in.

    Returns CalendarIteratorResult

getAssignmentStore

  • getAssignmentStore(): this["project"]["assignmentStore"]
  • Convenience method to get the instance of the assignment store in the project instance, this entity belongs to.

    Returns this["project"]["assignmentStore"]

getCalendarManagerStore

  • getCalendarManagerStore(): this["project"]["calendarManagerStore"]
  • Convenience method to get the instance of the calendar manager store in the project instance, this entity belongs to.

    Returns this["project"]["calendarManagerStore"]

getDependencyStore

  • getDependencyStore(): this["project"]["dependencyStore"]
  • Convenience method to get the instance of the dependency store in the project instance, this entity belongs to.

    Returns this["project"]["dependencyStore"]

getEventStore

  • getEventStore(): this["project"]["eventStore"]
  • Convenience method to get the instance of the event store in the project instance, this entity belongs to.

    Returns this["project"]["eventStore"]

getNonWorkingTimeRanges

  • getNonWorkingTimeRanges(startDate: Date, endDate: Date, maxRange?: number): { endDate: Date; startDate: Date }[]
  • Returns non-working time ranges between the provided dates.

    Parameters

    • startDate: Date

      Start of the period to get ranges from.

    • endDate: Date

      End of the period to get ranges from.

    • Optional maxRange: number

    Returns { endDate: Date; startDate: Date }[]

getProject

  • getProject(): this["project"]

getResourceStore

  • getResourceStore(): this["project"]["resourceStore"]
  • Convenience method to get the instance of the resource store in the project instance, this entity belongs to.

    Returns this["project"]["resourceStore"]

getWorkingTimeRanges

  • getWorkingTimeRanges(startDate: Date, endDate: Date, maxRange?: number): { endDate: Date; startDate: Date }[]
  • Returns working time ranges between the provided dates.

    Parameters

    • startDate: Date

      Start of the period to get ranges from.

    • endDate: Date

      End of the period to get ranges from.

    • Optional maxRange: number

    Returns { endDate: Date; startDate: Date }[]

isWorkingTime

  • isWorkingTime(startDate: Date, endDate?: Date, fullyContained?: boolean): boolean
  • Checks if there is a working time interval in the provided time range (or when just startDate is provided, checks if the date is contained inside a working time interval in this calendar)

    Parameters

    • startDate: Date
    • Optional endDate: Date
    • Optional fullyContained: boolean

    Returns boolean

joinProject

  • joinProject(): void
  • Template method, which is called when model is joining the project (through joining some store that has already joined the project)

    Returns void

leaveProject

  • leaveProject(isReplacing?: boolean): void
  • Template method, which is called when model is leaving the project (through leaving some store usually)

    Parameters

    • Default value isReplacing: boolean = false

    Returns void

removeInterval

removeIntervals

setProject

  • setProject(project: this["project"]): this["project"]
  • The method to set the project instance, this entity belongs to.

    Parameters

    • project: this["project"]

    Returns this["project"]

skipNonWorkingTime

  • skipNonWorkingTime(date: Date, isForward?: boolean): Date | null | "empty_calendar"
  • Returns the earliest point at which a working period of time starts, following the given date. Can be the date itself, if it comes on the working time.

    Parameters

    • date: Date

      The date after which to skip the non-working time.

    • Default value isForward: boolean = true

      Whether the "following" means forward in time or backward.

    Returns Date | null | "empty_calendar"

Generated using TypeDoc