addCalendar

fügt einen Kalender in das Gantt-Diagramm ein

string addCalendar(CalendarConfig calendar);

calendar

CalendarConfig

ein Objekt, das die Konfiguration des Kalenders enthält

string

die Kennung des Kalenders

Example

// Hinzufügen eines bestehenden Kalenders
var calendarId = gantt.addCalendar(calendar);
 
// Hinzufügen eines Kalenders mit einer neuen Konfiguration
var calendarId = gantt.addCalendar({
    id:"custom", // optional
    worktime: {
        hours: ["8:00-17:00"],
        days: [ 1, 1, 1, 1, 1, 1 ,1]
    }
});
 
var calendar = gantt.getCalendar(calendarId);

Related samples

Details

Das Kalender-Konfigurationsobjekt kann die folgenden Eigenschaften enthalten:

id? - (string | number) - optional, die Kennung des Kalenders
worktime? - (object) - definiert die Arbeitstage und Arbeitszeiten. Es kann enthalten:
- hours? - (string[] | number[] | boolean) - optional, ein Array zur Angabe globaler Arbeitszeiten, die Start- und Endzeiten der Aufgaben definieren
- days? - (WorkDaysTuple) - optional, ein Array mit 7 Elementen, die die Wochentage repräsentieren (0 - Sonntag bis 6 - Samstag), wobei 1/true einen Arbeitstag und 0/false einen freien Tag bedeutet
- customWeeks? - (object) - optional, ein Objekt, das unterschiedliche Arbeitszeitregelungen für verschiedene Zeiträume definiert. Es besteht aus Schlüssel-Wert-Paaren, wobei der Schlüssel der Name des Zeitraums ist und der Wert ein Objekt mit dessen Eigenschaften.
  - [timespan: string] - (object) - der Zeitraum mit seinen Arbeitszeiteinstellungen. Der Schlüssel dient als Name des Zeitraums.
    - from - (Date) - das Anfangsdatum des Zeitraums
    - to - (Date) - das Enddatum des Zeitraums
    - hours? - (Array<string | number>) - optional, ein Array von Arbeitszeitintervallen als 'von'-'bis' Paare. Ein Wert 'false' markiert einen freien Tag, während 'true' (Standard) die Standardzeiten (["8:00-17:00"]) anwendet
    - days? - (WorkDaysTuple | boolean) - optional, ein Array mit 7 Elementen, die die Wochentage repräsentieren (0 - Sonntag bis 6 - Samstag), wobei 1/true einen Arbeitstag und 0/false einen freien Tag anzeigt.

Benutzerdefinierte Arbeitszeiten für einen bestimmten Tag festlegen

Anstatt nur die Tagesnummer der Woche anzugeben, ist es möglich, für diesen Tag benutzerdefinierte Arbeitszeiten einzustellen.
Zum Beispiel:

var calendar = {
    id:"calendar1", // optional
    worktime: {
        hours: ["8:00-17:00"],
        days: [ 0, 1, 1, 1, ["12:00-17:00"], 1, 0]
    }
}

Hier legt ["12:00-17:00"] die Arbeitszeit für Donnerstag von 12 Uhr bis 17 Uhr fest.

Arbeitszeiten für verschiedene Zeiträume definieren

Sie können unterschiedliche Arbeitszeitregelungen für verschiedene Zeiträume mit der Eigenschaft customWeeks angeben:

// Hinzufügen eines Kalenders mit einer neuen Konfiguration
gantt.addCalendar({
    id:"default", // optional
    worktime: {
        hours: ["8:00-17:00"],
        days: [ 1, 1, 1, 1, 1, 1 ,1],
        customWeeks: {
            winter: {
                from: new Date(2020, 11, 1),// 1. Dezember 2020
                to: new Date(2021, 2, 1),// 1. März 2021 00:00
                hours: ["9:00-13:00", "14:00-16:00"],
                days: [ 1, 1, 1, 1, 0, 0, 0]
            }
        }
    }
});