calendar

die Schnittstelle des Arbeitskalenderobjekts

Lesen Sie den Artikel Arbeitszeiterfassung für detaillierte Informationen zu Arbeitskalendern.

Das calendar-Objekt verfügt über die folgenden Methoden und Eigenschaften:

Methoden

• setWorkTime (config): boolean - legt die Arbeitszeit für das Gantt-Diagramm fest
  • config - (object) - das Konfigurationsobjekt eines Zeitraums:
    • day? - (string | number) - optional, eine Zahl für einen Wochentag [0 (Sonntag) - 6 (Samstag)]. Hinweis: Sie können nur 1 Tag auf einmal festlegen
    • date? - (Date) - optional, ein bestimmtes Datum, das als Arbeitstag oder freier Tag festgelegt werden soll
    • hours? - (string[] | number[] | boolean) - optional, ein Array von Arbeitsstunden als 'von'-'bis'-Paare. Der Wert 'false' legt einen freien Tag fest, 'true' (Standardwert) wendet die Standardstunden (["8:00-17:00"]) an
    • customWeeks? - (object) - optional, ein Objekt mit verschiedenen Arbeitszeitregeln für unterschiedliche Zeiträume. Das Objekt kann eine Menge von Schlüssel:Wert-Paaren enthalten, wobei der Schlüssel der Name eines Zeitraums und der Wert ein Objekt mit einer Liste von Attributen ist.
      • [timespan: string] - (object) - der Zeitraum mit den Arbeitszeiteinstellungen. Der Name dieses Objekts wird als Name des Zeitraums verwendet
        • from - (Date) - das Datum, an dem der Zeitraum beginnen soll
        • to - (Date) - das Datum, an dem der Zeitraum abgeschlossen sein soll
        • hours? - (string[] | number[]) - optional, ein Array von Arbeitsstunden als 'von'-'bis'-Paare. Der Wert 'false' legt einen freien Tag fest, 'true' (Standardwert) wendet die Standardstunden (["8:00-17:00"]) an
        • days? - (WorkDaysTuple | boolean) - optional, ein Array von 7 Tagen der Woche (von 0 - Sonntag bis 6 - Samstag), wobei 1/true für einen Arbeitstag und 0/false für einen freien Tag steht.

calendar.setWorkTime({ hours:["9:00-18:00"] });

• unsetWorkTime (config): void - hebt eine Arbeitszeit im Gantt-Diagramm auf
  • config - (object) - das Konfigurationsobjekt eines Zeitraums:
    • day? - (string | number) - optional, eine Zahl für einen Wochentag [0 (Sonntag) - 6 (Samstag)]. Hinweis: Sie können nur 1 Tag auf einmal festlegen
    • date? - (Date) - optional, ein bestimmtes Datum, das als Arbeitstag oder freier Tag festgelegt werden soll
    • hours? - (string[] | number[] | boolean) - optional, ein Array von Arbeitsstunden als 'von'-'bis'-Paare. Der Wert 'false' legt einen freien Tag fest, 'true' (Standardwert) wendet die Standardstunden (["8:00-17:00"]) an

calendar.unsetWorkTime({ hours:["9:00-18:00"] });

• isWorkTime (config, time_unit): boolean - überprüft, ob das angegebene Datum ein Arbeitstag ist
  • config - (Date | object) - entweder ein Datum zur Überprüfung oder das Konfigurationsobjekt eines Zeitraums:
    • date - (Date) - ein Datum zur Überprüfung
    • unit? - (string) - optional, eine Zeiteinheit: "minute", "hour", "day", "week", "month", "year"
    • task? - (Task) - optional, das Objekt der Aufgabe, deren Dauer berechnet werden soll
  • time_unit? - (string) - optional, eine Zeiteinheit: "minute", "hour", "day", "week", "month", "year". Nicht erforderlich, wenn der erste Parameter als Objekt angegeben ist
    
    

var calendar = gantt.getTaskCalendar(task);
if (calendar.isWorkTime({date: date})){
    alert("Arbeitszeit der Aufgabe" + task.text);
}

• getClosestWorkTime (config): Date - gibt die nächstgelegene Arbeitszeit zurück
  • config - (Date | object) - das Konfigurationsobjekt:
    • date - (Date) - ein Datum, für das die nächstgelegene Arbeitszeit ermittelt werden soll
    • dir? - (string) - optional, gibt die Richtung der nächsten Zeit an: "future" oder "past"
    • unit? - (string) - optional, eine Zeiteinheit zur Suche nach der nächstgelegenen Arbeitszeit
    • task? - (Task) - optional, das Objekt der Aufgabe, dessen Kalender verwendet werden soll

calendar.getClosestWorkTime({
    date:new Date(2013,0,1), 
    dir:"future", 
    unit:"hour"
});

• calculateEndDate (config, duration, unit): Date - berechnet das Enddatum einer Aufgabe
  • config - (Date | object) - entweder das Datum, an dem eine Aufgabe geplant ist zu beginnen, oder das Konfigurationsobjekt eines Zeitraums:
    • start_date - (Date) - das Datum, an dem eine Aufgabe geplant ist zu beginnen
    • duration - (number) - die Dauer einer Aufgabe
    • unit? - (string) - optional, die Zeiteinheit der Dauer: "minute", "hour", "day", "week", "month", "year"
    • task? - (Task) - optional, das Objekt der Aufgabe, deren Dauer berechnet werden soll
  • duration? - (number) - optional, die Dauer einer Aufgabe. Nicht erforderlich, wenn der erste Parameter als Objekt angegeben ist
  • unit? - (string) - optional, die Zeiteinheit der Dauer. Nicht erforderlich, wenn der erste Parameter als Objekt angegeben ist
    

var end_date = calendar.calculateEndDate({start_date:date, duration:duration});

• calculateDuration (config, end): number - berechnet die Dauer einer Aufgabe
  • config - (Date | object) - entweder das Datum, an dem eine Aufgabe geplant ist zu beginnen, oder das Konfigurationsobjekt eines Zeitraums:
    • start_date - (Date) - das Datum, an dem eine Aufgabe geplant ist zu beginnen
    • end_date - (Date) - das Datum, an dem eine Aufgabe geplant ist abzuschließen
    • task? - (Task) - optional, das Objekt der Aufgabe, deren Dauer berechnet werden soll
  • end? - (Date) - das Datum, an dem eine Aufgabe geplant ist abzuschließen. Nicht erforderlich, wenn der erste Parameter als Objekt angegeben ist
    

calendar.calculateDuration(new Date(2013,02,15), new Date(2013,02,25));

Eigenschaften

• id - (string | number) - die ID des Kalenders einer Aufgabe

Zurück nach oben