Formatspezifikationssymbole für Datumswerte

CA Process Automation verwendet standardmäßige Java-Formatmusterzeichenfolgen für Datums- und Uhrzeitwerte. In Datums- und Zeitmusterzeichenfolgen werden nicht in Anführungszeichen stehende Buchstaben von 'A' bis 'Z' und von 'a' nach 'z' als Musterbuchstaben interpretiert, die den Komponenten einer Datums- oder Uhrzeitzeichenfolge entsprechen. Text kann, damit seine Interpretation verhindert wird, in einfache (') oder doppelte Anführungszeichen (") gesetzt werden. "''" entspricht einem einfachen Anführungszeichen. Alle weiteren Zeichen werden nicht interpretiert. Sie werden beim Formatieren in die Ausgabezeichenfolge kopiert oder beim Analysieren mit der Eingabezeichenfolge abgeglichen.

Buchstabe	Datums- oder Uhrzeitkomponente	Präsentation	Beispiele
G	Ärabezeichner	Text	AD
y	Jahr	Jahr	2009; 09
M	Monat eines Jahres	Monat	Juli, 07
w	Woche eines Jahres	Nummer	27
W	Woche eines Monats	Nummer	2
D	Tag eines Jahres	Nummer	189
d	Tag eines Monats	Nummer	10
F	Wochentag eines Monats	Nummer	2
E	Wochentag	Text	Dienstag, Die
a	AM/PM-Kennzeichnung	Text	PM
N	Stunde eines Tages (0-23)	Nummer	0
k	Stunde eines Tages (1-24)	Nummer	24
K	Stunde in AM/PM (0-11)	Nummer	0
h	Stunde in AM/PM (1-12)	Nummer	12
m	Minute einer Stunde	Nummer	30
s	Sekunde einer Minute	Nummer	55
S	Millisekunde	Nummer	978
z	Zeitzone	Allgemeine Zeitzone	Pacific Standard Time, PST, GMT-08:00
Z	Zeitzone	RFC 822-Zeitzone	-0800

Muster werden üblicherweise wiederholt. Ihre Anzahl bestimmt die genaue Darstellung, wie in der folgenden Tabelle erläutert:

Präsentation	Formatieren
Text	Beträgt die Anzahl der Musterbuchstaben 4 oder mehr, wird die vollständige Form verwendet. Andernfalls wird, unabhängig von der Anzahl der Musterbuchstaben, eine kurze oder gekürzte Form akzeptiert.
Nummer	Die Anzahl von Musterbuchstaben ist die Mindestanzahl von Ziffern, und kürzere Zahlen werden bis zu dieser Anzahl mit Nullen aufgefüllt. Beim Analysieren wird die Anzahl von Musterbuchstaben ignoriert, es sei denn, sie wird benötigt, zwei angrenzende Felder zu trennen.
Jahr	Wenn die Anzahl von Musterbuchstaben gleich 2 ist, wird das Jahr auf 2 Ziffern gekürzt. Andernfalls wird sie als eine Zahl interpretiert. Ist die Anzahl von Musterbuchstaben größer als 2, wird das Jahr beim Analysieren literal (wortgetreu) interpretiert, ungeachtet der Ziffernanzahl. Daher wird, wenn das Muster "dd.MM.yyyy" verwendet wird, 11.01.12" beim Analysieren in "11.01.2012 A.D." umgewandelt.
Monat	Wenn die Anzahl von Musterbuchstaben gleich 3 oder mehr ist, wird der Monat als Text interpretiert. Andernfalls wird er als eine Zahl interpretiert.
Allgemeine Zeitzone	Zeitzonen werden als Text interpretiert, wenn sie Namen haben. Für Zeitzonen, die einem GMT-Offsetwert entsprechen, wird die folgende Syntax verwendet: GMTOffsetZeitzone: GMT Vorzeichen Stunden : Minuten Vorzeichen ist + oder - Stunden müssen zwischen 0 und 23 liegen und eines der folgenden Formate haben: Ziffer Ziffer Ziffer Minuten müssen zwischen 00 und 59 liegen und folgendes Format haben: Ziffer Ziffer Ziffer ist eines der folgenden Zeichen: 0 1 2 3 4 5 6 7 8 9 Das Format ist vom Gebietsschema unabhängig und muss aus dem Block Basis-Lateinisch des Unicode-Standards übernommen werden.
RFC 822-Zeitzone	Es wird ein Zeitzonenformat mit vier Ziffern verwendet: RFC822Zeitzone: Vorzeichen ZweiZiffernStunden Minuten ZweiZiffernStunden muss zwischen 00 und 23 liegen. Weitere Definitionen sind gleich wie für allgemeine Zeitzonen.

SimpleDateFormat unterstützt auch lokalisierte Datums- und Uhrzeitmusterzeichenfolgen. In diesen Zeichenfolgen können die oben beschriebenen Musterbuchstaben durch andere, vom Gebietsschema abhängige Musterbuchstaben ersetzt werden. SimpleDateFormat kümmert sich nicht um die Lokalisierung von Text, der keine Musterbuchstaben angibt. Dies ist Sache des Clients der Klasse.

Die folgenden Beispiele zeigen, wie Datum- und Uhrzeitmuster im Gebietsschema US-Englisch interpretiert werden. Das verwendete Datum und die verwendete Uhrzeit sind 2009-07-04 12:08:56 in der US-Zeitzone Pacific Standard Time.

Datums- und Uhrzeitmuster	Ergebnis
"yyyy.MM.dd G 'um' HH:mm:ss z'	2009,07.04 AD um 12:08:56 PST
"EEE, MMM-D,'' yy "	Wed, Jul 4, '09
"h:mm a"	12:08 PM
"hh 'o''clock' a, zzzz"	12 o'clock PM, Pacific Daylight Time
"K:mm a, z"	0:08 PM, PDT
"yyyyy.MMMMM.dd GGG hh:mm aaa"	02009.July.04 AD 12:08 PM
"EEE, d MMM yyyy HH:mm:ss Z"	Wed, 4 Jul 2009 12:08:56 -0700
"yyMMddHHmmssZ"	010704120856-0700
"yyyy-MM-dd'T'HH:mm:ss.SSSZ"	2009-07-04T12:08:56,235-0700