Zum Hauptinhalt springen

addCalendar

Description​

Fügt einen Kalender in das Gantt-Diagramm ein

addCalendar: (calendar: CalendarConfig) => string

Parameters​

  • calendar - (required) CalendarConfig - ein Objekt, das die Konfiguration des Kalenders enthält

Returns​

  • calendarId - (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);

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]
            }
        }
    }
});


Change log​

  • die Eigenschaft customWeeks wurde in Version 7.1 eingeführt;
  • hinzugefügt in Version 4.2