format date/timestamp to text(a, template b, [Locale c], [Timezone d], [Errorhandling e])
|
Gruppe |
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.
Parameterbeschreibung
|
Parameter |
Beschreibung |
|
a |
Datum/Timestamp. Siehe auch Parameter e. |
|
b |
|
|
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 |