Date/Time – Referenzhandbuch

Eigenschaft	Type	Beschreibung
years	Zahl	Eine vierstellige Zahl für das Jahr des angegebenen Datums.
months	Zahl	Der Monat im Jahr des angegebenen Datums. Januar ist 1.
date	Zahl	Der Tag im Monat des angegebenen Datums.
hours	Zahl	Die Stunde am Tag des angegebenen Datums oder der angegebenen Uhrzeit.
minutes	Zahl	Die Minute in der Stunde des angegebenen Datums oder der angegebenen Uhrzeit.
seconds	Zahl	Die Sekunde in der Minute des angegebenen Datums oder der angegebenen Uhrzeit.
milliseconds	Zahl	Die Millisekunde in der Sekunde des angegebenen Datums oder der angegebenen Uhrzeit.
offset	Zeichenfolge	Die Zeitverschiebung von der koordinierten Weltzeit (UTC) mit einer Zeichenfolge im Format ±HH:mm.
iso	Zeichenfolge	Datum/Uhrzeit in einer nach Standard ISO-8601 formatierten Zeichenfolge. Beispiel: YYYY-MM-DDTHH:mm:ssZ
utc	Zeichenfolge	Datum/Uhrzeit in UTC in einer nach Standard ISO-8601 formatierten Zeichenfolge.
unix	Zahl	Datum/Uhrzeit als Zahl für den Unix-Zeitstempel.
isValid	Boolean	Ein boolescher Wert, der angibt, ob Datum/Uhrzeit gültig ist.

Eigenschaft	Type	Beschreibung
years	Zahl	Eine Ganzzahl für die Anzahl der vergangenen Jahre zwischen den beiden Datumsangaben.
months	Zahl	Eine Ganzzahl für die Anzahl der Monate, die zwischen den beiden Datumsangaben vergangen sind, nach der Berechnung der Anzahl der Jahre.
days	Zahl	Eine Ganzzahl für die Anzahl der Tage, die zwischen den beiden Datumsangaben vergangen sind, nach der Berechnung der Anzahl der Monate und Jahre.
hours	Zahl	Eine Ganzzahl für die Anzahl der Stunden, die zwischen den beiden Datumsangaben vergangen sind, nach der Berechnung der Anzahl der Tage, Monate und Jahre.
minutes	Zahl	Eine Ganzzahl für die Anzahl der Minuten, die zwischen den beiden Datumsangaben vergangen sind, nach der Berechnung der Anzahl der Stunden, Tage, Monate und Jahre.
seconds	Zahl	Eine Ganzzahl für die Anzahl der Sekunden, die zwischen den beiden Datumsangaben vergangen sind, nach der Berechnung der Anzahl der Minuten, Stunden, Tage, Monate und Jahre.
milliseconds	Zahl	Eine Ganzzahl für die Anzahl der Millisekunden, die zwischen den beiden Datumsangaben vergangen sind, nach der Berechnung der Anzahl der Sekunden, Minuten, Stunden, Tage, Monate und Jahre.
iso	Zeichenfolge	Zeitraum in einer nach Standard ISO-8601 formatierten Zeichenfolge.
humanized	Zeichenfolge	Eine Zeichenfolge mit einem menschenlesbaren Format für die Zeit. Ergibt eine ähnliche Antwort wie das „Format Date/Time“-Modul mit relativer Formatierung. Beispiel: „2 years“.
isDuration	Boolean	Ein boolescher Wert, der angibt, ob ein „Duration“-Objekt vorliegt. Der Wert ist immer „true“, wenn das Objekt gültig ist.
isValid	Boolean	Ein boolescher Wert, der angibt, ob Datum/Uhrzeit gültig ist.
in	Objekt	Jeder Wert in diesem Objekt entspricht der Eigenschaft in dieser Tabelle, aber alle anderen Zeiteinheiten werden ignoriert. Beispiel: Genau 2 Jahre zwischen zwei Datumsangaben entspricht 24 Monaten.

	Token	Ausgabe
