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

Sie erhalten die aktuelle Time-Instanz zurück.

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

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

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

Sie erhalten das Time-Object zurück.

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

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

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

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

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

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

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

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

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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

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:

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

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:

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

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:

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

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:

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

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:

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

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:

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

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

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	–

Beispiel

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.

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

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

Sie erhalten die aktuelle Time-Instanz zurück.

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

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

Sie erhalten die aktuelle Time-Instanz zurück.

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

Beispiel

Dieses Beispiel zeigt die Anwendung der Funktion.

let time = require('common/time');

let t1 = time.now().setZoneByOffsetId('+0100');

Rückgabewerte

Sie erhalten die aktuelle Time-Instanz zurück.

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

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

Beispiel

Dieses Beispiel zeigt die Anwendung der Funktion.

let time = require('common/time ');

time.now().setZoneByOffsetSeconds(3600);

Rückgabewerte

Sie erhalten die aktuelle Time-Instanz zurück.

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	–

Beispiel

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

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	–

Beispiel

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

Sie erhalten die aktuelle Time-Instanz zurück.

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

Sie erhalten die aktuelle Time-Instanz zurück.

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

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

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

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

Sie erhalten die aktuelle Time-Instanz zurück.

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

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

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

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

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

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

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

Sie erhalten die aktuelle Time-Instanz zurück.

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

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

Sie erhalten die aktuelle Time-Instanz zurück.

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

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

Sie erhalten die aktuelle Time-Instanz zurück.

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

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

Sie erhalten die aktuelle Time-Instanz zurück.

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

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

Sie erhalten die aktuelle Time-Instanz zurück.

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

Sie erhalten die aktuelle Time-Instanz zurück.

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

Sie erhalten die aktuelle Time-Instanz zurück.

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

Sie erhalten die aktuelle Time-Instanz zurück.

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

Sie erhalten die aktuelle Time-Instanz zurück.

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

Sie erhalten die aktuelle Time-Instanz zurück.

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

Sie erhalten die aktuelle Time-Instanz zurück.

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	–	Beispiel

Beispiel

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

Zu dieser Funktion existieren keine 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

Sie erhalten die aktuelle Time-Instanz zurück.

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

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

Sie erhalten die aktuelle Time-Instanz zurück.

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

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

Sie erhalten die aktuelle Time-Instanz zurück.

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: setFirstDayOfWeek setToPrevious setToPreviousOrSame setToNext setToNextOrSame
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();