calendar

the interface of the working calendar object

object calendar;
Details

Read the Work Time Calculation article for detailed info on working calendars.

The calendar object possesses the following methods and properties:

Methods

  • setWorkTime (config): boolean - sets the working time for the Gantt chart
    • config - (object) - the configuration object of a time span:
      • day? - (string | number) - optional, a number of a week day [0 (Sunday) - 6 (Saturday)]. Note, you can set only 1 day at once
      • date? - (Date) - optional, a specific date to set as a working day or day off
      • hours? - (Array<string | number> | boolean) - optional, an array of working hours as 'from'-'to' pairs.'false' value sets a day-off, 'true' (default value) applies the default hours (["8:00-17:00"])
      • customWeeks? - (object) - optional, an object with different working-time rules for different periods of time. The object can contain a set of key:value pairs where key is the name of a time span and value is an object with a list of attributes.
        • [timespan: string] - (object) - the time span with the working time settings. The name of that object is used as the name of the time span
          • from - (Date) - the date when the time span is scheduled to begin
          • to - (Date) - the date when the time span is scheduled to be completed
          • hours? - (Array<string | number>) - optional, an array of working hours as 'from'-'to' pairs.'false' value sets a day-off, 'true' (default value) applies the default hours (["8:00-17:00"])
          • days? - (Array<string | number | Array<string | number>> | boolean) - optional, an array of 7 days of the week (from 0 - Sunday, to 6 - Saturday), where 1/true stands for a working day and 0/false - a non-working day.
calendar.setWorkTime({ hours:["9:00-18:00"] });
  • unsetWorkTime (config): void - unsets a working time in the Gantt Chart
    • config - (object) - the configuration object of a time span:
      • day? - (string | number) - optional, a number of a week day [0 (Sunday) - 6 (Saturday)]. Note, you can set only 1 day at once
      • date? - (Date) - optional, a specific date to set as a working day or day off
      • hours? - (Array<string | number> | boolean) - optional, an array of working hours as 'from'-'to' pairs. 'false' value sets a day-off, 'true' (default value) applies the default hours (["8:00-17:00"])
calendar.unsetWorkTime({ hours:["9:00-18:00"] });
  • isWorkTime (config, time_unit): boolean - checks whether the specified date is working
    • config - (Date | object) - either a date to check or the configuration object of a time span:
      • date - (Date) - a date to check
      • unit? - (string) - optional, a time unit: "minute", "hour", "day", "week", "month", "year"
      • task? - (Task) - optional, the object of the task the duration of which should be calculated
    • time_unit? - (string) - optional, a time unit: "minute", "hour", "day", "week", "month", "year". Not needed at all when the first parameter is specified as an object

var calendar = gantt.getTaskCalendar(task);
if (calendar.isWorkTime({date: date})){
    alert("worktime of task" + task.text);
}
  • getClosestWorkTime (config): Date - returns the closest working time
    • config - (Date | object) - the configuration object:
      • date - (Date) - a date to get the closest working time for
      • dir? - (string) - optional, specifies the direction of the closest time: "future" or "past"
      • unit? - (string) - optional, a time unit to search for the closest working time
      • task? - (Task) - optional, the object of the task to use its calendar
calendar.getClosestWorkTime({
    date:new Date(2013,0,1), 
    dir:"future", 
    unit:"hour"
});
  • calculateEndDate (config, duration, unit): Date - calculates the end date of a task
    • config - (Date | object) - either the date when a task is scheduled to begin or the configuration object of a time span:
      • start_date - (Date) - the date when a task is scheduled to begin
      • duration - (number) - the duration of a task
      • unit? - (string) - optional, the time unit of the duration: "minute", "hour", "day", "week", "month", "year"
      • task? - (Task) - optional, the object of the task the duration of which should be calculated
    • duration? - (number) - optional, the duration of a task. Not needed at all when the first parameter is specified as an object
    • unit? - (string) - optional, the time unit of the duration. Not needed at all when the first parameter is specified as an object
var end_date = calendar.calculateEndDate({start_date:date, duration:duration});
  • calculateDuration (config, end): number - calculates the duration of a task
    • config - (Date | object) - either the date when a task is scheduled to begin or the configuration object of a time span:
      • start_date - (Date) - the date when a task is scheduled to begin
      • end_date - (Date) - the date when a task is scheduled to be completed
      • task? - (Task) - optional, the object of the task the duration of which should be calculated
    • end? - (Date) - the date when a task is scheduled to be completed. Not needed at all when the first parameter is specified as an object
calendar.calculateDuration(new Date(2013,02,15), new Date(2013,02,25));

Properties

  • id - (string | number) - the id of a task's calendar
See also
Back to top