Month	M	1 2 ... 11 12
	Mo	1st 2nd ... 11th 12th
	MM	01 02 ... 11 12
	MMM	Jan Feb ... Nov Dec
	MMMM	January February ... November December
Quarter	Q	1 2 3 4
	Qo	1st 2nd 3rd 4th
Day of Month	D	1 2 ... 30 31
	Do	1st 2nd ... 30th 31st
	DD	01 02 ... 30 31
Day of Year	DDD	1 2 ... 364 365
	DDDo	1st 2nd ... 364th 365th
	DDDD	001 002 ... 364 365
Day of Week	d	0 1 ... 5 6
	do	0th 1st ... 5th 6th
	dd	Su Mo ... Fr Sa
	ddd	Sun Mon ... Fri Sat
	dddd	Sunday Monday ... Friday Saturday
Day of Week (Locale)	e	0 1 ... 5 6
Day of Week (ISO)	E	1 2 ... 6 7
Week of Year	w	1 2 ... 52 53
	wo	1st 2nd ... 52nd 53rd
	ww	01 02 ... 52 53
Week of Year (ISO)	W	1 2 ... 52 53
	Wo	1st 2nd ... 52nd 53rd
	WW	01 02 ... 52 53
Year	YY	70 71 ... 29 30
	YYYY	1970 1971 ... 2029 2030
	Y	1970 1971 ... 9999 +10000 +10001 Hinweis: Entspricht dem Standard ISO 8601 für Datumsangaben nach dem Jahr 9999
Week Year	gg	70 71 ... 29 30
	gggg	1970 1971 ... 2029 2030
Week Year (ISO)	GG	70 71 ... 29 30
	GGGG	1970 1971 ... 2029 2030
AM/PM	A	AM PM
	a	am pm
Hour	H	0 1 ... 22 23
	HH	00 01 ... 22 23
	h	1 2 ... 11 12
	hh	01 02 ... 11 12
	k	1 2 ... 23 24
	kk	01 02 ... 23 24
Minute	m	0 1 ... 58 59
	mm	00 01 ... 58 59
Second	s	0 1 ... 58 59
	ss	00 01 ... 58 59
Fractional Second	S	0 1 ... 8 9
	SS	00 01 ... 98 99
	SSS	000 001 ... 998 999
	SSSS ... SSSSSSSSS	000[0..] 001[0..] ... 998[0..] 999[0..]
Time Zone	z oder zz	EST CST ... MST PST
	Z	-07:00 -06:00 ... +06:00 +07:00
	ZZ	-0700 -0600 ... +0600 +0700
Unix Timestamp	X	1360013296
Unix Millisecond Timestamp	x	1360013296123

 

Check Date/Time – Modul

Das „Check Date/Time“-Modul prüft ein eingegebenes Datum anhand bestimmter Bedingungen und leitet den Workflow entsprechend weiter.

Es wird am einfachsten verwendet, indem auf das gesamte „Date/Time“-Objekt verwiesen wird.

 

Check Date/Time – Felder

• Date: Eine erforderliche Eingabe, die überprüft werden soll. Die Eingabe kann eine formatierte Zeichenfolge gemäß ISO-8601, ein Unix-Zeitstempel oder die Ausgabe eines strukturierten „Date/Time“-Objekts von einem anderen „Date/Time“-Modul sein.
• Condition: Geben Sie die Bedingungsoperation an, auf die das Eingabedatum geprüft werden soll. Sie können aus folgenden Optionen wählen:
  • Day of Week: Leitet den Workflow zum Pfad „Erfolg“ weiter, wenn das Datum mit einem der ausgewählten Tage übereinstimmt.
  • Is Before another Date: Leitet den Workflow zum Pfad „Erfolg“ weiter, wenn das Datum vor einem angegebenen Referenzdatum liegt (oder mit diesem identisch ist).
  • Is After another Date: Leitet den Workflow zum Pfad „Erfolg“ weiter, wenn das Datum nach einem angegebenen Referenzdatum liegt (oder mit diesem identisch ist).
  • Is Between two Dates: Leitet den Workflow zum Pfad „Erfolg“ weiter, wenn das Datum vor einem angegebenen Referenzdatum liegt (oder mit diesem identisch ist) und nach dem anderen angegebenen Referenzdatum liegt (oder mit diesem identisch ist).
  • Is a Leap Year: Leitet den Workflow zum Pfad „Erfolg“ weiter, wenn das Datum ein Schaltjahr ist. Leitet den Workflow zum Pfad „Fehlschlag“ weiter, wenn das Datum nicht in einem Schaltjahr liegt oder wenn das Datum kein Jahr enthält, z. B. wenn nur ein Monat eingegeben oder nur auf einen Monat verwiesen wurde.

