Die Funktion ecx:fmtDateInTimeZone interpretiert ein vorgegebenes Datum in einer bestimmten Zeitzone. Die Funktion wendet die festgelegte Zeitzone der Quelle auf das Datum an, lässt jedoch die Felder von Datum und Uhrzeit so, wie sie ursprünglich für Datum und Uhrzeit waren. Das Datum wird als Zeichkette entsprechend des vorgegebenen Musters mit Region formatiert. Es wird ein Wert vom Typ Zeichenkette zurückgegeben.

Struktur​

ecx:fmtDateInTimeZone(Datum, Zeichenkette, Zeichenkette, Zeichenkette, Zeichenkette)

Parameter​

Parameter

Beschreibung

Datum

Der Parameter spezifiziert den zu formatierenden Zielwert. Wenn der genutzte Wert ein Wert vom Typ Zeichenkette ist, muss er mit der Funktion ecm:toDate in einen Wert vom Datentyp Datum umgewandelt werden.

Zeichenkette

Der Parameter spezifiziert die Zeitzone der Quelle. Ist keine Zeitzone spezifiziert, wird die Zeitzone UTC+00:00 verwendet.

Zeichenkette

Der Parameter spezifiziert die Zeitzone des Ziels.

Zeichenkette

Der Parameter spezifiziert das Datumsformat. Eine Liste möglicher Datumsmuster ist hier verfügbar: http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html. Der Parameter erkennt auch die Werte 'date', 'shortdate', 'time', 'datetimesec', 'datetime', 'shortdatetime', 'xlsdate', 'xlsdatetime', 'iso8601date' und 'iso8601datetime'. Das Format der Ausgabe wird näher bestimmt durch die Variable localeCode.

Zeichenkette

Der Parameter spezifiziert die localeCode Variable, die ein länderspezifisches Format auf das Datum gemäß dem genutzten ISO Sprachcode anwendet.

Beispiel

Der Zeitpunkt des Einkaufs wird im angepassten Attribut ​user.CustomAttribute['Einkaufsdatum']​ gespeichert. Die Funktion, die den Wert in die Zeitzone der Stadt Sydney umwandelt, ist wie folgt aufgebaut:

${ecx:fmtDateInTimezone(user.CustomAttribute['Einkaufsdatum'], null, 'Australia/Sydney', 'yyyy-MM-dd HH:mm:ssZ', 'en')}

Ist der Wert des Attributs 2013-09-08T02:00:00+0200 (Mitternacht zur UTC Zeit), ist die Ausgabe ​2013-09-08T00:00:00+1000​.