create date strict(value a, adjustable template b, default c, [Locale d, Timezone e])
Gruppe |
Liefert einen Timestamp basierend auf dem Wert von a und der Formatvorlage b zurück.
Eine optionale Locale d modifiziert das Parsen von Monatsnamen, Wochentagsnamen, usw.
Parameterbeschreibung
Parameter |
Beschreibung |
a |
Zu interpretierender Text. Kann ein String nicht anhand der Formatvorlage b interpretiert werden, löst das einen Fehler aus und c steuert das weitere Verhalten der Funktion. |
b |
Formatvorlage. Wichtiger Hinweis: Falls der String in a kürzer ist als die Vorlage in b, dann wird b auf die Länge von a gekürzt. Beachten Sie bitte, dass dies in seltenen Fällen zu Genauigkeitsverlusten oder ungültigen Werten und damit Folgefehlern führen kann. Sonderfall W3CDTF: Diese Formatvorlage besteht nicht aus Platzhaltern. Deshalb erfolgt keine Verkürzung. Das Format enthält keine Monats- oder Tagesnamen. Deshalb wird kein Locale (Parameter d) verwendet. |
c |
(optional) Steuerung des Verhaltens im Falle eines ungültigen Wertes. Mögliche Werte siehe Tabelle unten. Default: empty |
d |
(optional) Locale. Wird zum Parsen der Monatsnamen verwendet. Default: System-Locale. Hinweis: Verwenden Sie zur Auswahl eines Wertes die drei Punkte. Beispiel: de_DE |
e |
(optional) Zeitzone. Default: System-Zeitzone. Beispiel: UTC |
Mögliche Werte für Parameter c
Wert |
Funktionsergebnis |
now |
Statt des Eingangsdatums wird das aktuelle Datum zurückgegeben. |
empty |
Das Empty Flag wird gesetzt. Zudem erhält das Feld intern das aktuelle Datum. Durch das gesetzte Empty Flag wird dieses aber nicht sichtbar. Siehe auch Funktion get empty flag(a). |
error |
Abbruch der Funktion mit einer Exception. |
Sonstiges |
Statt des Eingangsdatums wird der angegebene Wert verwendet. Kann auch dieser nicht anhand von b interpretiert werden, bricht die Funktion mit einer Exception ab. |
Beispiele
Aktuelles Datum im Beispiel: 20.10.2011 15:33:23
Das System hat die Zeitzone Europe/Berlin.
Hinweis: Der Wert Kein Datum kann mit keiner Formatvorlage b als Timestamp interpretiert werden und löst somit einen Fehler aus. Das weitere Verhalten der Funktion wird dann mit Parameter c gesteuert.
Parameter a |
b |
c |
d |
e |
Ergebnis |
Ergebnis von get empty flag(a) |
241205 |
ddMMyyHHmm |
error |
|
|
2005-12-24 00:00:00.0 |
false |
Kein Datum |
ddMMyyHHmm |
error |
|
|
Funktion bricht mit einer Exception ab. |
|
Kein Datum |
ddMMyyHHmm |
now |
|
|
2011-10-20 15:33:23.0 |
false |
Kein Datum |
ddMMyyHHmm |
empty |
|
|
(Siehe Beschreibung von empty für Parameter c oben) |
true |
Kein Datum |
ddMMyyHHmm |
231010 |
|
|
2010-10-23 00:00:00.0 |
false |
2412050820 |
ddMMyyHHmm |
error |
|
|
2005-12-24 08:20:00.0 |
false |
10.Dez 2012 |
dd.MMM yyyy |
empty |
de_DE |
|
2012-12-10 00:00:00.0 |
false |
9-дек-2012 |
d-MMM-yyyy |
empty |
ru |
|
2012-12-09 00:00:00.0 |
false |
1997-07-16T19:20:30Z (Siehe Formatvorlage W3CDTF) |
W3C |
now |
|
|
1997-07-16 21:20:30.0 |
false |
31.03.2024 02:30:00 |
dd.MM.yyyy HH:mm:ss |
|
|
|
Das aktuelle Datum mit gesetztem Empty Flag. |
true |
31.03.2024 02:30:00 |
dd.MM.yyyy HH:mm:ss |
|
|
UTC |
2024-03-31 04:30:00.0 |
false |