Reference Dates

Wenn Sie prüfen möchten, ob ein Datum vor, nach oder zwischen einem oder mehreren Referenzdatumsangaben liegt, sind diese Eingaben erforderlich. Diese Eingaben können eine formatierte Zeichenfolge gemäß ISO-8601, ein Unix-Zeitstempel oder die Ausgabe eines strukturierten „Date/Time“-Objekts von einem anderen „Date/Time“-Modul sein.

Inclusive Reference Dates

Referenzdatumsangaben werden standardmäßig als exklusive Angaben interpretiert (Beispiel: Ist davor und nicht identisch). Wenn Sie diesen Parameter auf „true“ festlegen, wird die Bedingung basierend auf inklusiven Referenzdatumsangaben berechnet (Beispiel: Ist davor oder identisch).

Compare Date/Time – Modul

Das „Compare Date/Time“-Modul vergleicht zwei „Date/Time“-Objekte und ergibt die absolute Differenz zwischen ihnen.

Compare Date/Time – Felder

• First Date: Das erste erforderliche Eingabedatum für den Vergleich. Die Eingabe kann eine formatierte Zeichenfolge gemäß ISO-8601, ein Unix-Zeitstempel oder die Ausgabe eines strukturierten „Date/Time“-Objekts von einem anderen „Date/Time“-Modul sein.
• Second Date: Das zweite erforderliche Eingabedatum für den Vergleich. Die Eingabe kann eine formatierte Zeichenfolge gemäß ISO-8601, ein Unix-Zeitstempel oder die Ausgabe eines strukturierten „Date/Time“-Objekts von einem anderen „Date/Time“-Modul sein.
• Include End Date: Wenn diese Option ausgewählt ist, wird das zweite Eingabedatum in die Berechnung einbezogen. Beispiel: Montag bis Freitag wären 5 statt 4 Tage.

Compare Date/Time – Rückgabe

Wenn das Modul erfolgreich ist, gibt es ein strukturiertes „Duration“-Objekt zurück.

Current Date/Time – Modul

Das „Current Date/Time“-Modul gibt den aktuellen Zeitpunkt als strukturiertes „Date/Time“-Objekt zurück, das bearbeitet oder formatiert werden kann.

Current Date/Time – Felder

• Offset: Hier können Sie die UTC-Zeitverschiebung für die Eingabe festlegen. Stündliche Zeitverschiebungen von -12:00 bis +12:00 Stunden können festgelegt werden, oder Sie können die folgenden Optionen nutzen, um die UTC-Zeitverschiebung genauer zu steuern.
  • None: Die Eingabe wird so verarbeitet, wie sie ist. Wenn keine Zeitverschiebung in der Eingabezeichenfolge festgelegt ist, wird keine Zeitverschiebung angewandt. Wenn Sie eine Zeichenfolge verarbeiten, die eine Zeitverschiebung enthält (z. B. eine gemäß ISO-8601 formatierte Zeichenfolge), wird die festgelegte Zeitverschiebung der Zeichenfolge verwendet. Beispiel: 2017-07-02T21:30:00-07:00 enthält eine Zeitverschiebung von -07:00 Stunden.
  • Timezone Offset: Wählen Sie eine Zeitzone aus, anhand derer die UTC-Zeitverschiebung berechnet werden soll. Diese Berechnung berücksichtigt die Sommerzeit, die in bestimmten Zeitzonen an bestimmten Tagen gelten kann.
  • Lat/Long Offset: Geben Sie einen Standort über eine Zeichenfolge aus Breiten- und Längengrad an, getrennt durch ein Komma (,). Die Sommerzeit wird in die Berechnung der Zeitverschiebung einbezogen. Beispiel: 47.650499,-122.350070 entspricht „America/Los_Angeles“ und wird im Winter als -08:00 und im Sommer als -07:00 berechnet.
  • Custom Offset: Definieren Sie eine benutzerdefinierte Zeitverschiebung im Format „±HH:mm“. Beispiel: Plus achteinhalb Stunden: +08:30

