iCalamus: Datum-Formatsyntax

Datum-Formatsyntax

iCalamus benutzt die ICU-Syntax für Datumformate. Sie wird nachfolgend detailliert beschrieben.

Das Datum-/Zeit-Format wird durch ein Textmuster beschrieben. Die Anzahl der Buchstaben bestimmt das Ausgabeformat. Die folgenden Buchstaben sind für Textmuster reserviert:

Tabelle 1: ICU-Datum-Format
Symbol	Bedeutung	Präsentation	Beispiel
G	Epochen-Bezeichner	(Text)	AD
y	Jahr	(Nummer)	2006
M	Monat im Jahr	(Text + Nummer)	Juli und 07
d	Tag im Monat	(Nummer)	10
h	Stunde in am/pm (1 12)	(Nummer)	12
H	Stunde im Tag (0 23)	(Nummer)	0
m	Minute in der Stunde	(Nummer)	30
s	Sekunde in der Minute	(Nummer)	55
S	Millisekunde	(Nummer)	978
E	Wochentag	(Text)	Dienstag
D	Tag im Jahr	(Nummer)	189
F	Wochentag im Monat	(Nummer)	2 (2. Mittwoch im Juli)
w	Woche im Jahr	(Nummer)	27
W	Woche im Monat	(Nummer)	2
a	am/pm-Kennzeichnung	(Text)	pm
k	Stunde im Tag (1 24)	(Nummer)	24
K	Stunde in am/pm (0 11)	(Nummer)	0
Z	Zeitzone	(Text)	Pacific Standard Time
'	Textanfang
''	Einfache Anführung		'

Text: Vier oder mehr Buchstaben ergeben die Langform, weniger als vier ergeben die Kurzform oder eine abgekürzte Form, wenn eine existiert (Beispiel: 'EEEE' ergibt 'Montag', 'EEE' ergibt 'Mon').
Nummer: Die Minimalanzahl an Ziffern. Kürzere Nummern-Buchstaben ergeben Ergebnisse ohne führende Null (Beispiel: 'm' ergibt '6', 'mm' ergibt '06'). Das Jahr wird besonders behandelt: Wenn die Anzahl 'y' 2 ist, wird das Jahr auf 2 Ziffern abgekürzt (Beispiel: 'yyyy' ergibt '2006', 'yy' ergibt '06'.)
Text + Nummer: Drei oder mehr Buchstaben erzeugen Text, ansonsten Ziffern. (Beispiel: 'M' ergibt '1', 'MM' ergibt '01', 'MMM' ergibt 'Jan' und 'MMMM' ergibt 'Januar'.)

Hinweis: Alle Zeichen im Textmuster, die nicht im Bereich von ['a'..'z'] und ['A'..'Z'] liegen, werden als normaler Text wiedergegeben. Zum Beispiel werden Zeichen wie ':', '.', ' ', '#' und '@' im Ergebnis ausgegeben, selbst wenn Sie nicht in einfachen Anführungen eingeklammert sind.
Ein Textmuster, das nicht erlaubte Zeichen oder Zeichenkombinationen enthält, führt zu einer Fehlermeldung.

Tabelle 2: ICU Datum-Format-Beispiele
Format-Textmuster	Ergebnis
yyyy.MM.dd G 'um' HH:mm:ss Z	1996.07.10 AD um 15:08:56 PDT
EEE, d. MMM ''yy	Mit, 10. Juli '96
h:mm a	8:08 PM
hh 'o''clock' a, ZZZZ	09 o'clock AM. Eastern Standard Time
K:mm a, Z	9:34 AM, PST
dd. MMMM yyyy GGG hh:mm aaa	10. Juli 1996 AD 12:08 PM