Benutzerdefinierte und DateTime-Formatzeichenfolgen
Aktualisiert: November 2007
Eine benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit definiert die Textdarstellung eines DateTime-Werts oder eines DateTimeOffset-Werts, der durch einen Formatierungsvorgang erstellt wird. Benutzerdefinierte Formatzeichenfolgen für Datum und Uhrzeit bestehen aus einem oder mehreren benutzerdefinierten Zahlenformatbezeichnern. Alle Zeichenfolgen, bei denen es sich nicht um DateTime-Standardformatzeichenfolgen handelt, werden als benutzerdefinierte Formatzeichenfolgen für Datum und Uhrzeit interpretiert.
Hinweis SStandard-Formatzeichenfolgen für Datum und Uhrzeit können mit dem Wert DateTime und mit dem Wert DateTimeOffset verwendet werden.
Benutzerdefinierte Formatbezeichner für Datum und Uhrzeit
In der folgenden Tabelle werden die benutzerdefinierten Formatbezeichner für Datum und Uhrzeit beschrieben. Sofern nicht anders angegeben, erzeugt ein bestimmter benutzerdefinierten Formatbezeichner für Datum und Uhrzeit eine identische Zeichenfolgendarstellung, unabhängig davon, ob sie mit einem DateTime-Wert oder einem DateTimeOffset-Wert verwendet wird.
Formatbezeichner |
Beschreibung |
---|---|
d |
Stellt den Tag eines Monats als Zahl von 1 bis 31 dar. Einstellige Tage werden ohne führende Null formatiert. Weitere Informationen zum Verwenden eines einzelnen benutzerdefinierten Formatbezeichners finden Sie unter Verwenden von einzelnen benutzerdefinierten Formatbezeichnern. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner d in mehrere Formatzeichenfolgen ein.
|
dd |
Stellt den Tag eines Monats als Zahl von 01 bis 31 dar. Einstellige Tage werden mit einer führenden Null formatiert. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner dd in eine benutzerdefinierte Formatzeichenfolge ein.
|
ddd |
Stellt den in der aktuellen DateTimeFormatInfo.AbbreviatedDayNames-Eigenschaft definierten abgekürzten Namen des Wochentags dar. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner ddd in eine benutzerdefinierte Formatzeichenfolge ein.
|
dddd (plus einer beliebigen Anzahl zusätzlicher d-Bezeichner) |
Stellt den in der aktuellen DateTimeFormatInfo.DayNames-Eigenschaft definierten vollständigen Namen des Wochentags dar. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner dddd in eine benutzerdefinierte Formatzeichenfolge ein.
|
f |
Stellt die signifikanteste Ziffer des Sekundenbruchteils dar, d. h., stellt die Zehntelsekunden in einem Datums- und Uhrzeitwert dar. Wenn der f-Formatbezeichner allein verwendet wird, d. h. ohne andere Formatbezeichner, wird er als f-Standardformatbezeichner für Datum und Uhrzeit interpretiert. Weitere Informationen zum Verwenden eines einzelnen Formatbezeichners finden Sie unter Verwenden von einzelnen benutzerdefinierten Formatbezeichnern. Wenn Sie diesen Formatbezeichner als Teil einer Formatzeichenfolge verwenden, die für die Methoden ParseExact, TryParseExact, ParseExact oder TryParseExact bereitgestellt werden, gibt die Anzahl der von verwendeten f-Formatbezeichner die Anzahl der signifikantesten Ziffern des Sekundenbruchteils an, der vorhanden sein muss, damit die Zeichenfolge erfolgreich analysiert wird. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner f in mehrere benutzerdefinierte Formatzeichenfolgen ein.
|
ff |
Stellt die zwei signifikantesten Ziffern des Sekundenbruchteils dar, d. h., stellt die Hunderstelsekunden in einem Datums- und Uhrzeitwert dar. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner ff in mehrere benutzerdefinierte Formatzeichenfolgen ein.
|
fff |
Stellt die drei signifikantesten Ziffern des Sekundenbruchteils dar, d. h., stellt die Millisekunden in einem Datums- und Uhrzeitwert dar. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner fff in mehrere benutzerdefinierte Formatzeichenfolgen ein.
|
ffff |
Stellt die vier signifikantesten Ziffern des Sekundenbruchteils dar, d. h., stellt die Zehntausendstelsekunden in einem Datums- und Uhrzeitwert dar. Auch wenn es möglich ist, die Zehntausendstelsekundenkomponente eines Zeitwerts anzuzeigen, ist dieser Wert möglicherweise nicht sinnvoll. Die Genauigkeit der Datums- und Uhrzeitwerte hängt von der Auflösung der Systemuhr ab. Unter Windows NT 3.5 und höher und in Windows Vista-Betriebssystemen beträgt die Auflösung der Uhr etwa 10 - 15 Millisekunden. |
fffff |
Stellt die fünf signifikantesten Ziffern des Sekundenbruchteils dar, d. h., stellt die Hunderttausendstelsekunden in einem Datums- und Uhrzeitwert dar. Auch wenn es möglich ist, die Hunderttausendstelsekundenkomponente eines Zeitwerts anzuzeigen, ist dieser Wert möglicherweise nicht sinnvoll. Die Genauigkeit der Datums- und Uhrzeitwerte hängt von der Auflösung der Systemuhr ab. Unter Windows NT 3.5 und höher und in Windows Vista-Betriebssystemen beträgt die Auflösung der Uhr etwa 10 - 15 Millisekunden. |
ffffff |
Stellt die sechs signifikantesten Ziffern des Sekundenbruchteils dar, d. h., stellt die Millionstelsekunden in einem Datums- und Uhrzeitwert dar. Auch wenn es möglich ist, die Millionstelsekundenkomponente eines Zeitwerts anzuzeigen, ist dieser Wert möglicherweise nicht sinnvoll. Die Genauigkeit der Datums- und Uhrzeitwerte hängt von der Auflösung der Systemuhr ab. Unter Windows NT 3.5 und höher und in Windows Vista-Betriebssystemen beträgt die Auflösung der Uhr etwa 10 - 15 Millisekunden. |
fffffff |
Stellt die sieben signifikantesten Ziffern des Sekundenbruchteils dar, d. h., stellt die Zehnmillionstelsekunden in einem Datums- und Uhrzeitwert dar. Auch wenn es möglich ist, die Zehnmillionstelsekundenkomponente eines Zeitwerts anzuzeigen, ist dieser Wert möglicherweise nicht sinnvoll. Die Genauigkeit der Datums- und Uhrzeitwerte hängt von der Auflösung der Systemuhr ab. Unter Windows NT 3.5 und höher und in Windows Vista-Betriebssystemen beträgt die Auflösung der Uhr etwa 10 - 15 Millisekunden. |
F |
Stellt die signifikanteste Ziffer des Sekundenbruchteils dar, d. h., stellt die Zehntelsekunden in einem Datums- und Uhrzeitwert dar. Es wird nichts angezeigt, wenn die Ziffer 0 (null) ist. Wenn der F-Formatbezeichner allein verwendet wird, d. h. ohne andere Formatbezeichner, wird er als F-Standardformatbezeichner für Datum und Uhrzeit interpretiert. Weitere Informationen zum Verwenden eines einzelnen Formatbezeichners finden Sie unter Verwenden von einzelnen benutzerdefinierten Formatbezeichnern. Die Anzahl der F-Formatbezeichner, die mit den Methoden ParseExact, TryParseExact, ParseExact oder TryParseExact bereitgestellt werden, gibt die maximale Anzahl der signifikantesten Ziffern des Sekundenbruchteils an, der vorhanden sein kann, damit die Zeichenfolge erfolgreich analysiert wird. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner F in eine benutzerdefinierte Formatzeichenfolge ein.
|
FF |
Stellt die zwei signifikantesten Ziffern des Sekundenbruchteils dar, d. h., stellt die Hunderstelsekunden in einem Datums- und Uhrzeitwert dar. Nachfolgende Nullen (0) oder zwei 0-Ziffern werden jedoch nicht angezeigt. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner FF in eine benutzerdefinierte Formatzeichenfolge ein.
|
FFF |
Stellt die drei signifikantesten Ziffern des Sekundenbruchteils dar, d. h., stellt die Millisekunden in einem Datums- und Uhrzeitwert dar. Nachfolgende Nullen (0) oder drei 0-Ziffern werden jedoch nicht angezeigt. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner FFF in eine benutzerdefinierte Formatzeichenfolge ein.
|
FFFF |
Stellt die vier signifikantesten Ziffern des Sekundenbruchteils dar, d. h., stellt die Zehntausendstelsekunden in einem Datums- und Uhrzeitwert dar. Nachfolgende Nullen (0) oder vier 0-Ziffern werden jedoch nicht angezeigt. Auch wenn es möglich ist, die Zehntausendstelsekundenkomponente eines Zeitwerts anzuzeigen, ist dieser Wert möglicherweise nicht sinnvoll. Die Genauigkeit der Datums- und Uhrzeitwerte hängt von der Auflösung der Systemuhr ab. Unter Windows NT 3.5 und höher und in Windows Vista-Betriebssystemen beträgt die Auflösung der Uhr etwa 10 - 15 Millisekunden. |
FFFFF |
Stellt die fünf signifikantesten Ziffern des Sekundenbruchteils dar, d. h., stellt die Hunderttausendstelsekunden in einem Datums- und Uhrzeitwert dar. Nachfolgende Nullen (0) oder fünf 0-Ziffern werden jedoch nicht angezeigt. Auch wenn es möglich ist, die Hunderttausendstelsekundenkomponente eines Zeitwerts anzuzeigen, ist dieser Wert möglicherweise nicht sinnvoll. Die Genauigkeit der Datums- und Uhrzeitwerte hängt von der Auflösung der Systemuhr ab. Unter Windows NT 3.5 und höher und in Windows Vista-Betriebssystemen beträgt die Auflösung der Uhr etwa 10 - 15 Millisekunden. |
FFFFFF |
Stellt die sechs signifikantesten Ziffern des Sekundenbruchteils dar, d. h., stellt die Millionstelsekunden in einem Datums- und Uhrzeitwert dar. Nachfolgende Nullen (0) oder sechs 0-Ziffern werden jedoch nicht angezeigt. Auch wenn es möglich ist, die Millionstelsekundenkomponente eines Zeitwerts anzuzeigen, ist dieser Wert möglicherweise nicht sinnvoll. Die Genauigkeit der Datums- und Uhrzeitwerte hängt von der Auflösung der Systemuhr ab. Unter Windows NT 3.5 und höher und in Windows Vista-Betriebssystemen beträgt die Auflösung der Uhr etwa 10 - 15 Millisekunden. |
FFFFFFF |
Stellt die sieben signifikantesten Ziffern des Sekundenbruchteils dar, d. h., stellt die Zehnmillionstelsekunden in einem Datums- und Uhrzeitwert dar. Nachfolgende Nullen (0) oder sieben 0-Ziffern werden jedoch nicht angezeigt. Auch wenn es möglich ist, die Zehnmillionstelsekundenkomponente eines Zeitwerts anzuzeigen, ist dieser Wert möglicherweise nicht sinnvoll. Die Genauigkeit der Datums- und Uhrzeitwerte hängt von der Auflösung der Systemuhr ab. Unter Windows NT 3.5 und höher und in Windows Vista-Betriebssystemen beträgt die Auflösung der Uhr etwa 10 - 15 Millisekunden. |
g, gg (plus einer beliebigen Anzahl zusätzlicher g-Bezeichner) |
Stellt die Periode oder den Zeitraum dar (beispielsweise A.D.). Dieser Bezeichner wird durch die Formatierung ignoriert, wenn dem zu formatierenden Datum keine Zeichenfolge für die Periode oder den Zeitraum zugeordnet ist. Weitere Informationen zum Verwenden eines einzelnen Formatbezeichners finden Sie unter Verwenden von einzelnen benutzerdefinierten Formatbezeichnern. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner g in eine benutzerdefinierte Formatzeichenfolge ein.
|
h |
Stellt die Stunde als Zahl von 1 bis 12 dar. Die Stunde wird dabei im 12-Stunden-Format dargestellt, bei dem die ganzen Stunden ab Mitternacht oder 12 Uhr mittags gezählt werden. Eine Stunde nach Mitternacht lässt nicht von derselben Stunde nach 12 Uhr mittags unterscheiden. Die Stunde wird nicht gerundet. Einstellige Stunden werden ohne führende Null formatiert. Lautet die Uhrzeit z. B. 5:43, so zeigt dieser benutzerdefinierte Formatbezeichner "5" an. Weitere Informationen zum Verwenden eines einzelnen Formatbezeichners finden Sie unter Verwenden von einzelnen benutzerdefinierten Formatbezeichnern. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner h in eine benutzerdefinierte Formatzeichenfolge ein.
|
hh, hh (plus einer beliebigen Anzahl zusätzlicher h-Bezeichner) |
Stellt die Stunde als Zahl von 01 bis 12 dar. Die Stunde wird dabei im 12-Stunden-Format dargestellt, bei dem die ganzen Stunden ab Mitternacht oder 12 Uhr mittags gezählt werden. Eine Stunde nach Mitternacht lässt nicht von derselben Stunde nach 12 Uhr mittags unterscheiden. Die Stunde wird nicht gerundet. Einstellige Stunden werden mit einer führenden Null formatiert. Lautet die Uhrzeit z. B. 5:43, so zeigt dieser Formatbezeichner "05" an. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner hh in eine benutzerdefinierte Formatzeichenfolge ein.
|
H |
Stellt die Stunde als Zahl von 0 bis 23 dar. Die Stunde wird dabei im nullbasierten 24-Stunden-Format dargestellt, bei dem die Stunden ab Mitternacht gezählt werden. Einstellige Stunden werden ohne führende Null formatiert. Weitere Informationen zum Verwenden eines einzelnen Formatbezeichners finden Sie unter Verwenden von einzelnen benutzerdefinierten Formatbezeichnern. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner H in eine benutzerdefinierte Formatzeichenfolge ein.
|
HH, HH (plus einer beliebigen Anzahl zusätzlicher H-Bezeichner) |
Stellt die Stunde als Zahl von 00 bis 23 dar. Die Stunde wird dabei im nullbasierten 24-Stunden-Format dargestellt, bei dem die Stunden ab Mitternacht gezählt werden. Einstellige Stunden werden mit einer führenden Null formatiert. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner HH in eine benutzerdefinierte Formatzeichenfolge ein.
|
K |
Stellt die Zeitzoneninformationen eines Datums- und Uhrzeitwerts dar. Bei Verendung mit DateTime-Werten wird die Ergebniszeichenfolge durch den Wert der DateTime.Kind-Eigenschaft definiert. Für die lokale Zeitzone (ein DateTime.Kind-Eigenschaftswert von DateTimeKind.Local) ist dieser Bezeichner gleich dem Bezeichner zzz und erzeugt eine Ergebniszeichenfolge, die den lokalen Offset der koordinierten Weltzeit (Coordinated Universal Time, UTC) enthält, z. B. "-07:00". Für eine UTC-Zeit (ein DateTime.Kind-Eigenschaftswert von DateTimeKind.Utc) umfasst die Ergebniszeichenfolge ein Zeichen "Z", das ein UTC-Datum darstellt. Für eine Zeit in einer nicht spezifizierten Zeitzone (eine Zeit, deren DateTime.Kind-Eigenschaft gleich DateTimeKind.Unspecified ist), entspricht das Ergebnis String.Empty. Für DateTimeOffset-Werte ist der Formatbezeichner K gleich dem Formatbezeichner zzz und erzeugt eine Ergebniszeichenfolge, die den Offset des DateTimeOffset-Werts von der koordinierten Weltzeit (Coordinated Universal Time, UTC) enthält. Weitere Informationen zum Verwenden eines einzelnen Formatbezeichners finden Sie unter Verwenden von einzelnen benutzerdefinierten Formatbezeichnern. Das folgenden Beispiel zeigt die Zeichenfolge, die sich ergibt, wenn der benutzerdefinierte Formatbezeichner K mit verschiedenen DateTime-Werten und DateTimeOffset- Werten in einem System in der Zeitzone Pacific Normalzeit verwendet wird.
|
m |
Stellt die Minute als Zahl von 0 bis 59 dar. Die Minute stellt die seit der letzten Stunde vergangenen ganzen Minuten dar. Einstellige Minuten werden ohne führende Null formatiert. Weitere Informationen zum Verwenden eines einzelnen Formatbezeichners finden Sie unter Verwenden von einzelnen benutzerdefinierten Formatbezeichnern. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner m in eine benutzerdefinierte Formatzeichenfolge ein.
|
mm, mm (plus einer beliebigen Anzahl zusätzlicher m-Bezeichner) |
Stellt die Minute als Zahl von 00 bis 59 dar. Die Minute stellt die seit der letzten Stunde vergangenen ganzen Minuten dar. Einstellige Minuten werden mit einer führenden Null formatiert. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner mm in eine benutzerdefinierte Formatzeichenfolge ein.
|
M |
Stellt den Monat als Zahl von 1 bis 12 dar. Einstellige Monate werden ohne führende Null formatiert. Weitere Informationen zum Verwenden eines einzelnen Formatbezeichners finden Sie unter Verwenden von einzelnen benutzerdefinierten Formatbezeichnern. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner M in eine benutzerdefinierte Formatzeichenfolge ein.
|
MM |
Stellt den Monat als Zahl von 01 bis 12 dar. Einstellige Monate werden mit einer führenden Null formatiert. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner MM in eine benutzerdefinierte Formatzeichenfolge ein.
|
MMM |
Stellt den in der aktuellen DateTimeFormatInfo.AbbreviatedMonthNames-Eigenschaft definierten abgekürzten Namen des Monats dar. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner MMM in eine benutzerdefinierte Formatzeichenfolge ein.
|
MMMM |
Stellt den in der aktuellen DateTimeFormatInfo.MonthNames-Eigenschaft definierten vollständigen Namen des Monats dar. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner MMMM in eine benutzerdefinierte Formatzeichenfolge ein.
|
s |
Stellt die Sekunden als Zahl von 0 bis 59 dar. Das Ergebnis stellt die seit der letzten Minute vergangenen ganzen Sekunden dar. Einstellige Sekunden werden ohne führende Null formatiert. Weitere Informationen zum Verwenden eines einzelnen Formatbezeichners finden Sie unter Verwenden von einzelnen benutzerdefinierten Formatbezeichnern. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner s in eine benutzerdefinierte Formatzeichenfolge ein.
|
ss, ss (plus einer beliebigen Anzahl zusätzlicher s-Bezeichner) |
Stellt die Sekunden als Zahl von 00 bis 59 dar. Das Ergebnis stellt die seit der letzten Minute vergangenen ganzen Sekunden dar. Einstellige Sekunden werden mit einer führenden Null formatiert. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner ss in eine benutzerdefinierte Formatzeichenfolge ein.
|
t |
Stellt das erste Zeichen des AM/PM-Bezeichners dar, der in der aktuellen DateTimeFormatInfo.AMDesignator-Eigenschaft oder DateTimeFormatInfo.PMDesignator-Eigenschaft definiert ist. Der AM-Bezeichner wird verwendet, wenn die Stunde in der Uhrzeit, die formatiert wird, kleiner als 12 ist. Andernfalls wird der PM-Bezeichner verwendet. Weitere Informationen zum Verwenden eines einzelnen Formatbezeichners finden Sie unter Verwenden von einzelnen benutzerdefinierten Formatbezeichnern. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner t in eine benutzerdefinierte Formatzeichenfolge ein.
|
tt, tt (plus einer beliebigen Anzahl zusätzlicher t-Bezeichner) |
Stellt den in der aktuellen DateTimeFormatInfo.AMDesignator-Eigenschaft oder DateTimeFormatInfo.PMDesignator-Eigenschaft definierten AM-/PM-Bezeichner dar. Der AM-Bezeichner wird verwendet, wenn die Stunde in der Uhrzeit, die formatiert wird, kleiner als 12 ist. Andernfalls wird der PM-Bezeichner verwendet. In der Anwendung sollte der Bezeichner tt für Sprachen verwendet werden, bei denen die Unterscheidung zwischen AM und PM beibehalten werden muss. Ein Beispiel hierfür ist die japanische Sprache, in der nicht das erste, sondern das zweite Zeichen des AM/PM-Bezeichners das Unterscheidungsmerkmal darstellt. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner tt in eine benutzerdefinierte Formatzeichenfolge ein.
|
y |
Stellt das Jahr als ein- oder zweistellige Zahl dar. Falls das Jahr mehr als zwei Ziffern umfasst, werden im Ergebnis nur die beiden niedrigwertigen Ziffern angezeigt. Wenn die erste Ziffer eines zweistelligen Jahrs eine Null ist (z. B. 2008), wird die Zahl ohne führende Null formatiert. Weitere Informationen zum Verwenden eines einzelnen Formatbezeichners finden Sie unter Verwenden von einzelnen benutzerdefinierten Formatbezeichnern. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner y in eine benutzerdefinierte Formatzeichenfolge ein.
|
yy |
Stellt das Jahr als zweistellige Zahl dar. Falls das Jahr mehr als zwei Ziffern umfasst, werden im Ergebnis nur die beiden niedrigwertigen Ziffern angezeigt. Umfasst das Jahr weniger als zwei signifikante Ziffern, wird die Zahl mit führenden Nullen auf eine zweistellige Jahresangabe aufgefüllt. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner yy in eine benutzerdefinierte Formatzeichenfolge ein.
|
yyy |
Stellt das Jahr mit einem Minimum von drei Ziffern dar. Falls das Jahr mehr als drei signifikante Ziffern umfasst, werden diese in die Ergebniszeichenfolge aufgenommen. Umfasst das Jahr weniger als drei Ziffern, wird die Zahl mit führenden Nullen auf eine dreistellige Jahresangabe aufgefüllt. Für den buddhistischen Kalender Thailands, der fünfstellige Jahresangaben enthalten kann, zeigt dieser Bezeichner alle fünf Ziffern an. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner yyy in eine benutzerdefinierte Formatzeichenfolge ein.
|
yyyy |
Stellt das Jahr als vierstellige Zahl dar. Falls das Jahr mehr als vier Ziffern umfasst, werden im Ergebnis nur die vier niedrigwertigen Ziffern angezeigt. Umfasst das Jahr weniger als vier Ziffern, wird die Zahl mit führenden Nullen auf eine vierstellige Jahresangabe aufgefüllt. Für den buddhistischen Kalender Thailands, der fünfstellige Jahresangaben enthalten kann, zeigt dieser Bezeichner alle fünf Ziffern an. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner yyyy in eine benutzerdefinierte Formatzeichenfolge ein.
|
yyyyy (plus einer beliebigen Anzahl zusätzlicher y-Bezeichner) |
Stellt das Jahr als fünfstellige Zahl dar. Falls das Jahr mehr als fünf Ziffern umfasst, werden im Ergebnis nur die fünf niedrigwertigen Ziffern angezeigt. Umfasst das Jahr weniger als fünf Ziffern, wird die Zahl mit führenden Nullen auf eine fünfstellige Jahresangabe aufgefüllt. Falls zusätzliche y-Bezeichner vorhanden sind, wird die Zahl mit der erforderlichen Anzahl an führenden Nullen auf die Anzahl der y-Bezeichner aufgefüllt. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner yyyyy in eine benutzerdefinierte Formatzeichenfolge ein.
|
z |
Mit DateTime-Werten, stellt den signierten Offset der Zeitzone des lokalen Betriebssystems von der koordinierten Weltzeit (Coordinated Universal Time, UTC) dar, gemessen in Stunden. Reflektiert nicht den Wert der Kind-Eigenschaft einer Instanz. Aus diesem Grund wird der z-Formatbezeichner nicht zur Verwendung mit DateTime-Werten empfohlen. Mit DateTimeOffset-Werten, stellt den Offset eines DateTimeOffset-Werts in Stunden von der UTC dar. Der Offset wird immer mit einem vorangestellten Plus- oder Minuszeichen angezeigt. Ein Pluszeichen (+) gibt die Stunden vor UTC, ein Minuszeichen (-) die Stunden nach UTC an. Der Offsetbereich liegt zwischen -12 und +13. Einstellige Offsets werden ohne führende Null formatiert. Weitere Informationen zum Verwenden eines einzelnen Formatbezeichners finden Sie unter Verwenden von einzelnen benutzerdefinierten Formatbezeichnern. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner z in eine benutzerdefinierte Formatzeichenfolge ein.
|
zz |
Mit DateTime-Werten, stellt den signierten Offset der Zeitzone des lokalen Betriebssystems von der koordinierten Weltzeit (Coordinated Universal Time, UTC) dar, gemessen in Stunden. Reflektiert nicht den Wert der Kind-Eigenschaft einer Instanz. Aus diesem Grund wird der zz-Formatbezeichner nicht zur Verwendung mit DateTime-Werten empfohlen. Mit DateTimeOffset-Werten, stellt den Offset eines DateTimeOffset-Werts in Stunden von der UTC dar. Der Offset wird immer mit einem vorangestellten Plus- oder Minuszeichen angezeigt. Ein Pluszeichen (+) gibt die Stunden vor UTC, ein Minuszeichen (-) die Stunden nach UTC an. Der Offset liegt im Bereich von -12 bis +13. Einstellige Offset-Werte werden mit einer führenden Null formatiert. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner zz in eine benutzerdefinierte Formatzeichenfolge ein.
|
zzz, zzz (plus einer beliebigen Anzahl zusätzlicher z-Bezeichner) |
Mit DateTime-Werten, stellt den signierten Offset der Zeitzone des lokalen Betriebssystems von der koordinierten Weltzeit (Coordinated Universal Time, UTC) dar, gemessen in Stunden und Minuten. Reflektiert nicht den Wert der Kind-Eigenschaft einer Instanz. Aus diesem Grund wird der zzz-Formatbezeichner nicht zur Verwendung mit DateTime-Werten empfohlen. Mit DateTimeOffset-Werten, stellt den Offset eines DateTimeOffset-Werts in Stunden und Minuten von der UTC dar. Der Offset wird immer mit einem vorangestellten Plus- oder Minuszeichen angezeigt. Ein Pluszeichen (+) gibt die Stunden vor UTC, ein Minuszeichen (-) die Stunden nach UTC an. Der Offset liegt im Bereich von –12 bis +13. Einstellige Offset-Werte werden mit einer führenden Null formatiert. Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner zzz in eine benutzerdefinierte Formatzeichenfolge ein.
|
: |
Stellt das in der aktuellen DateTimeFormatInfo.TimeSeparator-Eigenschaft definierte Trennzeichen für Zeitangaben dar. Dieses Trennzeichen wird verwendet, um Stunden, Minuten und Sekunden zu unterscheiden. |
/ |
Stellt das in der aktuellen DateTimeFormatInfo.DateSeparator-Eigenschaft definierte Trennzeichen für Datumsangaben dar. Dieses Trennzeichen wird verwendet, um Jahre, Monate und Tage zu unterscheiden. |
" |
Stellt eine zitierte Zeichenfolge (Anführungszeichen) dar. Zeigt den literalen Wert einer Zeichenfolge zwischen zwei Anführungszeichen (") an. Die Anwendung sollte jedem Anführungszeichen ein Escapezeichen (\) voranstellen. |
' |
Stellt eine zitierte Zeichenfolge (Apostroph) dar. Zeigt den literalen Wert einer Zeichenfolge zwischen zwei Apostrophzeichen (') an. |
%c |
Stellt das einem benutzerdefinierten c-Formatbezeichner zugeordnete Ergebnis dar, wenn die benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit nur aus diesem benutzerdefinierten Formatbezeichner besteht. Das heißt, wenn Sie den benutzerdefinierten Formatbezeichner "d", "f", "F", "h", "m", "s", "t", "y", "z", "H" oder "M" allein verwenden möchten, muss in der Anwendung "%d", "%f", "%F", "%h", "%m", "%s", "%t", "%y", "%z", "%H" oder "%M" angegeben werden. Weitere Informationen zum Verwenden eines einzelnen Formatbezeichners finden Sie unter Verwenden von einzelnen benutzerdefinierten Formatbezeichnern. |
\c |
Stellt das Escape-Zeichen dar und zeigt das c-Zeichen als Literal an, wenn ihm das Escapezeichen (\) vorangestellt wird. Um den umgekehrten Schrägstrich in die Ergebniszeichenfolge einzufügen, sollte die Anwendung zwei Escapezeichen ("\\") verwenden. |
Jedes andere Zeichen |
Kopiert jedes andere Zeichen in die Ergebniszeichenfolge, ohne die Formatierung zu beeinflussen. |
Einstellungen der Systemsteuerung
Die Einstellungen der Regions- und Sprachoptionen in der Systemsteuerung beeinflussen die durch einen Formatierungsvorgang erstellte Ergebniszeichenfolge, die viele der benutzerdefinierten Formatbezeichner für Datum und Uhrzeit enthält. Mithilfe dieser Einstellungen wird das DateTimeFormatInfo-Objekt initialisiert, das der aktuellen Threadkultur zugeordnet ist. Sie stellt Werte zur Steuerung der Formatierung bereit. Auf Computern mit unterschiedlichen Einstellungen werden unterschiedliche Ergebniszeichenfolgen generiert.
Wenn der CultureInfo.CultureInfo(String)-Constructor verwendet wird, um ein neues CultureInfo-Objekt zu instantiieren, das dieselbe Kultur repräsentiert wie die aktuelle Systemkultur, werden darüber hinaus alle Anpassungen, die über die Einstellung Regions- und Sprachoptionen in der Systemsteuerung eingerichtet werden, auf das neue CultureInfo-Objekt angewendet. Sie können die CreateSpecificCulture-Methode verwenden, um ein CultureInfo-Objekt zu erstellen, die die Anpassungen eines Systems nicht reflektiert.
DateTimeFormatInfo-Eigenschaften
Die Formatierung wird durch die Eigenschaften des aktuellen DateTimeFormatInfo-Objekts beeinflusst, das implizit durch die aktuelle Threadkultur oder explizit durch den IFormatProvider-Parameter der Methode bereitgestellt wird, die die Formatierung aufruft. Die Anwendung sollte für den IFormatProvider-Parameter ein CultureInfo-Objekt angeben, das eine Kultur oder ein DateTimeFormatInfo-Objekt darstellt.
Die von vielen der benutzerdefinierten Formatbezeichner für Datum und Uhrzeit erzeugte Ergebniszeichenfolge hängt von den Eigenschaften des aktuellen DateTimeFormatInfo-Objekts ab. Die Anwendung kann das von einigen Standardformatbezeichnern für Datum und Uhrzeit erstellte Ergebnis ändern, indem sie die entsprechende DateTimeFormatInfo-Eigenschaft ändert. So fügt beispielsweise der Formatbezeichner ddd der Ergebniszeichenfolge einen abkürzten Wochentagsnamen hinzu, der im AbbreviatedDayNames-Zeichenfolgen-Array gefunden wird. Entsprechend fügt der Formatbezeichner MMMM der Ergebniszeichenfolge einen vollständigen Monatsnamen hinzu, der im MonthNames-Zeichenfolgen-Array gefunden wird.
Verwenden von einzelnen benutzerdefinierten Formatbezeichnern
Eine benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit besteht aus zwei oder mehr Zeichen. Wenn die Formatzeichenfolge beispielsweise nur aus dem h-Bezeichner besteht, wird sie als Standardformatzeichenfolge für Datum und Uhrzeit interpretiert. In diesem speziellen Fall wird jedoch eine Ausnahme ausgelöst, weil kein Standardformatbezeichner h für Datum und Uhrzeitvorhanden ist.
Zur Verwendung eines einzelnen benutzerdefinierten Formatbezeichners für Datum und Uhrzeit fügen Sie vor oder nach dem Formatbezeichner für Datum und Uhrzeit ein Leerzeichen bzw. vor dem Bezeichner für Datum und Uhrzeit einen Prozentformatbezeichner (%) ein. Die Formatzeichenfolgen h und %h werden z. B. als benutzerdefinierte Formatzeichenfolgen für Datum und Uhrzeit interpretiert, mit denen die durch den aktuelle Wert von für Datum und Uhrzeit dargestellte Stunde angezeigt wird. Bei der Verwendung eines Leerzeichens wird dieses in der Ergebniszeichenfolge als Literalzeichen angezeigt.
Siehe auch
Konzepte
Datums- und Uhrzeitstandardformatzeichenfolgen