Current Date/Time – zurückgegebene Daten

Wenn die Eingabezeichenfolge erfolgreich verarbeitet wird, gibt das Modul ein strukturiertes „Date/Time“-Objekt zurück.

Format Date/Time – Modul

Das „Format Date/Time“-Modul formatiert ein strukturiertes „Date/Time“-Objekt in eine beliebige benutzerdefinierte Zeichenfolge.

Format Date/Time – Felder

• Date: Eine erforderliche Eingabe, die in eine Zeichenfolge formatiert werden soll. Die Eingabe kann eine formatierte Zeichenfolge gemäß ISO-8601, ein Unix-Zeitstempel oder die Ausgabe eines strukturierten „Date/Time“-Objekts von einem anderen „Date/Time“-Modul sein.
• Format: Das Format der zurückgegebenen Ausgabe. Wählen Sie eine der allgemeinen Optionen aus, verwenden Sie „Date/Time“-Token zum Erstellen eines benutzerdefinierten Formats oder geben Sie ein anderes „Date/Time“-Objekt für ein relatives Format an.

Format Date/Time – zurückgegebene Daten

Die folgenden Formate werden mit diesem Beispieldatum demonstriert: 11. März 1952 um 08:15 Uhr.

ISO-8601

Ausgabe formatiert gemäß Standard ISO-8601 für Datum/Uhrzeit (YYYY-MM-DDTHH:mm:ssZ) – 1952-03-11T08:15:00+00:00

YYYY-MM-DD

1952-03-11

MM/DD/YYYY

03/11/1952

DD/MM/YYYY

11/03/1952

MM/DD

03/11

DD/MM

11/03

HH:mm

08:15

HH:mm:ss

08:15:00

Customized Format

Verwenden Sie „Date/Time Format“-Token, um eine Zeichenfolge im benutzerdefinierten Format zu erstellen. Auch Nicht-Token-Zeichen dürfen beim Erstellen der Zeichenfolge verwendet werden. Beispiel: Do of MMMM, YYYY – 11th of March, 1952

Relative Format

Geben Sie ein weiteres „Date/Time“-Objekt an, um die Eingabe relativ zu formatieren. Die Zeiteinheit wird auf die größte Einheit der Veränderung abgerundet. Beispiel: Wenn Sie die Zeichenfolge 1952-03-13T09:15:00+00:00 gemäß Standard ISO-8601 für Datum/Uhrzeit angeben, lautet die Ausgabe „vor 2 Tagen“ und nicht „vor 2 Tagen und 23 Stunden“. Das ist eine einfache Möglichkeit, menschenlesbare Formate zu erhalten. Wenn Sie eine höhere Genauigkeit benötigen, beachten Sie den Abschnitt zum „Compare Date/Time“-Modul und seinem zurückgegebenen „Duration“-Objekt.

Manipulate Date/Time – Modul

Das „Manipulate Date/Time“-Modul kann ein strukturiertes „Date/Time“-Objekt bearbeiten, indem Zeiteinheiten addiert, subtrahiert oder festgelegt werden.

 

Manipulate Date/Time – Felder

