create and format date(a, [adj. template b], template c, d [, force-empty e])

Gruppe

Date Functions


Erzeugt einen Timestamp aus einem Wert a, basierend auf der Formatvorlage b und generiert hieraus einen Text basierend auf der Formatvorlage c.

Hat e den Wert true, wird kein Wert geparst und keine Konvertierung vorgenommen und die Funktion liefert einen leeren String zurück.

Parameterbeschreibung


Parameter

Beschreibung

a

Zu interpretierender Text. Kann ein String nicht anhand der Formatvorlage b interpretiert werden, löst das einen Fehler aus und d steuert das weitere Verhalten der Funktion.

b

(optional) Formatvorlage zur Umwandlung von a in einen Timestamp. Der Parameter muss leer gelassen werden, falls in Parameter a ein Date oder ein Timestamp verwendet wird. Default: yyyy-MM-dd HH:mm:ss.SSS. 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: Bei W3CDTF erfolgt keine Verkürzung.

c

Formatvorlage zur Umwandlung des aus a erzeugten Timestamps in einen Text. Bei Format W3CDTF wird Zeitzone=UTC gesetzt.

d

(optional) Verhaltenssteuerung im Fehlerfall. Mögliche Werte siehe Tabelle unten. Default: empty

e

(optional) Falls true, dann findet kein Parsen und keine Umwandlung statt und die Funktion liefert einen leeren String zurück. Default: false

Hinweis: Parameter e kann für folgendes Szenario eingesetzt werden: Häufig (z. B. in SAP IDocs) werden die zu einem Zeitpunkt gehörenden Datums- und Zeitwerte in separaten Feldern übertragen. Wenn nur beide Felder zusammen als gültiger Wert betrachtet werden sollen, kann man mit der Funktion empty(a) feststellen, ob eines der Felder leer ist und damit über Parameter e das Ergebnis der Wandlung als leer erzwingen.

Mögliche Werte für Parameter d


Wert

Funktionsergebnis

now

Statt des Eingangsdatums wird das aktuelle Datum verwendet.

empty

Rückgabe eines leeren Strings ("") der Länge 0 mit gesetztem Empty Flag.

error

Abbruch der Funktion mit einem Fehler.

Sonstiger Wert

Statt des Eingangsdatums a wird der hier angegebene Wert verwendet. Kann dieser nicht anhand von Formatvorlage c interpretiert werden, bricht die Funktion mit einem Fehler ab.

Beispiele


Aktuelles Datum im Beispiel: 20.10.2011 15:33:23


Parameter a

Parameter b

Parameter c

Parameter d

Parameter e

Ergebnis

01.10.11 23:34:56

dd.MM.yy HH:mm:ss

MM/dd/yyyy HH:mm:ss

error


10/01/2011 23:34:56

01.10.11 23:34:56

dd.MM.yy HH:mm:ss

MM/dd/yyyy hh:mm:ss a

error


10/01/2011 11:34:56 PM

01.10.11

dd.MM.yy HH:mm:ss

MM/dd/yyyy hh:mm:ss a

error

true

Das Ergebnis ist ein leerer Text weil Parameter e=true.

01.10.11

dd.MM.yy HH:mm:ss

MM/dd/yyyy hh:mm:ss a

error


10/01/2011 12:00:00 AM

Kein Datum

dd.MM.yyyy HH:mm:ss

MM/dd/yyyy hh:mm:ss a

error

Funktion bricht mit einem Fehler ab.

Kein Datum

dd.MM.yyyy HH:mm:ss

MM/dd/yyyy hh:mm:ss a

now


10/20/2011 03:33:23 PM

Kein Datum

dd.MM.yyyy HH:mm:ss

MM/dd/yyyy hh:mm:ss a

empty


String ("") der Länge 0 und gesetztes Empty Flag.

Kein Datum

dd.MM.yyyy HH:mm:ss

MM/dd/yyyy hh:mm:ss a

12/15/2011 11:54:12 AM


12/15/2011 11:54:12 AM

Kein Datum

dd.MM.yyyy HH:mm:ss

MM/dd/yyyy hh:mm:ss a

Auch kein Datum


Funktion bricht mit einem Fehler ab.

1997-07-16T19:20:30Z

W3CDTF

dd.MM.yyyy HH:mm:ss

empty


16.07.1997 21:20:30

01.10.11 23:34:56

dd.MM.yy HH:mm:ss

W3C

error


2011-10-01T21:34:56Z (immer UTC)