Open Source Dokumentenmanagement
Dokumentation
Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht
Navigation: Dokumentationen agorum core > agorum core JavaScript-API
JavaScript-Bibliothek common/time
Mithilfe dieser JavaScript-Bibliothek ändern Sie Datumsobjekte. Diese Bibliothek folgt dem Fluent-API-Konzept, bei dem das System immer den aktuellen Zustand als Objekt zurückgibt, um mehrere Aufrufe zu kombinieren.
Verwendung
Sie benötigen die folgende Bibliothek, um diese JavaScript-Bibliothek verwenden zu können. Die Bibliothek geben Sie am Anfang des Skripts an.
let time = require('common/time');
Konstruktoren (Factory Pattern)
Die Konstruktoren verwenden Sie, um ein Time-Object zu erhalten, das Sie mit den hier aufgeführten Funktionen auslesen und verarbeiten können. Initial ist als Zeitzone die Standard-Zeitzone des agorum core-Servers hinterlegt.
time.now
Liefert die aktuelle Uhrzeit zurück.
Syntax
let fieldValue = time.now();
Parameter
Zu diesem Konstruktor existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung des Konstruktors.
let time = require('common/time');
let t1 = time.now();
t1;
Rückgabewerte
Verwendung
Diesen Konstruktor verwenden Sie, wenn Sie die aktuelle Uhrzeit benötigen.
Exceptions
Zu diesem Konstruktor existieren keine Exceptions.
time.fromEpoch
Liefert eine angegebene Epoche zurück.
Syntax
let fieldValue = time.fromEpoch(milliseconds);
Parameter
Diese Parameter existieren im Konstruktor:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| milliseconds | Definiert die Epoche-Millisekunden. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung des Konstruktors.
let time = require('common/time');
let t2 = time.fromEpoch(0); // Liefert 01.01.1970 00:00:00.000 zurück
t2;
Rückgabewerte
Sie erhalten die angegebene Epoche und die dazugehörige Time-Instanz zurück:
01.01.1970 00:00:00.000
Verwendung
Diesen Konstruktor verwenden Sie, wenn Sie die angegebene Epoche benötigen.
Exceptions
Zu diesem Konstruktor existieren keine Exceptions.
time.fromDateObject
Liefert ein angegebenes Time-Object zurück.
Syntax
let fieldValue = time.fromDateObject(fieldValue);
Parameter
Diese Parameter existieren im Konstruktor:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| fieldValue | Definiert die Variable, deren Datum das System ausliest. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung des Konstruktors.
let time = require('common/time');
let date = new Date(2022, 02, 11);
let t1 = time.fromDateObject(date); // 11.03.2022 00:00:00.000 Server-Zeit
Rückgabewerte
Verwendung
Diesen Konstruktor verwenden Sie, wenn Sie ein angegebenes Time-Object benötigen.
Exceptions
Zu diesem Konstruktor existieren keine Exceptions.
Funktionen
Mit den folgenden Funktionen können Sie die oben aufgeführten Konstruktoren weiter verarbeiten und bearbeiten.
Beispiel
let time = require('common/time');
time.fromEpoch(40271111).addYears(52).getDateObject();
Hinweis: Die hier aufgeführten Funktionen sind kaskadierend und können hintereinander angereiht werden.
Rückgabewert
2022-01-01T11:11:11.111Z
addYears
Addiert Jahre zu einem Datum hinzu.
Syntax
time.fromEpoch(milliseconds).addYears(years);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| years | Definiert die Anzahl an Jahren, die das System hinzuaddiert. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111).addYears(52); //Addiert 52 Jahre zum Datum 01.01.1970 11:11:11.111 [UTC]
Rückgabewerte
Sie erhalten das addierte Datum zurück.
{
"_utcTime": "2022-01-01T11:11:11.111Z[UTC]",
"_firstDayOfWeek": "MONDAY",
"_pattern": "yyyy-MM-dd['T'HH[:mm[:ss[.SSS]]]][X]['['z']']",
"_targetZone": "Europe/Berlin"
}
Verwendung
Diese Funktion verwenden Sie, wenn Sie zu einem Datum Jahre hinzuaddieren möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
addMonths
Addiert Monate zu einem Datum hinzu.
Syntax
time.fromEpoch(milliseconds).addMonths(months);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| months | Definiert die Anzahl an Monaten, die das System hinzuaddiert. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111).addMonths(42); //Addiert 42 Monate zum Datum 01.01.1970 11:11:11.111 [UTC]
Rückgabewerte
Sie erhalten das addierte Datum zurück.
1973-07-01T11:11:11.111Z[UTC]
Verwendung
Diese Funktion verwenden Sie, wenn Sie zu einem Datum Monate hinzuaddieren möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
addWeeks
Addiert Wochen zu einem Datum hinzu.
Syntax
time.fromEpoch(milliseconds).addWeeks(weeks);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| weeks | Definiert die Anzahl an Wochen, die das System hinzuaddiert. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111).addWeeks(4); //Addiert 4 Wochen zum Datum 01.01.1970 11:11:11.111 [UTC]
Rückgabewerte
Sie erhalten das addierte Datum zurück.
1970-01-29T11:11:11.111Z[UTC]
Verwendung
Diese Funktion verwenden Sie, wenn Sie zu einem Datum Wochen hinzuaddieren möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
addDays
Addiert Tage zu einem Datum hinzu.
Syntax
time.fromEpoch(milliseconds).addDays(days);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| days | Definiert die Anzahl an Tagen, die das System hinzuaddiert. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111).addDays(42); //Addiert 42 Tage zum Datum 01.01.1970 11:11:11.111 [UTC]
Rückgabewerte
Sie erhalten das addierte Datum zurück.
1970-02-12T11:11:11.111Z[UTC]
Verwendung
Diese Funktion verwenden Sie, wenn Sie zu einem Datum Tage hinzuaddieren möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
addHours
Addiert Stunden zu einem Datum hinzu.
Syntax
time.fromEpoch(milliseconds).addHours(hours);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| hours | Definiert die Anzahl an Stunden, die das System hinzuaddiert. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111).addHours(4); //Addiert 4 Stunden zum Datum 01.01.1970 11:11:11.111 [UTC]
Rückgabewerte
Sie erhalten das addierte Datum zurück.
1970-01-01T15:11:11.111Z[UTC]
Verwendung
Diese Funktion verwenden Sie, wenn Sie zu einem Datum Stunden hinzuaddieren möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
addMinutes
Addiert Minuten zu einem Datum hinzu.
Syntax
time.fromEpoch(milliseconds).addMinutes(minutes);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| minutes | Definiert die Anzahl an Minuten, die das System hinzuaddiert. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111).addMinutes(120); //Addiert 120 Minuten zum Datum 01.01.1970 11:11:11.111 [UTC]
Rückgabewerte
Sie erhalten das addierte Datum zurück.
1970-01-01T13:11:11.111Z[UTC]
Verwendung
Diese Funktion verwenden Sie, wenn Sie zu einem Datum Minuten hinzuaddieren möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
addSeconds
Addiert Sekunden zu einem Datum hinzu.
Syntax
time.fromEpoch(milliseconds).addSeconds(seconds);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| seconds | Definiert die Anzahl an Sekunden, die das System hinzuaddiert. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111).addSeconds(120); //Addiert 120 Sekunden zum Datum 01.01.1970 11:11:11.111 [UTC]
Rückgabewerte
Sie erhalten das addierte Datum zurück.
1970-01-01T11:13:11.111Z[UTC]
Verwendung
Diese Funktion verwenden Sie, wenn Sie zu einem Datum Sekunden hinzuaddieren möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
addMillis
Addiert Millisekunden zu einem Datum hinzu.
Syntax
time.fromEpoch(milliseconds).addMillis(milliseconds);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| milliseconds | Definiert die Anzahl an Sekunden, die das System hinzuaddiert. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111).addMillis(3293); //Addiert 3293 Millisekunden zum Datum 01.01.1970 11:11:11.111 [UTC]
Rückgabewerte
Sie erhalten das addierte Datum zurück.
1970-01-01T11:11:14.404Z[UTC]
Verwendung
Diese Funktion verwenden Sie, wenn Sie zu einem Datum Millisekunden hinzuaddieren möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getPattern
Liefert ein Pattern zurück. Das Pattern müssen Sie zuvor mit der Funktion setPattern gesetzt haben.
Syntax
fieldValue.getPattern();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Setzt das Pattern auf das deutsche Format und liest das Pattern aus
let t1 = time.now().setPattern('dd.MM.yyyy HH:mm:ss');
t1.getPattern();
Rückgabewerte
Sie erhalten das gesetzte Pattern zurück.
dd.MM.yyyy HH:mm:ss
Verwendung
Diese Funktion verwenden Sie, wenn Sie ein Pattern benötigen, das Sie zuvor mit der Funktion setPattern gesetzt haben.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getZoneId
Liefert eine Zeitzone zurück. Die Zeitzone müssen Sie zuvor mit der Funktion setZoneById gesetzt haben.
Ermöglicht eine automatische Umwandlung von MEZ <-> MESZ.
Syntax
fieldValue.getZoneId();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Zeitzone setzen und lesen
let t1 = time.now().setZoneById('Europe/Berlin');
t1.getZoneId();
Rückgabewerte
Sie erhalten die gesetzte ZoneId zurück.
Europe/Berlin
Verwendung
Diese Funktion verwenden Sie, wenn Sie eine Zeitzone benötigen, die Sie zuvor mit der Funktion setZoneById gesetzt haben.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getZoneOffsetId
Liefert eine Zeitzone anhand der Offset-ID zurück. Die Zeitzone müssen Sie zuvor mit der Funktion setZoneByOffsetId gesetzt haben.
Syntax
fieldValue.getZoneOffsetId();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Zeitzone anhand einer Offset-ID setzen und lesen
let t1 = time.now().setZoneByOffsetId('+0100');
t1.getZoneOffsetId();
Rückgabewerte
Sie erhalten die gesetzte ZoneOffsetId zurück.
+01:00
Verwendung
Diese Funktion verwenden Sie, wenn Sie die ZoneOffsetId benötigen, die Sie zuvor mit der Funktion setZoneByOffsetId gesetzt haben.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getZoneOffsetSeconds
Liefert die Offset-Sekunden der Zeitzone zurück. Die Offset-Sekunden müssen Sie zuvor mit der Funktion setZoneByOffsetSeconds gesetzt haben.
Es erfolgt keine automatische Umwandlung von MEZ <-> MESZ.
Syntax
fieldValue.getZoneOffsetSeconds();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Setzt die Zeitzone anhand von Offset-Sekunden und liest die Offset-Sekunden aus.
let t1 = time.now().setZoneByOffsetSeconds(3600);
t1.getZoneOffsetSeconds();
Rückgabewerte
Sie erhalten die gesetzten Offset-Sekunden zurück.
3600
Verwendung
Diese Funktion verwenden Sie, wenn Sie die Zeitzone anhand von Offset-Sekunden erhalten möchten, die Sie zuvor mit der Funktion setZoneByOffsetSeconds gesetzt haben.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getFirstDayOfWeek
Liefert den ersten Tag der Woche zurück. Den ersten Tag der Woche müssen Sie zuvor mit der Funktion setFirstDayOfWeek gesetzt haben.
Syntax
fieldValue.getFirstDayOfWeek();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
let t1 = time.now().setFirstDayOfWeek(time.SUNDAY); // Setzt den ersten Tag der Woche auf Sonntag
t1.getFirstDayOfWeek();
Rückgabewerte
Sie erhalten den gesetzten Wert zurück, der dem Wert von time.SUNDAY entspricht.
7
Verwendung
Diese Funktion verwenden Sie, wenn Sie den ersten Tag der Woche benötigen, den Sie zuvor mit der Funktion setFirstDayOfWeek gesetzt haben.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getEpoch
Liefert die Millisekunden einer Epoche zurück.
Syntax
time.fromEpoch(milliseconds).getEpoch();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111).getEpoch();
Rückgabewerte
Sie erhalten die Epochen-Millisekunden zurück:
40271111
Verwendung
Diese Funktion verwenden Sie, wenn Sie die Epochen-Millisekunden benötigen.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getDateObject
Liefert ein JavaScript Date-Objekt zurück. Das JavaScript Date-Objekt müssen Sie zuvor mit der Funktion setFromDateObject setzen.
Syntax
time.fromEpoch(milliseconds).getDateObject();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111).getDateObject();
Rückgabewerte
Sie erhalten ein JavaScript Date-Objekt zurück.
1970-01-01T11:11:11.111Z
Verwendung
Diese Funktion verwenden Sie, wenn Sie ein JavaScript Date-Objekt benötigen.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getYear
Liefert das Jahr für eine Epoche zurück.
Syntax
time.fromEpoch(milliseconds).getYear();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111).getYear();
Rückgabewerte
Sie erhalten das Jahr für die Epoche zurück.
1970
Verwendung
Diese Funktion verwenden Sie, wenn Sie das Jahr für eine Epoche benötigen.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getMonth
Liefert den Monat für eine Epoche zurück.
Syntax
time.fromEpoch(milliseconds).getMonth();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111).getMonth();
Rückgabewerte
Sie erhalten den Monat für die Epoche zurück.
1
Verwendung
Diese Funktion verwenden Sie, wenn Sie den Monat für eine Epoche benötigen.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getDay
Liefert den Tag für eine Epoche zurück.
Syntax
time.fromEpoch(milliseconds).getDay();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111).getDay();
Rückgabewerte
Sie erhalten den Tag für die Epoche zurück.
1
Verwendung
Diese Funktion verwenden Sie, wenn Sie den Tag für eine Epoche benötigen.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getDayOfWeek
Liefert den Tag der Woche für eine Epoche zurück.
Syntax
time.fromEpoch(milliseconds).getDayOfWeek();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111).getDayOfWeek();
Rückgabewerte
Sie erhalten den Tag der Woche für die Epoche zurück, hier den Wert 4, der time.THURSDAY entspricht.
4
Verwendung
Diese Funktion verwenden Sie, wenn Sie den Tag der Woche für eine Epoche benötigen.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getDayOfYear
Liefert den Tag des Jahres für eine Epoche zurück.
Syntax
time.fromEpoch(milliseconds).getDayOfYear();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111).getDayOfYear();
Rückgabewerte
Sie erhalten den Tag des Jahres für die Epoche zurück.
1
Verwendung
Diese Funktion verwenden Sie, wenn Sie den Tag des Jahres für eine Epoche benötigen.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getHour
Liefert die Stunde für eine Epoche zurück.
Syntax
time.fromEpoch(milliseconds).getHour();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111).getHour();
Rückgabewerte
Sie erhalten die Stunde für die Epoche zurück.
1
Verwendung
Diese Funktion verwenden Sie, wenn Sie die Stunde für eine Epoche benötigen.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getMinute
Liefert die Minute für eine Epoche zurück.
Syntax
time.fromEpoch(milliseconds).getMinute();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111).getMinute();
Rückgabewerte
Sie erhalten die Minute für die Epoche zurück.
11
Verwendung
Diese Funktion verwenden Sie, wenn Sie die Minute für eine Epoche benötigen.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getSecond
Liefert die Sekunde für eine Epoche zurück.
Syntax
time.fromEpoch(milliseconds).getSecond();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111).getSecond();
Rückgabewerte
Sie erhalten die Sekunde für die Epoche zurück.
11
Verwendung
Diese Funktion verwenden Sie, wenn Sie die Sekunde für eine Epoche benötigen.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getMilli
Liefert die Millisekunde für eine Epoche zurück.
Syntax
time.fromEpoch(milliseconds).getMilli();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111).getMilli();
Rückgabewerte
Sie erhalten die Millisekunde für die Epoche zurück.
111
Verwendung
Diese Funktion verwenden Sie, wenn Sie die Millisekunde für eine Epoche benötigen.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getYearsTo
Liefert den Unterschied zwischen Epochen in Jahren zurück.
Syntax
fieldValue.getYearsTo(fieldValue);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| fieldValue | Definiert die Epoche, die das System vergleicht. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
let t1 = time.fromEpoch(40271111); // 1970-01-01T11:11:11.111Z
let t2 = t1.clone().addYears(2).addMonths(2).addDays(2);
t1.getYearsTo(t2); // Liefert den Unterschied in Jahren zurück: 2
t2.getYearsTo(t1); // Liefert den Unterschied in negativen Jahren zurück: -2
Rückgabewerte
Sie erhalten den Unterschied zwischen Epochen in Jahren zurück:
2
Verwendung
Diese Funktion verwenden Sie, wenn Sie den Unterschied zwischen Epochen in Jahren benötigen.
getMonthsTo
Liefert den Unterschied zwischen Epochen in Monaten zurück.
Syntax
fieldValue.getMonthsTo(fieldValue);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| fieldValue | Definiert die Epoche, die das System vergleicht. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
let t1 = time.fromEpoch(40271111); // 1970-01-01T11:11:11.111Z
let t2 = t1.clone().addYears(2).addMonths(2).addDays(2);
t1.getMonthsTo(t2); // Liefert den Unterschied in Monaten zurück: 26
t2.getMonthsTo(t1); // Liefert den Unterschied in negativen Monaten zurück: -26
Rückgabewerte
Sie erhalten den Unterschied zwischen Epochen in Monaten zurück:
26
Verwendung
Diese Funktion verwenden Sie, wenn Sie den Unterschied zwischen Epochen in Monaten benötigen.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getWeeksTo
Liefert den Unterschied zwischen Epochen in Wochen zurück.
Syntax
fieldValue.getWeeksTo(fieldValue);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| fieldValue | Definiert die Epoche, die das System vergleicht. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
let t1 = time.fromEpoch(40271111); // 1970-01-01T11:11:11.111Z
let t2 = t1.clone().addYears(2).addMonths(2).addDays(2);
t1.getYearsTo(t2); // Liefert den Unterschied in Wochen zurück: 113
t2.getYearsTo(t1); // Liefert den Unterschied in negativen Wochen zurück: -113
Rückgabewerte
Sie erhalten den Unterschied zwischen Epochen in Wochen zurück:
113
Verwendung
Diese Funktion verwenden Sie, wenn Sie den Unterschied zwischen Epochen in Wochen benötigen.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getDaysTo
Liefert den Unterschied zwischen Epochen in Tagen zurück.
Syntax
fieldValue.getDaysTo(fieldValue);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| fieldValue | Definiert die Epoche, die das System vergleicht. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
let t1 = time.fromEpoch(40271111); // 1970-01-01T11:11:11.111Z
let t2 = t1.clone().addYears(2).addMonths(2).addDays(2);
t1.getDaysTo(t2); // Liefert den Unterschied in Tagen zurück: 792
t2.getDaysTo(t1); // Liefert den Unterschied in negativen Tagen zurück: -792
Rückgabewerte
Sie erhalten den Unterschied zwischen Epochen in Tagen zurück:
792
Verwendung
Diese Funktion verwenden Sie, wenn Sie den Unterschied zwischen Epochen in Tagen benötigen.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getHoursTo
Liefert den Unterschied zwischen Epochen in Stunden zurück.
Syntax
fieldValue.getHoursTo(fieldValue);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| fieldValue | Definiert die Epoche, die das System vergleicht. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
let t1 = time.fromEpoch(40271111); // 1970-01-01T11:11:11.111Z
let t2 = t1.clone().addYears(2).addMonths(2).addDays(2);
t1.getHoursTo(t2); // Liefert den Unterschied in Stunden zurück: 1908
t2.getHoursTo(t1); // Liefert den Unterschied in negativen Stunden zurück: -1908
Rückgabewerte
Sie erhalten den Unterschied zwischen Epochen in Stunden zurück:
1908
Verwendung
Diese Funktion verwenden Sie, wenn Sie den Unterschied zwischen Epochen in Stunden benötigen.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getMinutesTo
Liefert den Unterschied zwischen Epochen in Minuten zurück.
Syntax
fieldValue.getMinutesTo(fieldValue);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| fieldValue | Definiert die Epoche, die das System vergleicht. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
let t1 = time.fromEpoch(40271111); // 1970-01-01T11:11:11.111Z
let t2 = t1.clone().addYears(2).addMonths(2).addDays(2);
t1.getMinutesTo(t2); // Liefert den Unterschied in Minuten zurück: 1140480
t2.getMinutesTo(t1); // Liefert den Unterschied in negativen Minuten zurück: -1140480
Rückgabewerte
Sie erhalten den Unterschied zwischen Epochen in Minuten zurück:
1140480
Verwendung
Diese Funktion verwenden Sie, wenn Sie den Unterschied zwischen Epochen in Minuten benötigen.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getSecondsTo
Liefert den Unterschied zwischen Epochen in Sekunden zurück.
Syntax
fieldValue.getSecondsTo(fieldValue);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| fieldValue | Definiert die Epoche, die das System vergleicht. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
let t1 = time.fromEpoch(40271111); // 1970-01-01T11:11:11.111Z
let t2 = t1.clone().addYears(2).addMonths(2).addDays(2);
t1.getSecondsTo(t2); // Liefert den Unterschied in Sekunden zurück: 68428800
t2.getSecondsTo(t1); // Liefert den Unterschied in negativen Sekunden zurück: -68428800
Rückgabewerte
Sie erhalten den Unterschied zwischen Epochen in Sekunden zurück:
68428800
Verwendung
Diese Funktion verwenden Sie, wenn Sie den Unterschied zwischen Epochen in Sekunden benötigen.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getMillisTo
Liefert den Unterschied zwischen Epochen in Millisekunden zurück.
Syntax
fieldValue.getMillisTo(fieldValue);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| fieldValue | Definiert die Epoche, die das System vergleicht. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
let t1 = time.fromEpoch(40271111); // 1970-01-01T11:11:11.111Z
let t2 = t1.clone().addYears(2).addMonths(2).addDays(2);
t1.getMillisTo(t2); // Liefert den Unterschied in Millisekunden zurück: 68428800000
t2.getMillisTo(t1); // Liefert den Unterschied in negativen Millisekunden zurück: -68428800000
Rückgabewerte
Sie erhalten den Unterschied zwischen Epochen in Millisekunden zurück:
68428800000
Verwendung
Diese Funktion verwenden Sie, wenn Sie den Unterschied zwischen Epochen in Millisekunden benötigen.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
getIsoWeekNumber
Liefert die ISO-Kalenderwoche des Jahres zurück.
Syntax
time.now().setTime(year, month, day).getIsoWeekNumber()
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| year | Definiert das Jahr. | ja | – | Beispiel |
| month | Definiert den Monat. | ja | – | |
| day | Definiert den Tag. | ja | – |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.now().setTime(1970, 2, 14).getIsoWeekNumber();
Rückgabewerte
Sie erhalten die ISO-Kalenderwoche des Jahres zurück.
7
Verwendung
Diese Funktion verwenden Sie, wenn Sie die ISO-Kalenderwoche eines Jahres benötigen.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setPattern
Setzt ein Pattern. Das gesetzte Pattern können Sie anschließend mit der Funktion getPattern auslesen.
Syntax
let fieldValue = time.now().setPattern('dateFormat');
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| dateFormat | Definiert das Datumsformat. | ja | – | Beispiele |
Diese Beispiele zeigen die Anwendung der Funktion.
Pattern auf deutsches Format setzen:
let time = require('common/time');
// Setzt das Pattern auf das deutsche Format
let t1 = time.now().setPattern('dd.MM.yyyy HH:mm:ss');
Pattern auf Standard zurücksetzen (ISO-Zeitzonen-Datums-Format)
let time = require('common/time');
// Setzt das Pattern auf Standard zurück (ISO-Zeitzonen-Datums-Format)
let t1 = time.now().setPattern(time.DEFAULT_PATTERN);
Rückgabewerte
Verwendung
Diese Funktion verwenden Sie, wenn Sie ein Pattern setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setFirstDayOfWeek
Setzt den ersten Tag der Woche auf einen bestimmten Tag. Den gesetzten Tag können Sie anschließend mit der Funktion getFirstDayOfWeek auslesen.
Syntax
let fieldValue = time.now().setFirstDayOfWeek(time.DAY);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| time.DAY | Definiert den Tag, den das System als ersten Tag der Woche setzt. Verwenden Sie als Tage die Konstanten. |
ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Setzt den ersten Tag der Woche auf Sonntag
let t1 = time.now().setFirstDayOfWeek(time.SUNDAY);
Rückgabewerte
Verwendung
Diese Funktion verwenden Sie, wenn Sie den ersten Tag der Woche setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setZoneByOffsetId
Setzt eine Zeitzone anhand einer Offset-ID. Die gesetzte Offset-ID der Zeitzone können Sie anschließend mit der Funktion getZoneOffsetId auslesen.
Es erfolgt keine automatische Umwandlung von MEZ <-> MESZ.
Syntax
let fieldValue = time.now().setZoneByOffsetId('offset');
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| offset | Definiert den Offset für die Zeitzone. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
let t1 = time.now().setZoneByOffsetId('+0100');
Rückgabewerte
Verwendung
Diese Funktion verwenden Sie, wenn Sie die Zeitzone anhand einer Offset-ID setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setZoneById
Setzt eine Zeitzone anhand einer ID. Alle möglichen Zeitzonen können Sie mit der Konstanten time.ZONE_IDS; abfragen.
Ermöglicht eine automatische Umwandlung von MEZ <-> MESZ.
Syntax
time.now().setZoneById('ID');
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| ID | Definiert die Zeitzone als ID. Zeitzonen fragen Sie mit der Konstanten time.ZONE_IDS; ab. |
ja | . | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
let t1 = time.now().setZoneById('Europe/Berlin');
Rückgabewerte
Sie erhalten die aktuelle Time-Instanz zurück.
Verwendung
Diese Funktion verwenden Sie, wenn Sie die Zeitzone anhand einer ID setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setZoneByOffsetSeconds
Setzt eine Zeitzone anhand von Offset-Sekunden. Es erfolgt keine automatische Umwandlung von MEZ <-> MESZ.
Syntax
let fieldValue = time.now().setZoneByOffsetSeconds(seconds);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| seconds | Definiert die Sekunden für den Offset der Zeitzone. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time ');
time.now().setZoneByOffsetSeconds(3600);
Rückgabewerte
Verwendung
Diese Funktion verwenden Sie, wenn Sie eine Zeitzone anhand von Offset-Sekunden setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setFromDateObject
Setzt das Datum anhand eines JavaScript-Date-Objekts. Das JavaScript-Date-Objekt können Sie anschließend mit der Funktion getDateObject auslesen.
Syntax
time.now().setFromDateObject(new Date(year, month, day));
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| year | Definiert das Jahr. | ja | – | Beispiel |
| month | Definiert den Monat. | ja | – | |
| day | Definiert den Tag. | ja | – |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.now().setFromDateObject(new Date(2022, 03, 11));
Rückgabewerte
Sie erhalten die aktuelle Time-Instanz zurück.
Verwendung
Diese Funktion verwenden Sie, wenn Sie das Datum anhand eines JavaScript-Date-Objekts setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setEpoch
Setzt das Datum auf die Epoche-Millisekunde.
Syntax
time.now().setEpoch(milliseconds);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| milliseconds | Definiert die Epoche-Millisekunden. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Setzt das Datum auf die entsprechende Epoche-Millisekunde: 01.01.1970 00:00:00.000
time.now().setEpoch(0);
Rückgabewerte
Sie erhalten die aktuelle Time-Instanz zurück.
Verwendung
Diese Funktion verwenden Sie, wenn Sie ein Datum auf die Epoche-Millisekunde setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setTime
Setzt ein Datum anhand der eingegebenen Parameter.
Syntax
time.now().setTime(year, month, day, hour, minute, second, millisecond);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| year | Definiert das Jahr. | ja | – | Beispiel |
| month | Definiert den Monat. | ja | – | |
| day | Definiert den Tag. | ja | – | |
| hour | Definiert die Stunde. | ja | – | |
| minute | Definiert die Minute. | ja | – | |
| second | Definiert die Sekunde. | ja | – | |
| millisecond | Definiert die Millisekunde. | ja | – |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Setzt das Datum anhand der eingegebenen Parameter, hier: 11.03.2022 20:15:30.404
time.now().setTime(2022, 03, 11, 20, 15, 30, 404);
Rückgabewerte
Verwendung
Diese Funktion verwenden Sie, wenn Sie ein Datum anhand der eingegebenen Parameter setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setYear
Setzt ein bestimmtes Jahr.
Syntax
time.fromEpoch(milliseconds).setYear(year);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| year | Definiert das Jahr, das das System setzt. | ja | – | Beispiel |
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Setzt das Jahr auf 1984 => 01.01.1984 11:11:11.111
time.fromEpoch(40271111).setYear(1984);
Rückgabewerte
Verwendung
Diese Funktion verwenden Sie, wenn Sie ein bestimmtes Jahr setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setMonth
Setzt einen bestimmten Monat.
Syntax
time.fromEpoch(milliseconds).setMonth(month);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| month | Definiert den Monat, den das System setzt. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Setzt den Monat auf 12 => 01.12.1970 11:11:11.111
time.fromEpoch(40271111).setMonth(12);
Rückgabewerte
Sie erhalten die aktuelle Time-Instanz zurück.
Verwendung
Diese Funktion verwenden Sie, wenn Sie einen bestimmten Monat setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setDay
Setzt einen bestimmten Tag.
Syntax
time.fromEpoch(milliseconds).setDay(day);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| day | Definiert den Tag, den das System setzt. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Setzt den Tag auf 24 => 24.01.1970 11:11:11.111
time.fromEpoch(40271111).setDay(24);
Rückgabewerte
Sie erhalten die aktuelle Time-Instanz zurück.
Verwendung
Diese Funktion verwenden Sie, wenn Sie einen bestimmten Tag setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setDayOfYear
Setzt das Datum auf einen bestimmten Tag eines Jahres.
Syntax
time.fromEpoch(milliseconds).setDayOfYear(day);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| day | Definiert den Tag des Jahres, den das System setzt. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Setzt das Datum auf den 48. Tag des Jahres => 17.02.1970 11:11:11.111
time.fromEpoch(40271111).setDayOfYear(48);
Rückgabewerte
Verwendung
Diese Funktion verwenden Sie, wenn Sie das Datum auf einen bestimmten Tag eines Jahres setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setWeekOfMonth
Setzt das Datum auf eine bestimmte Woche eines Monats.
Syntax
time.fromEpoch(40271111).setWeekOfMonth(week);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| week | Definiert die Woche eines Monats, die das System setzt. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Setzt das Datum auf den Wochenstart (hier Montag) der dritten Woche des aktuellen Monats (hier Januar) => 19.01.1970 11:11:11.111
time.fromEpoch(40271111).setWeekOfMonth(3);
Rückgabewerte
Sie erhalten die aktuelle Time-Instanz zurück.
Verwendung
Diese Funktion verwenden Sie, wenn Sie das Datum auf eine bestimmte Woche eines Monats setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setHour
Setzt eine bestimmte Stunde.
Syntax
time.fromEpoch(milliseconds).setHour(hour);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| hour | Definiert die Stunde, die das System setzt. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Setzt die Stunde auf 20 => 01.01.1970 20:11:11.111
time.fromEpoch(40271111).setHour(20);
Rückgabewerte
Sie erhalten die aktuelle Time-Instanz zurück.
Verwendung
Diese Funktion verwenden Sie, wenn Sie eine bestimmte Stunde setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setMinute
Setzt eine bestimmte Minute.
Syntax
time.fromEpoch(milliseconds).setMinute(minute);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| minute | Definiert die Minute, die das System setzt. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Setzt die Minute auf 15 => 01.01.1970 11:15:11.111
time.fromEpoch(40271111).setMinute(15);
Rückgabewerte
Sie erhalten die aktuelle Time-Instanz zurück.
Verwendung
Diese Funktion verwenden Sie, wenn Sie eine bestimmte Minute setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setSecond
Setzt eine bestimmte Sekunde.
Syntax
time.fromEpoch(milliseconds).setSecond(second);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| second | Definiert die Sekunde, die das System setzt. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Setzt die Sekunde auf 30 => 01.01.1970 11:11:30.111
time.fromEpoch(40271111).setSecond(30);
Rückgabewerte
Sie erhalten die aktuelle Time-Instanz zurück.
Verwendung
Diese Funktion verwenden Sie, wenn Sie eine bestimmte Sekunde setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setMilli
Setzt eine bestimmte Millisekunde.
Syntax
time.fromEpoch(milliseconds).setMilli(milliseconds);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| milliseconds | Definiert die Millisekunde, die das System setzt. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Setzt die Millisekunde auf 404 => 01.01.1970 11:11:11.404
time.fromEpoch(40271111).setMilli(404);
Rückgabewerte
Sie erhalten die aktuelle Time-Instanz zurück.
Verwendung
Diese Funktion verwenden Sie, wenn Sie eine bestimmte Millisekunde setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setNano
Setzt eine bestimmte Nanosekunde.
Syntax
time.fromEpoch(milliseconds).setNano(nanosecond);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| nanosecond | Definiert die Nanosekunde, die das System setzt. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Setzt die Nanosekunde auf 404 => 01.01.1970 11:11:11:.000000404
time.fromEpoch(40271111).setNano(404);
Rückgabewerte
Sie erhalten die aktuelle Time-Instanz zurück.
Verwendung
Diese Funktion verwenden Sie, wenn Sie eine bestimmte Nanosekunde setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setToMidnight
Setzt die Zeit auf Mitternacht.
Syntax
time.fromEpoch(milliseconds).setToMidnight();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Setzt die Zeit auf Mitternacht => 01.01.1970 00:00:00.000
time.fromEpoch(40271111).setToMidnight();
Rückgabewerte
Verwendung
Diese Funktion verwenden Sie, wenn Sie eine Zeit auf Mitternacht setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setToPrevious
Setzt das Datum auf einen vorhergehenden bestimmten Tag.
Syntax
time.fromEpoch(milliseconds).setToPrevious(time.DAY);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| time.DAY | Definiert den vorhergehenden Tag, auf den das System das Datum setzt. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Setzt das Datum auf den vorhergehenden Donnerstag => 25.12.1969 11:11:11.111
time.fromEpoch(40271111).setToPrevious(time.THURSDAY);
Rückgabewerte
Verwendung
Diese Funktion verwenden Sie, wenn Sie ein Datum auf einen vorgehenden bestimmten Tag setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setToPreviousOrSame
Setzt das Datum auf einen vorhergehenden bestimmten Tag und liefert den aktuellen Tag zurück, wenn dieser Tag der aktuelle Tag ist.
Syntax
time.fromEpoch(milliseconds).setToPreviousOrSame(time.DAY);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| time.DAY | Definiert den vorhergehenden Tag, auf den das System das Datum setzt. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Setzt das Datum auf den jüngsten Donnerstag; gibt den aktuellen Tag zurück, wenn es ein Donnerstag ist. => 01.01.1970 11:11:11.111
time.fromEpoch(40271111).setToPreviousOrSame(time.THURSDAY);
Rückgabewerte
Verwendung
Diese Funktion verwenden Sie, wenn Sie das Datum auf einen vorhergehenden bestimmten Tag setzen und den aktuellen Tag erhalten möchten, wenn dieser Tag der aktuelle Tag ist.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setToNext
Setzt das Datum auf einen nächsten bestimmten Tag.
Syntax
time.fromEpoch(milliseconds).setToNext(time.DAY);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| time.DAY | Definiert den nächsten Tag, auf den das System das Datum setzt. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Setzt das Datum auf den nächsten Donnerstag; gibt den aktuellen Tag zurück, wenn es ein Donnerstag ist. => 08.01.1970 11:11:11.111
time.fromEpoch(40271111).setToNext(time.THURSDAY);
Rückgabewerte
Verwendung
Diese Funktion verwenden Sie, wenn Sie das Datum auf einen nächsten bestimmten Tag setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setToNextOrSame
Setzt das Datum auf einen nächsten bestimmten Tag und liefert den aktuellen Tag zurück, wenn dieser Tag der aktuelle Tag ist.
Syntax
time.fromEpoch(milliseconds).setToNextOrSame(time.DAY);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| time.DAY | Definiert den nächsten Tag, auf den das System das Datum setzt. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Setzt das Datum auf den nächsten Donnerstag; gibt den aktuellen Tag zurück, wenn es ein Donnerstag ist. => 01.01.1970 11:11:11.111
time.fromEpoch(40271111).setToNextOrSame(time.THURSDAY);
Rückgabewerte
Verwendung
Diese Funktion verwenden Sie, wenn Sie ein Datum auf einen nächsten bestimmten Tag setzen oder den aktuellen Tag erhalten möchten, wenn dieser Tag der aktuelle Tag ist.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setToFirstDayOfWeek
Setzt das Datum auf den ersten Tag einer Woche.
- Den ersten Tag einer Woche können Sie mit der Funktion setFirstDayOfWeek setzen.
- Wenn Sie den ersten Tag der Woche nicht setzen, gilt automatisch Montag als erster Tag der Woche.
Syntax
time.fromEpoch(milliseconds).setToFirstDayOfWeek();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111)
.setFirstDayOfWeek(time.FRIDAY) // Setzt den ersten Tag der Woche auf Freitag
.setToFirstDayOfWeek(); // Setzt das Datum auf den ersten Tag der aktuellen Woche. 01.01.1970 = Donnerstag -> Letzter Tag der Woche. Das System setzt das Datum entsprechend auf den vorhergehenden Freitag: 26.12.1969 11:11:11.111
Rückgabewerte
Verwendung
Diese Funktion verwenden Sie, wenn Sie ein Datum auf den ersten Tag einer Woche setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setToLastDayOfWeek
Setzt das Datum auf den letzten Tag einer Woche.
Syntax
time.fromEpoch(milliseconds).setToLastDayOfWeek();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111)
.setFirstDayOfWeek(time.THURSDAY) // Setzt den ersten Tag der Woche auf Donnerstag
.setToLastDayOfWeek(); // Setzt das Datum auf den letzten Tag der aktuellen Woche. 01.01.1970 = Donnerstag -> Erster Tag der Woche. => Letzter Tag der Woche = Mittwoch. Das System setzt das Datum entsprechend auf den nachfolgenden Mittwoch: 07.01.1970 11:11:11.111
Rückgabewerte
Verwendung
Diese Funktion verwenden Sie, wenn Sie ein Datum auf den letzten Tag einer Woche setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setToFirstDayOfMonth
Setzt das Datum auf den ersten Tag eines Monats.
Syntax
time.fromEpoch(milliseconds).setToFirstDayOfMonth();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111)
.setMonth(2).setDay(14) // Setzt das Datum auf den 14.02.1970
.setToFirstDayOfMonth(); // Setzt das Datum auf den Monatsersten: 01.02.1970 11:11:11.111
Rückgabewerte
Verwendung
Diese Funktion verwenden Sie, wenn Sie ein Datum auf den ersten Tag eines Monats setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setToLastDayOfMonth
Setzt das Datum auf den letzten Tag eines Monats.
Syntax
time.fromEpoch(milliseconds).setToLastDayOfMonth();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111)
.setMonth(2).setDay(14) // Setzt das Datum auf den 14.02.1970
.setToLastDayOfMonth(); // Setzt das Datum auf den Monatsletzten: 28.02.1970 11:11:11.111
Rückgabewerte
Verwendung
Diese Funktion verwenden Sie, wenn Sie ein Datum auf den letzten Tag eines Monats setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setToFirstDayOfYear
Setzt das Datum auf den ersten Tag eines Jahres.
Syntax
time.fromEpoch(milliseconds).setToFirstDayOfYear();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111)
.setMonth(2).setDay(14) // Setzt das Datum auf den 14.02.1970
.setToFirstDayOfYear(); // Setzt das Datum auf den ersten Tag des entsprechenden Jahres: 01.01.1970 11:11:11.111
Rückgabewerte
Verwendung
Diese Funktion verwenden Sie, wenn Sie ein Datum auf den ersten Tag eines Jahres setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setToLastDayOfYear
Setzt das Datum auf den letzten Tag eines Jahres.
Syntax
time.fromEpoch(milliseconds).setToLastDayOfYear();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111)
.setMonth(2).setDay(14) // Setzt das Datum auf den 14.02.1970
.setToLastDayOfYear(); // Setzt das Datum auf den letzten Tag des entsprechenden Jahres: 31.12.1970 11:11:11.111
Rückgabewerte
Verwendung
Diese Funktion verwenden Sie, wenn Sie ein Datum auf den letzten Tag eines Jahres setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
setToIsoWeek
Setzt das Datum auf einen gleichen Wochentag einer Kalenderwoche eines Jahres.
Syntax
time.fromEpoch(milliseconds).setToIsoWeek(year, week);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| year | Definiert das Jahr. | ja | – | Beispiel |
| week | Definiert die Woche. | ja | – |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
// Setzt das Datum auf den gleichen Wochentag in KW 7 des Jahres 1970. Da der 01.01.1970 ein Donnerstag ist, setzt das System das Datum auf den Donnerstag von KW 7: 12.02.1970 00:00:00.000 [UTC]
time.fromEpoch((40271111)).setToIsoWeek(1970, 7);
Rückgabewerte
Sie erhalten die aktuelle Time-Instanz zurück.
Verwendung
Diese Funktion verwenden Sie, wenn Sie das Datum auf einen gleichen Wochentag einer Kalenderwoche eines Jahres setzen möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
clone
Kopiert den Zustand / das Datum eines Objekts.
Syntax
let fieldValue = fieldValue.clone();
Parameter
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
let t1 = time.now(); // Holt die aktuelle Uhrzeit und das Datum
let t2 = t1.clone(); // Kopiert den Zustand / das Datum von t1
t1.setToMidnight(); // Setzt t1 auf Mitternacht, t2 bleibt unberührt
Rückgabewerte
Verwendung
Diese Funktion verwenden Sie, wenn Sie den Zustand / das Datum eines Objekts kopieren möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
parse
Liest einen String ein und versucht, diesen in ein Datumsobjekt mit Uhrzeit umzuwandeln.
Syntax
let fieldValue = time.now().parse(fieldValue);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| fieldValue | Definiert die Variable, die das System parst. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
let date1 = '2022-12-24T18:30:00.000+0100[Europe/Berlin]';
let t1 = time.now().parse(date1); // Setzt nur die Uhrzeit
Rückgabewerte
Verwendung
Diese Funktion verwenden Sie, wenn Sie einen String in ein Datumsobjekt mit Uhrzeit umwandeln möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
parseZoned
Liest einen String ein und versucht, dieses in ein Datumsobjekt mit Uhrzeit und Zeitzone umzuwandeln.
Syntax
let fieldValue = time.now().parseZoned(fieldValue);
Parameter
Diese Parameter existieren in der Funktion:
| Parameter | Beschreibung | Pflicht | Standard | Weitere Informationen |
|---|---|---|---|---|
| fieldValue | Definiert die Variable, die das System parst. | ja | – | Beispiel |
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
let date2 = '2022-12-24T18:30:00[Japan]';
let t2 = time.now().parseZoned(date2); // Setzt Uhrzeit und Zeitzone
Rückgabewerte
Verwendung
Diese Funktion verwenden Sie, wenn Sie einen String in ein Datumsobjekt mit Uhrzeit und Zeitzone umwandeln möchten.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
toString:
Liefert ein Datum als String zurück.
Syntax
fieldValue.toString();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
let t1 = time.fromEpoch(40271111);
t1.setPattern('dd.MM.yyyy').toString();
Rückgabewerte
Sie erhalten das Datum im Format des angegebenen Patterns in der konfigurierten Zeitzone:
'01.01.1970'
Verwendung
Diese Funktion verwenden Sie, wenn Sie ein Datum als String benötigen.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
toISOString:
Liefert ein Datum als JavaScript verständlichen String in UTC zurück.
Syntax
fieldValue.toISOString();
Parameter
Zu dieser Funktion existieren keine Parameter.
Beispiel
Dieses Beispiel zeigt die Anwendung der Funktion.
let time = require('common/time');
time.fromEpoch(40271111).toISOString();
Rückgabewerte
Sie erhalten das Datum als ISO-String in der Zeitzone UTC:
'1970-01-01T11:11:11.111Z'
Verwendung
Diese Funktion verwenden Sie, wenn Sie ein Datum als ISO-String benötigen.
Exceptions
Zu dieser Funktion existieren keine Exceptions.
Konstanten
| Konstante | Beschreibung | Link |
|---|---|---|
| time.DEFAULT_PATTERN; | Setzt das Standard-Pattern für das ISO-Zeitzonen-Datums-Format zurück. | Pattern auf Standard zurücksetzen (ISO-Zeitzonen-Datums-Format |
| time.ZONE_IDS; | Listet alle möglichen Zeitzonen auf. Die Bezeichnungen benötigen Sie für die Funktion setZoneById. | – |
| time.MONDAY; | Repräsentiert den Wochentag Montag mit Wert =1. | Die Wochentage benötigen Sie für die Funktionen: |
| time.TUESDAY; | Repräsentiert den Wochentag Dienstag mit Wert =2. | |
| time.WEDNESDAY; | Repräsentiert den Wochentag Mittwoch mit Wert =3. | |
| time.THURSDAY; | Repräsentiert den Wochentag Donnerstag mit Wert =4. | |
| time.FRIDAY; | Repräsentiert den Wochentag Freitag mit Wert =5. | |
| time.SATURDAY; | Repräsentiert den Wochentag Samstag mit Wert =6. | |
| time.SUNDAY; | Repräsentiert den Wochentag Sonntag mit Wert =7. |
Anwendungsbeispiele
Wert eines Datum-Metadatums verarbeiten
let time = require('common/time');
let today = new Date();
time.fromEpoch(today).addYears(52).getDateObject();