• Operation: Bearbeiten Sie das Eingabedatum, indem Sie Zeiteinheiten addieren, subtrahieren oder festlegen.
  • Add: Bearbeiten Sie das Eingabedatum, indem Sie Zeiteinheiten addieren.
  • Subtract: Bearbeiten Sie das Eingabedatum, indem Sie Zeiteinheiten subtrahieren.
  • Set: Bearbeiten Sie das Eingabedatum, indem Sie Zeiteinheiten festlegen.
• Date: Eine erforderliche Eingabe, die bearbeitet werden soll. Die Eingabe kann eine formatierte Zeichenfolge gemäß ISO-8601, ein Unix-Zeitstempel oder die Ausgabe eines strukturierten „Date/Time“-Objekts von einem anderen „Date/Time“-Modul sein.
• Years: Die Anzahl der Jahre, die zum Eingabedatum addiert oder davon subtrahiert werden sollen. Wenn Sie die Operation „Set“ verwenden, wird damit das Jahr festgelegt (z. B. 1952).
• Months: Die Anzahl der Monate, die zum Eingabedatum addiert oder davon subtrahiert werden sollen. Wenn Sie die Operation „Set“ verwenden, wird damit der Monat festgelegt (1–12).
• Days: Die Anzahl der Tage, die zum Eingabedatum addiert oder davon subtrahiert werden sollen. Wenn Sie die Operation „Set“ verwenden, wird damit der Tag des Monats festgelegt.
• Hours: Die Anzahl der Stunden, die zum Eingabedatum addiert oder davon subtrahiert werden sollen. Wenn Sie die Operation „Set“ verwenden, wird damit die Stunde festgelegt (0–23).
• Minutes: Die Anzahl der Minuten, die zum Eingabedatum addiert oder davon subtrahiert werden sollen. Wenn Sie die Operation „Set“ verwenden, wird damit die Minute festgelegt (0–59).
• Seconds: Die Anzahl der Sekunden, die zum Eingabedatum addiert oder davon subtrahiert werden sollen. Wenn Sie die Operation „Set“ verwenden, wird damit die Sekunde festgelegt (0–59).
• Duration: Neben dem Addieren oder Subtrahieren einer Zeiteinheit ist es auch möglich, einen Zeitraum zu addieren oder zu subtrahieren. Dieser Zeitraum wird als Zeichenfolge gemäß Standard ISO-8601 oder als „Duration“-Objekt aus der Ausgabe des „Compare Date/Time“-Moduls dargestellt.

Manipulate Date/Time – Rückgabe

Wenn die Eingabezeichenfolge erfolgreich verarbeitet wird, gibt das Modul ein strukturiertes „Date/Time“-Objekt zurück.

Parse Date/Time – Modul

Das „Parse Date/Time“-Modul verarbeitet ein Datum in ein strukturiertes „Date/Time“-Objekt, das bearbeitet oder formatiert werden kann.

Neben menschenlesbaren Datumsangaben kann dieses Modul Zeichenfolgen gemäß Standard ISO-8601, Zeichenfolgen gemäß Standard RFC 2822, Unix-Zeitstempel oder die Ausgabe eines anderen „Parse Date/Time“-Moduls verarbeiten. Wenn die Eingabe ungültig ist, wird ein ungültiges „Date/Time“-Objekt zurückgegeben.

 

Parse Date/Time – Felder

