date

eine Sammlung von Datumsformatierungs-Utilities

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 Datumsformat-Spezifikation)
  • 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 Datumsformat-Spezifikation)

  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 Datumsformat-Spezifikation)
  • 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));

Zurück nach oben