addCalendar

добавляет календарь в Gantt

string addCalendar(CalendarConfig calendar);

calendar

CalendarConfig

объект с конфигурацией календаря

string

id календаря

Example

// добавление ранее созданного календаря
var calendarId = gantt.addCalendar(calendar);
 
// добавление календаря с новой конфигурацией
var calendarId = gantt.addCalendar({
    id:"custom", // необязательный
    worktime: {
        hours: ["8:00-17:00"],
        days: [ 1, 1, 1, 1, 1, 1 ,1]
    }
});
 
var calendar = gantt.getCalendar(calendarId);

Related samples

Details

Объект конфигурации календаря может содержать следующие атрибуты:

id? - (string | number) - необязательный, id календаря
worktime? - (object) - объект, который задает рабочее время в днях и часах. Он может включать:
- hours? - (string[] | number[] | boolean) - необязательный, массив с глобальными рабочими часами, задает часы начала и окончания задачи
- days? - (WorkDaysTuple) - необязательный, массив из 7 дней недели (от 0 - воскресенье, до 6 - суббота), где 1/true обозначает рабочий день, а 0/false - нерабочий день
- customWeeks? - (object) - необязательный, объект с различными правилами рабочего времени для разных периодов времени. Объект может содержать набор пар ключ:значение, где ключ - это название временного интервала, а значение - это объект со списком атрибутов.
  - [timespan: string] - (object) - временной интервал с настройками рабочего времени. Название этого объекта используется как название временного интервала
    - from - (Date) - дата, когда временной интервал должен начаться
    - to - (Date) - дата, когда временной интервал должен завершиться
    - hours? - (Array<string | number>) - необязательный, массив рабочих часов в виде пар 'от'-'до'. Значение 'false' устанавливает выходной день, 'true' (значение по умолчанию) применяет стандартные часы (["8:00-17:00"])
    - days? - (WorkDaysTuple | boolean) - необязательный, массив из 7 дней недели (от 0 - воскресенье, до 6 - суббота), где 1/true обозначает рабочий день, а 0/false - нерабочий день.

Установка индивидуальных рабочих часов для дня

Вместо номера дня недели, вы также можете установить кастомные рабочие часы для этого дня.
Например:

var calendar = {
    id:"calendar1", // необязательный
    worktime: {
        hours: ["8:00-17:00"],
        days: [ 0, 1, 1, 1, ["12:00-17:00"], 1, 0]
    }
}

где ["12:00-17:00"] - это рабочие часы с 12 до 17 для четверга.

Установка рабочего времени для различных временных интервалов

Существует возможность настроить различные правила рабочего времени для разных периодов времени с помощью атрибута customWeeks:

// добавление календаря с новой конфигурацией
gantt.addCalendar({
    id:"default", // необязательный
    worktime: {
        hours: ["8:00-17:00"],
        days: [ 1, 1, 1, 1, 1, 1 ,1],
        customWeeks: {
            winter: {
                from: new Date(2020, 11, 1),// 1 декабря 2020
                to: new Date(2021, 2, 1),// 1 марта 00:00, 2021
                hours: ["9:00-13:00", "14:00-16:00"],
                days: [ 1, 1, 1, 1, 0, 0, 0]
            }
        }
    }
});