Gruppe	Date Functions

Die Zeichenkette a, die eine Datum/Zeit-Angabe im W3CDTF-Format enthält, wird in einen Timestamp, bezogen auf die im System eingestellte lokale Zeitzone, gewandelt.

Wenn a nicht erfolgreich geparst werden kann und eine Error-Message b angegeben wurde, wird eine Exception mit dieser Message geworfen. Andernfalls, wenn b leer war, wird ein Timestamp mit aktueller Zeit erzeugt.

Parameter

Parameter	Beschreibung
a	Datum/Zeit im W3CDTF-Format mit Datentyp String. Wichtiger Hinweis: Der Parameter erwartet die Angabe der Zeit mit Zeitzone! Allerdings wird auch ein Wert ohne Zeitzone toleriert, da dies in praktisch auftretenden Eingangsdaten häufig vorkommt. Für diesen Fall wird dann die lokale Einstellung (System) angenommen, beispielsweise Mitteleuropäische (Sommer-)Zeit. Bis Version 4.0 wurde dafür UTC (Zone Z) angenommen! Ist eine strenge W3CDTF-Formatprüfung gewünscht, sollte stattdessen die Funktion create date strict(value a, adjustable template b, default c, [locale d]) verwendet werden.
b	Fehlermeldung.

Beispiele

Die Beispiele beziehen sich auf die lokale Zeitzone (Deutschland), also für Winterzeit UTC + 1 Stunde und Sommerzeit UTC + 2 Stunden.

Die aktuelle Zeit sei 20.08.2011 15:33:23, die lokale Zeitzone (System) sei Europe/Berlin.

Parameter a	Parameter b	Ergebnis	Hinweis
1994-08-05T13:15:30+02:00	Fehler beim Lesen	1994-08-05 13:15:30 ( als Timestamp mit Zeitzone Europe/Berlin)	Sommerzeit.
1994-11-05T13:15:30+01:00	Fehler beim Lesen	1994-11-05 13:15:30 (als Timestamp mit Zeitzone Europe/Berlin)	Winterzeit.
1994-08-05T13:15:30Z	Fehler beim Lesen	1994-08-05 15:15:30 (als Timestamp mit Zeitzone Europe/Berlin)	Sommerzeit.
1994-11-05T13:15:30Z	Fehler beim Lesen	1994-11-05 14:15:30 (als Timestamp mit Zeitzone Europe/Berlin)	Winterzeit.
1994-11-05T13:15:30.852Z	Fehler beim Lesen	1994-11-05 14:15:30.852 (als Timestamp mit Zeitzone Europe/Berlin)
Kein Datum	Fehler beim Lesen	Funktion bricht mit einer Exception mit der Meldung Fehler beim Lesen ab.
Kein Datum		2011-08-20 15:33:23 (als Timestamp mit Zeitzone Europe/Berlin)	Aktuelle Zeit.

Wichtiger Hinweis

Das Format W3CDTF wird vorwiegend in XML- oder HTML-Dateien verwendet. In einer XML-Schema-Definition (XSD) wird der Datentyp dieses Feldes als date oder dateTime bezeichnet. Beim Strukturimport aus einer XSD-Datei, wird daher für Felder dieser Art der Typ Date oder Timestamp gesetzt. Das W3CDTF-Format ist aber mit dem Date/Timestamp-Typ in Lobster Integration nicht kompatibel. Ändern Sie daher bitte den Datentyp dieser Felder zu String.