• Date: Eine erforderliche Eingabe, die in ein strukturiertes „Date/Time“-Objekt verarbeitet werden soll. Die Eingabe kann eine beliebige menschenlesbare Zeichenfolge, gemäß ISO-8601, gemäß RFC 2822, ein Unix-Zeitstempel oder die Ausgabe eines anderen „Parse Date/Time“-Moduls sein.
• Locale: Eine optionale Eingabe zum Angeben des Gebietsschemas der Eingabe. Das Gebietsschema wird verwendet, um zwischen gängigen Mustern zu unterscheiden, z. B. kann der 5. April 2017 im US-Gebietsschema als „04/05/2017“ oder im UK-Gebietsschema als „05/04/2017“ angegeben werden. Es ist äußerst schwierig, zwischen diesen Mustern zu unterscheiden, deshalb wird empfohlen, das passende Gebietsschema für Ihre Anforderungen anzugeben. Die Standardeinstellung ist das amerikanische Format (en).
• UTC Offset: Hier können Sie die UTC-Zeitverschiebung für die Eingabe festlegen. Stündliche Zeitverschiebungen von -12:00 bis +12:00 Stunden können festgelegt werden, oder Sie können die folgenden Optionen nutzen, um die UTC-Zeitverschiebung genauer zu steuern.
  • None: Die Eingabe wird so verarbeitet, wie sie ist. Wenn keine Zeitverschiebung in der Eingabezeichenfolge festgelegt ist, wird keine Zeitverschiebung angewandt. Wenn Sie eine Zeichenfolge verarbeiten, die eine Zeitverschiebung enthält (z. B. eine gemäß ISO-8601 formatierte Zeichenfolge), wird die festgelegte Zeitverschiebung der Zeichenfolge verwendet. Beispiel: 2017-07-02T21:30:00-07:00 enthält eine Zeitverschiebung von -07:00 Stunden.
  • Timezone Offset: Wählen Sie eine Zeitzone aus, anhand derer die UTC-Zeitverschiebung berechnet werden soll. Diese Berechnung berücksichtigt die Sommerzeit, die in bestimmten Zeitzonen an bestimmten Tagen gelten kann.
  • Lat/Long Offset: Geben Sie einen Standort über eine Zeichenfolge aus Breiten- und Längengrad an, getrennt durch ein Komma (,). Die Sommerzeit wird in die Berechnung der Zeitverschiebung einbezogen. Beispiel: 47.650499,-122.350070 entspricht „America/Los_Angeles“ und wird im Winter als -08:00 und im Sommer als -07:00 berechnet.
  • Custom Offset: Definieren Sie eine benutzerdefinierte Zeitverschiebung im Format „±HH:mm“. Beispiel: Plus achteinhalb Stunden: +08:30

Parse Date/Time – Rückgabe

Wenn die Eingabezeichenfolge erfolgreich verarbeitet wird, gibt das Modul ein strukturiertes „Date/Time“-Objekt zurück.

Round Date/Time – Modul

Das „Round Date/Time“-Modul gibt den Anfang oder das Ende einer angegebenen Zeiteinheit eines bestimmten strukturierten „Date/Time“-Objekts zurück.

Round Date/Time – Felder

• Start/End: Rundet die Eingabe auf den Anfang oder das Ende der angegebenen Zeiteinheit.
  • Start: Rundet auf den Anfang einer Zeiteinheit. Beispiel: Aus 08:15 wird 08:00.
  • End: Rundet auf das Ende einer Zeiteinheit. Beispiel: Aus 08:15 wird 08:59.
• Date: Eine erforderliche Eingabe, die um die angegebene Einheit auf- oder abgerundet werden soll. Die Eingabe kann eine formatierte Zeichenfolge gemäß ISO-8601, ein Unix-Zeitstempel oder die Ausgabe eines strukturierten „Date/Time“-Objekts von einem anderen „Date/Time“-Modul sein.
• Unit of Time: Die Zeiteinheit, in der auf- oder abgerundet werden soll. Sie können aus folgenden Optionen wählen:
  • Year
  • Quarter
  • Month
  • Week
  • Day
  • Hour
  • Minute

First Day of Week

Der erste Tag der Woche variiert auf der Welt. Wenn die ausgewählte Zeiteinheit Week ist, können Sie mit dieser Option festlegen, ab welchem Tag die Woche beginnt.

Round Date/Time – Rückgabe

Wenn die Eingabezeichenfolge erfolgreich verarbeitet wird, gibt das Modul ein strukturiertes „Date/Time“-Objekt zurück.