format date/timestamp to text()

Prev Next

Liefert den Date-/Timestamp-Wert a als formatierte Zeichenkette unter Verwendung einer Formatvorlage b zurück. Optional kann ein Locale c angegeben werden. Default: System-Locale. Ebenso kann mit d eine Zeitzone angegeben werden, in die das Datum vor der Formatierung gewandelt werden soll. Wird nichts angegeben, wird die Zeitzone des übergebenen Datums verwendet. Wird eine ungültige Zeitzone verwendet, wird GMT verwendet.

Parameter

Parameter

Beschreibung

a

Datum/Timestamp. Siehe auch Parameter e.

b

Formatvorlage.

c

(optional) Locale. Default: System-Locale. Hinweis: Verwenden Sie zur Auswahl eines Wertes die drei Punkte.

d

(optional) Zeitzone, in das das Datum vor der Formatierung gewandelt werden soll. Default: Zeitzone des übergebenen Datums.

Wichtiger Hinweis: Die abgekürzten Zeitzonennamen sollten vermieden werden, da diese zum Teil mehrfach verwendet wurden und so nicht sicher gesagt werden kann, welche Zeitzone gemeint ist. Java unterstützt diese Namen nur noch aus Kompatibilitätsgründen. Ein Profil kann also, z. B. nach einem Update der Java Virtual Machine oder des Betriebssystems, plötzlich andere Ergebnisse liefern. Besser ist es hier Kontinent und Stadt zu verwenden. Erlaubte Kürzel: GMT, UTC, SYSTEM (lokale Zeitzone des Servers).

Beispiele:

America/New_York

Europe/Berlin

e

(optional) Fehlerbehandlung, wenn a kein gültiger Datums-/Timestamp-Wert ist oder ein Date/Timestamp mit Empty Flag (siehe dort "versteckte Werte"). Default: <leer>

empty - Das Ergebnis der Funktion ist ein leerer String mit gesetztem Empty Flag.

error - Abbruch mit Fehlermeldung.

now - Für a wird der aktuelle Zeitpunkt als Timestamp verwendet.

<leer> - Für a wird der aktuelle Zeitpunkt als Timestamp verwendet.

<Beliebiger anderer Text> - Der Text in e wird als Ergebnis der Funktion geliefert.

Beispiele

Parameter a

b

c

d

e

Ergebnis

2005-01-05

yyyy/MM/dd HH:mm:ss

2005/01/05 00:00:00

2007-12-31

ww/yyyy

01/2007

2007-12-31

ww/YYYY

01/2008 (in erster KW 2008)

2012-12-10

dd-MMM-yyyy, EEEE

de_DE

10-Dez-2012, Montag

2012-12-10

dd-MMM-yyyy, EEEE

en_US

10-Dec-2012, Monday

2012-12-10

dd-MMM-yyyy, EEEE

fr_FR

10-déc.-2012, lundi

2012-12-10

dd-MMM-yyyy, EEEE

ru

10-дек-2012, понедельник

2012-12-10 23:25:12

EEEE, dd.MMM.yyyy hh:mm:ss a

de_DE

Montag, 10.Dez.2012 11:25:12 PM

2012-12-10 23:25:12

E, dd MMMM yyyy HH:mm:ss

fr_FR

lun., 10 décembre 2012 23:25:12

2012-12-10 23:25:12

W3C

Europe/Berlin

2012-12-10T23:25:12+01:00

2012-12-10 23:25:12

w3cdtf

GMT

2012-12-10T22:25:12Z