Zum Hauptinhalt springen

date

Description​

Eine Sammlung von Datumsformatierungs-Utilities

date: DateHelpers

Example​

Details​

Das date-Objekt bietet eine Vielzahl von Methoden zur Arbeit mit Datumswerten:

  • add (date, number, unit): Date - passt das übergebene Datum an, indem eine bestimmte Zeitspanne hinzugefügt oder subtrahiert wird

    • date - (Date) das zu ändernde Datum
    • number - (number) die Anzahl der Einheiten, die hinzugefügt (positiv) oder subtrahiert (negativ) werden sollen
    • unit - (string) die Zeiteinheit: 'minute', 'hour', 'day', 'week', 'month', 'year'. 
      • //fügt dem angegebenen Datum 1 Jahr hinzu: 29. Juni 2019 -> 29. Juni 2020
      var newDate = gantt.date.add(new Date(2019, 05, 29), 1, 'year');

  • add_quarter (date, number): Date - addiert oder subtrahiert eine Anzahl von Quartalen (jeweils 3 Monate) zu/von einem Datum

    • date - (Date) das anzupassende Datum
    • number - (number) Anzahl der hinzuzufügenden (positiv) oder abzuziehenden (negativ) Quartale 
      • //fügt dem angegebenen Datum 1 Quartal (3 Monate) hinzu: 
      //29. Juni 2019 -> 29. September 2019
      var newDate = gantt.date.add_quarter(new Date(2019, 05, 29), 1);

  • convert_to_utc (date): Date - wandelt lokale Zeit in UTC-Zeit um

    • date - (Date) das zu konvertierende Datum 
      • //29. Juni 2019 14:00 (lokale Zeit) -> 29. Juni 2019 12:00 (UTC)
      var time = gantt.date.convert_to_utc(new Date(2019, 05, 29, 14, 00));

  • copy (date): Date - erstellt eine Kopie eines Date-Objekts

    • date - (Date) das zu kopierende Datum 
      • var copy = gantt.date.copy(new Date(2019, 05, 29));// -> 29. Juni 2019

  • date_part (date): Date - setzt den Zeitanteil des Datums auf Mitternacht (00:00:00) zurück

    • date - (Date) das anzupassende Datum 
      • //29. Juni 2019 14:30:10 -> 29. Juni 2019 00:00:00
      var date = gantt.date.date_part(new Date(2019, 05, 29, 14, 30, 10));

  • date_to_str (format, utc): Function - erzeugt eine Funktion, die ein Date-Objekt in einen formatierten String umwandelt

    • format - (string) das gewünschte Datumsformat (siehe Date Format Specification)
    • utc? - (boolean) ob lokale Zeit in UTC umgewandelt werden soll 
      • var formatFunc = gantt.date.date_to_str("%d/%m/%Y");
      var date = formatFunc(new Date(2019, 05, 29)); // -> "29/06/2019"

  • day_start (date): Date - setzt die Zeit des Datums auf Mitternacht, identisch zu date_part. Wird in der Tagesansicht verwendet, um das angezeigte Datum zu bestimmen, und kann angepasst werden

    • date - (Date) das anzupassende Datum 
      • //29. Juni 2019 14:30:10 -> 29. Juni 2019 00:00:00
      var date = gantt.date.day_start(new Date(2019, 05, 29, 14, 30, 10));

  • getISOWeek (date): number - gibt die ISO-8601-Wochennummer für das Datum zurück, wobei die Woche am Montag beginnt

    • date - (Date) das zu bewertende Datum 
      • var week = gantt.date.getISOWeek(new Date(2019, 05, 29));// ->26

  • getUTCISOWeek (date): number - gibt die Wochennummer des Datums zurück, nachdem lokale Zeit in UTC umgewandelt wurde

    • date - (Date) das zu bewertende Datum 
      • var week = gantt.date.getUTCISOWeek(new Date(2019, 05, 29));// ->26

  • getWeek (date): number - gibt die Wochennummer des Datums zurück, wobei die Woche je nach Konfiguration in start_on_monday entweder am Montag oder Sonntag beginnt

    • date - (Date) das zu bewertende Datum 
      • // Wochen beginnen am Sonntag
      gantt.config.start_on_monday = false;

      var isoWeek = gantt.date.getISOWeek(new Date(2019, 2, 25)); // ->12
      var week = gantt.date.getWeek(new Date(2019, 2, 25)); // ->13

  • month_start (date): Date - gibt ein Date-Objekt zurück, das auf den ersten Tag des Monats des angegebenen Datums gesetzt ist, mit Zeit auf Mitternacht zurückgesetzt

    • date - (Date) das anzupassende Datum 
      • //29. Juni 2019 14:30 -> 01. Juni 2019 00:00
      var firstDay = gantt.date.month_start(new Date(2019, 05, 29, 14, 30));

  • parseDate (date, format): Date - wandelt einen String, der im angegebenen Format vorliegt, in ein Date-Objekt um

    • date - (string) der Datumsstring
    • format - (string) das Format des Datumsstrings (siehe Date Format Specification) 
      • var date = gantt.date.parseDate("29/06/2019","%d/%m/%Y");//-> 29. Juni 2019 00:00:00

  • str_to_date (format, utc): Function - erzeugt eine Funktion, die Strings eines bestimmten Formats in Date-Objekte umwandelt

    • format - (string) das erwartete Datumsformat (siehe Date Format Specification)
    • utc? - (boolean) ob lokale Zeit in UTC umgewandelt werden soll 
      • var formatFunc = gantt.date.str_to_date("%d/%m/%Y");
      var date = formatFunc("29/06/2019"); // -> 29. Juni 2019 00:00:00

  • time_part (date): number - gibt den Zeitanteil eines Date-Objekts als Anzahl der Sekunden seit Mitternacht zurück

    • date - (Date) das zu bewertende Datum 
      • var time = gantt.date.time_part(new Date(2019, 05, 29, 14, 30, 10));

  • to_fixed (num): string - formatiert Zahlen kleiner als 10 mit führender Null, Zahlen ab 10 werden unverändert als Strings zurückgegeben

    • num - (number) die zu formatierende Zahl 
      • var num1 = gantt.date.to_fixed(2);// ->"02"
      var num2 = gantt.date.to_fixed(10);// ->10

  • minute_start (date): Date - gibt das Datum mit Sekunden auf Null zurück, wobei Jahr, Monat, Tag, Stunde und Minute erhalten bleiben

    • date - (Date) das anzupassende Datum 
      • //29. Juni 2019 14:30:10 -> 29. Juni 2019 14:30:00
      var date = gantt.date.minute_start(new Date(2019, 05, 29, 14, 30, 10));

  • hour_start (date): Date - gibt das Datum mit Minuten und Sekunden auf Null zurück, wobei Jahr, Monat, Tag und Stunde erhalten bleiben

    • date - (Date) das anzupassende Datum 
      • //29. Juni 2019 14:30:10 -> 29. Juni 2019 14:00:00
      var date = gantt.date.hour_start(new Date(2019, 05, 29, 14, 30, 10));

  • week_start (date): Date - gibt den ersten Tag der Woche für das angegebene Datum zurück, die Zeit wird auf Mitternacht zurückgesetzt

    • date - (Date) das anzupassende Datum 
      • //29. Juni 2019 14:30 -> 24. Juni 2019 00:00
      var weekStart = gantt.date.week_start(new Date(2019, 05, 29, 14, 30));

  • quarter_start (date): Date - gibt den ersten Monat des Quartals für das Datum zurück, die Zeit wird auf Mitternacht zurückgesetzt

    • date - (Date) das anzupassende Datum 
      • //29. Juni 2019 14:30:10 -> 01. April 2019 00:00:00
      var date = gantt.date.quarter_start(new Date(2019, 05, 29, 14, 30, 10));

  • year_start (date): Date - gibt den ersten Tag des Jahres für das angegebene Datum zurück, die Zeit wird auf Mitternacht gesetzt

    • date - (Date) das anzupassende Datum 
      • //29. Juni 2019 14:30 -> 01. Januar 2019 00:00
      var yearStart = gantt.date.year_start(new Date(2019, 05, 29, 14, 30));