Die Funktion ecm:toDate wandelt eine Zeichenkette oder einen Wert in einen Datentyp der Art Datum um. Es wird ein Wert vom Typ Datum zurückgegeben.

Die Funktion wird häufig genutzt, um Werte in ein Datum umzuwandeln, um sie dann bei Funktionen zu verwenden, die als Parameter ein Datum benötigen.

Struktur​

eCm:toDate(Zeichenkette, Zeitzone)

Parameter​

Parameter

Beschreibung

Zeichenkette

Der Parameter spezifiziert den Zielwert, der in ein Datum umgewandelt werden soll. Folgende Formate können korrekt in ein Datum umgewandelt werden:

  • yyyy-MM-dd

  • dd.MM.yyyy

  • yyyy-MM-dd hh:mm:ss

  • dd.MM.yyyy hh:mm:ss

Zeitzone

Der Parameter spezifiziert die Zeitzone, die als Referenz für das Datum verwendet wird. Wenn nicht anders angegeben, wird die Standard-Zeitzone des Systems verwendet.


Beispiel

Eine Selektion legt fest, ob Empfänger, die kurz vor dem Ruhestand stehen, eine Nachricht erhalten. Die Selektionskriterien vergleichen das Geburtsdatum, welches als Attributwert gespeichert ist, mit einem konkreten Datum (1. Januar 1950). Um die zwei Datumsangaben mit der Funktion ecm:less vergleichen zu können, müssen beide Werte dem Datentyp Datum entsprechen. Die Funktion ecm:toDate wandelt die Zeichenkette '1950-01-01' in den Datentyp Datum um. Somit kann das Datum mit dem im Benutzerattribut ​user['DateofBirth']​ gespeicherten Datum verglichen werden. Die Funktionen werden wie folgt zusammengesetzt:

${ecm:less(user['DateOfBirth'], ecm:toDate('1950-01-01', ecm:timeZone('Europe/Berlin')))}