DateTimeFormatInfo-Klasse
Definiert, wie DateTime-Werte je nach der jeweiligen Kultur formatiert und angezeigt werden.
Namespace: System.Globalization
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public NotInheritable Class DateTimeFormatInfo
Implements ICloneable, IFormatProvider
'Usage
Dim instance As DateTimeFormatInfo
[SerializableAttribute]
[ComVisibleAttribute(true)]
public sealed class DateTimeFormatInfo : ICloneable, IFormatProvider
[SerializableAttribute]
[ComVisibleAttribute(true)]
public ref class DateTimeFormatInfo sealed : ICloneable, IFormatProvider
/** @attribute SerializableAttribute() */
/** @attribute ComVisibleAttribute(true) */
public final class DateTimeFormatInfo implements ICloneable, IFormatProvider
SerializableAttribute
ComVisibleAttribute(true)
public final class DateTimeFormatInfo implements ICloneable, IFormatProvider
Hinweise
Diese Klasse enthält Informationen, z. B. Muster für Datums- und Uhrzeitangaben sowie AM/PM-Kennzeichner.
Zum Erstellen einer DateTimeFormatInfo für eine bestimmte Kultur erstellen Sie eine CultureInfo für diese Kultur, und rufen Sie die CultureInfo.DateTimeFormat-Eigenschaft ab. Zum Erstellen einer DateTimeFormatInfo für die Kultur des aktuellen Threads verwenden Sie die CurrentInfo-Eigenschaft. Zum Erstellen einer DateTimeFormatInfo-Klasse für die invariante Kultur verwenden Sie die InvariantInfo-Eigenschaft für eine schreibgeschützte Version oder den DateTimeFormatInfo-Konstruktor für eine schreibbare Version. Es kann keine DateTimeFormatInfo für eine neutrale Kultur erstellt werden.
In der Systemsteuerung können über Regionale und Spracheinstellungen (bzw. über Ländereinstellungen oder Gebietsschema) einige Werte überschrieben werden, die der aktuellen Kultur von Windows zugeordnet sind. Beispielsweise können Benutzer das Datum in einem anderen Format anzeigen lassen oder eine andere Währung als die Standardwährung dieser Kultur verwenden. Wenn die CultureInfo.UseUserOverride-Eigenschaft auf true festgelegt ist, werden auch die Eigenschaften der Instanzen CultureInfo.DateTimeFormat, CultureInfo.NumberFormat und CultureInfo.TextInfo aus den Benutzereinstellungen abgerufen. Wenn die Benutzereinstellungen nicht mit der Kultur kompatibel sind, die der CultureInfo zugeordnet ist, weil z. B. der ausgewählte Kalender keiner der OptionalCalendars ist, sind die Methodenergebnisse und Eigenschaftenwerte undefiniert.
DateTime-Werte werden mithilfe von Standard- oder benutzerdefinierten Mustern formatiert, die in den Eigenschaften einer DateTimeFormatInfo gespeichert sind.
Die Standardmuster können durch benutzerdefinierte Muster ersetzt werden, indem die zugeordneten Eigenschaften einer schreibbaren DateTimeFormatInfo festgelegt werden. Mithilfe der IsReadOnly-Eigenschaft können Sie feststellen, ob eine DateTimeFormatInfo schreibbar ist.
In der folgenden Tabelle sind die Standardformatzeichen für die einzelnen Standardmuster mit der jeweils zugeordneten DateTimeFormatInfo-Eigenschaft aufgeführt, die zum Ändern des Standardmusters festgelegt werden kann. Bei den Formatzeichen wird zwischen Groß- und Kleinschreibung unterschieden, "g" und "G" stellen beispielsweise unterschiedliche Muster dar.
Formatzeichen |
Zugeordnete Eigenschaft/Beschreibung |
|---|---|
d |
|
D |
|
f |
Vollständiges Datum und Uhrzeit (langes Datumsformat und 24-Stunden-Zeitformat) |
F |
FullDateTimePattern (langes Datumsformat und langes Zeitformat) |
g |
Allgemein (kurzes Datumsformat und 24-Stunden-Zeitformat) |
G |
Allgemein (kurzes Datumsformat und langes Zeitformat) |
m, M |
|
r, R |
|
s |
SortableDateTimePattern auf der Grundlage von ISO 8601 unter Verwendung der Ortszeit |
t |
|
T |
|
u |
UniversalSortableDateTimePattern unter Verwendung des Formats zur Anzeige der koordinierten Weltzeit |
U |
Vollständiges Datum und Uhrzeit (langes Datumsformat und langes Zeitformat) unter Verwendung der koordinierten Weltzeit |
y, Y |
In der folgenden Tabelle sind die Muster aufgeführt, die zum Erstellen von benutzerdefinierten Mustern miteinander kombiniert werden können. Bei den Mustern wird die Groß- und Kleinschreibung berücksichtigt. So wird "MM" z. B. erkannt, "mm" jedoch nicht. Wenn das benutzerdefinierte Muster Leerzeichen oder in einfache Anführungszeichen eingeschlossene Zeichen enthält, enthält die Ausgabezeichenfolge diese Zeichen ebenfalls. Zeichen, die nicht als Teil eines Formatmusters oder als Formatzeichen definiert sind, werden als Literale wiedergegeben.
Formatmuster |
Beschreibung |
|---|---|
d, %d |
Der Tag des Monats. Einstellige Tagesangaben weisen keine führende Null auf. Geben Sie "%d" an, wenn das Formatmuster nicht mit anderen Formatmustern kombiniert ist. |
dd |
Der Tag des Monats. Einstellige Tagesangaben weisen eine führende Null auf. |
ddd |
Der abgekürzte Name des Wochentags entsprechend der Definition unter AbbreviatedDayNames. |
dddd |
Der vollständige Name des Wochentags entsprechend der Definition unter DayNames. |
M, %M |
Der numerisch ausgedrückte Monat. Einstellige Monatsangaben weisen keine führende Null auf. Geben Sie "%M" an, wenn das Formatmuster nicht mit anderen Formatmustern kombiniert ist. |
MM |
Der numerisch ausgedrückte Monat. Einstellige Monatsangaben weisen eine führende Null auf. |
MMM |
Der abgekürzte Monatsname entsprechend der Definition unter AbbreviatedMonthNames. |
MMMM |
Der vollständige Monatsname entsprechend der Definition unter MonthNames. |
y, %y |
Die Jahreszahl ohne Angabe des Jahrhunderts. Wenn die Jahreszahl ohne Angabe des Jahrhunderts kleiner als zehn ist, wird sie ohne führende Null angezeigt. Geben Sie "%y" an, wenn das Formatmuster nicht mit anderen Formatmustern kombiniert ist. |
yy |
Die Jahreszahl ohne Angabe des Jahrhunderts. Wenn die Jahreszahl ohne Angabe des Jahrhunderts kleiner als zehn ist, wird sie mit führender Null angezeigt. |
yyyy |
Die vierstellige Jahreszahl einschließlich der Angabe des Jahrhunderts. |
gg |
Der Zeitraum. Wenn das zu formatierende Datum keine zugeordnete Zeichenfolge für den Zeitraum enthält, wird dieses Muster ignoriert. |
h, %h |
Die Stunde in 12-Stunden-Schreibweise. Einstellige Stundenangaben weisen keine führende Null auf. Geben Sie "%h" an, wenn das Formatmuster nicht mit anderen Formatmustern kombiniert ist. |
hh |
Die Stunde in 12-Stunden-Schreibweise. Einstellige Stundenangaben weisen eine führende Null auf. |
H, %H |
Die Stunde in 24-Stunden-Schreibweise. Einstellige Stundenangaben weisen keine führende Null auf. Geben Sie "%H" an, wenn das Formatmuster nicht mit anderen Formatmustern kombiniert ist. |
HH |
Die Stunde in 24-Stunden-Schreibweise. Einstellige Stundenangaben weisen eine führende Null auf. |
m, %m |
Die Minute. Einstellige Minutenangaben weisen keine führende Null auf. Geben Sie "%m" an, wenn das Formatmuster nicht mit anderen Formatmustern kombiniert ist. |
mm |
Die Minute. Einstellige Minutenangaben weisen eine führende Null auf. |
s, %s |
Die Sekunde. Einstellige Sekundenangaben weisen keine führende Null auf. Geben Sie "%s" an, wenn das Formatmuster nicht mit anderen Formatmustern kombiniert ist. |
ss |
Die Sekunde. Einstellige Sekundenangaben weisen eine führende Null auf. |
f, %f |
Der Sekundenbruchteil auf eine Stelle genau. Die verbleibenden Ziffern werden abgeschnitten. Geben Sie "%f" an, wenn das Formatmuster nicht mit anderen Formatmustern kombiniert ist. |
ff |
Der Sekundenbruchteil auf zwei Stellen genau. Die verbleibenden Ziffern werden abgeschnitten. |
fff |
Der Sekundenbruchteil auf drei Stellen genau. Die verbleibenden Ziffern werden abgeschnitten. |
ffff |
Der Sekundenbruchteil auf vier Stellen genau. Die verbleibenden Ziffern werden abgeschnitten. |
fffff |
Der Sekundenbruchteil auf fünf Stellen genau. Die verbleibenden Ziffern werden abgeschnitten. |
ffffff |
Der Sekundenbruchteil auf sechs Stellen genau. Die verbleibenden Ziffern werden abgeschnitten. |
fffffff |
Der Sekundenbruchteil auf sieben Stellen genau. Die verbleibenden Ziffern werden abgeschnitten. |
F, %F |
Zeigt die höchstwertige Stelle der zweiten Bruchzahl an. Wenn die Stelle 0 (null) ist, wird nichts angezeigt. Geben Sie "%F" an, wenn das Formatmuster nicht mit anderen Formatmustern kombiniert ist. |
FF |
Zeigt die zwei höchstwertigen Stellen der zweiten Bruchzahl an. Eine führende Null (0) oder zwei Nullstellen werden jedoch nicht angezeigt. |
FFF |
Zeigt die drei höchstwertigen Stellen der zweiten Bruchzahl an. Führende Nullen (0) oder drei Nullstellen werden jedoch nicht angezeigt. |
FFFF |
Zeigt die vier höchstwertigen Stellen der zweiten Bruchzahl an. Führende Nullen (0) oder vier Nullstellen werden jedoch nicht angezeigt. |
FFFFF |
Zeigt die fünf höchstwertigen Stellen der zweiten Bruchzahl an. Führende Nullen (0) oder fünf Nullstellen werden jedoch nicht angezeigt. |
FFFFFF |
Zeigt die sechs höchstwertigen Stellen der zweiten Bruchzahl an. Führende Nullen (0) oder sechs Nullstellen werden jedoch nicht angezeigt. |
FFFFFFF |
Zeigt die sieben höchstwertigen Stellen der zweiten Bruchzahl an. Führende Nullen (0) oder sieben Nullstellen werden jedoch nicht angezeigt. |
t, %t |
Das erste Zeichen des AM/PM-Kennzeichners, der gegebenenfalls im AMDesignator oder im PMDesignator definiert ist. Geben Sie "%t" an, wenn das Formatmuster nicht mit anderen Formatmustern kombiniert ist. |
tt |
Der AM/PM-Kennzeichner, der gegebenenfalls im AMDesignator oder im PMDesignator definiert ist. |
z, %z |
Der Zeitzonenoffset ("+" oder "-", dem die Stundenangabe folgt). Einstellige Stundenangaben weisen keine führende Null auf. Pacific Standard Time z. B. ist "-8". Geben Sie "%z" an, wenn das Formatmuster nicht mit anderen Formatmustern kombiniert ist. |
zz |
Der Zeitzonenoffset ("+" oder "-", dem die Stundenangabe folgt). Einstellige Stundenangaben weisen eine führende Null auf. Pacific Standard Time z. B. ist "-08". |
zzz |
Der vollständige Zeitzonenoffset ("+" oder "-", dem die Stunden- und Minutenangabe folgen). Einstellige Stunden- und Minutenangaben weisen jeweils eine führende 0 (null) auf. Pacific Standard Time z. B. ist "-08:00". |
: |
Das im TimeSeparator definierte Standardtrennzeichen für Zeitangaben. |
/ |
Das im DateSeparator definierte Standardtrennzeichen für Zeitangaben. |
% c |
Dabei ist c ein Formatmuster, wenn es alleine verwendet wird. Das heißt, um die folgenden Formatmuster zu verwenden: "d", "f", "F", "h", "m", "s", "t", "y", "z", "H" oder "M", müssen Sie "%d", "%f", "%F", "%h", "%m", "%s", "%t", "%y", "%z", "%H" oder "%M" angeben. Wenn das Formatmuster mit Literalzeichen oder anderen Formatmustern kombiniert wird, kann das "%"-Zeichen weggelassen werden. |
\ c |
Dabei stellt c ein beliebiges Zeichen dar. Zeigt das Zeichen als Literalwert an. Verwenden Sie "\\", um einen umgekehrten Schrägstrich anzuzeigen. |
Nur Formatmuster, die oben in der zweiten Tabelle aufgeführt sind, können zum Erstellen von benutzerdefinierten Mustern verwendet werden. Standardformatzeichen, die in der ersten Tabelle aufgeführt sind, können nicht zum Erstellen von benutzerdefinierten Mustern verwendet werden. Benutzerdefinierte Muster sind mindestens zwei Zeichen lang, wie die folgenden Beispiele zeigen:
DateTime.ToString( "d" ) gibt den DateTime-Wert zurück, wobei "d" das Standardmuster für das kurze Datumsformat darstellt.
DateTime.ToString( "%d" ) gibt den Tag des Monats zurück, wobei "%d" ein benutzerdefiniertes Muster darstellt.
DateTime.ToString("d ") gibt den Tag des Monats und ein Leerzeichen zurück, wobei "d " ein benutzerdefiniertes Muster darstellt.
Eine DateTimeFormatInfo oder eine NumberFormatInfo kann nicht für neutrale Kulturen, sondern nur für die invariante Kultur oder für spezifische Kulturen erstellt werden. Weitere Informationen zur invarianten Kultur, spezifischen Kulturen und neutralen Kulturen finden Sie in der CultureInfo-Klasse.
Diese Klasse implementiert die ICloneable-Schnittstelle, um die Duplizierung von DateTimeFormatInfo-Objekten zu ermöglichen. Sie implementiert auch den IFormatProvider, um Anwendungen Formatierungsinformationen zur Verfügung zu stellen.
Beispiel
Im folgenden Codebeispiel werden die verschiedenen Formatmuster für die Kultur en-US unter Verwendung der Formatzeichen ausgegeben. Weiterhin wird der Wert der dem Formatzeichen zugeordneten Eigenschaften angezeigt.
Imports System
Imports System.Globalization
Imports Microsoft.VisualBasic
Public Class SamplesDTFI
Public Shared Sub Main()
' Creates and initializes a DateTimeFormatInfo associated with the en-US culture.
Dim myDTFI As DateTimeFormatInfo = New CultureInfo("en-US", False).DateTimeFormat
' Creates a DateTime with the Gregorian date January 3, 2002 (year=2002, month=1, day=3).
' The Gregorian calendar is the default calendar for the en-US culture.
Dim myDT As New DateTime(2002, 1, 3)
' Displays the format pattern associated with each format character.
Console.WriteLine("FORMAT en-US EXAMPLE")
Console.WriteLine("CHAR VALUE OF ASSOCIATED PROPERTY, IF ANY")
Console.WriteLine()
Console.WriteLine(" d {0}", myDT.ToString("d"))
Console.WriteLine(" {0} {1}", myDTFI.ShortDatePattern, "(ShortDatePattern)")
Console.WriteLine()
Console.WriteLine(" D {0}", myDT.ToString("D"))
Console.WriteLine(" {0} {1}", myDTFI.LongDatePattern, "(LongDatePattern)")
Console.WriteLine()
Console.WriteLine(" f {0}", myDT.ToString("f"))
Console.WriteLine()
Console.WriteLine(" F {0}", myDT.ToString("F"))
Console.WriteLine(" {0} {1}", myDTFI.FullDateTimePattern, "(FullDateTimePattern)")
Console.WriteLine()
Console.WriteLine(" g {0}", myDT.ToString("g"))
Console.WriteLine()
Console.WriteLine(" G {0}", myDT.ToString("G"))
Console.WriteLine()
Console.WriteLine(" m {0}", myDT.ToString("m"))
Console.WriteLine(" {0} {1}", myDTFI.MonthDayPattern, "(MonthDayPattern)")
Console.WriteLine()
Console.WriteLine(" M {0}", myDT.ToString("M"))
Console.WriteLine(" {0} {1}", myDTFI.MonthDayPattern, "(MonthDayPattern)")
Console.WriteLine()
Console.WriteLine(" r {0}", myDT.ToString("r"))
Console.WriteLine(" {0} {1}", myDTFI.RFC1123Pattern, "(RFC1123Pattern)")
Console.WriteLine()
Console.WriteLine(" R {0}", myDT.ToString("R"))
Console.WriteLine(" {0} {1}", myDTFI.RFC1123Pattern, "(RFC1123Pattern)")
Console.WriteLine()
Console.WriteLine(" s {0}", myDT.ToString("s"))
Console.WriteLine(" {0} {1}", myDTFI.SortableDateTimePattern, "(SortableDateTimePattern)")
Console.WriteLine()
Console.WriteLine(" t {0}", myDT.ToString("t"))
Console.WriteLine(" {0} {1}", myDTFI.ShortTimePattern, "(ShortTimePattern)")
Console.WriteLine()
Console.WriteLine(" T {0}", myDT.ToString("T"))
Console.WriteLine(" {0} {1}", myDTFI.LongTimePattern, "(LongTimePattern)")
Console.WriteLine()
Console.WriteLine(" u {0}", myDT.ToString("u"))
Console.WriteLine(" {0} {1}", myDTFI.UniversalSortableDateTimePattern, "(UniversalSortableDateTimePattern)")
Console.WriteLine()
Console.WriteLine(" U {0}", myDT.ToString("U"))
Console.WriteLine()
Console.WriteLine(" y {0}", myDT.ToString("y"))
Console.WriteLine(" {0} {1}", myDTFI.YearMonthPattern, "(YearMonthPattern)")
Console.WriteLine()
Console.WriteLine(" Y {0}", myDT.ToString("Y"))
Console.WriteLine(" {0} {1}", myDTFI.YearMonthPattern, "(YearMonthPattern)")
End Sub 'Main
End Class 'SamplesDTFI
'This code produces the following output.
'
'FORMAT en-US EXAMPLE
'CHAR VALUE OF ASSOCIATED PROPERTY, IF ANY
'
' d 1/3/2002
' M/d/yyyy (ShortDatePattern)
'
' D Thursday, January 03, 2002
' dddd, MMMM dd, yyyy (LongDatePattern)
'
' f Thursday, January 03, 2002 12:00 AM
'
' F Thursday, January 03, 2002 12:00:00 AM
' dddd, MMMM dd, yyyy h:mm:ss tt (FullDateTimePattern)
'
' g 1/3/2002 12:00 AM
'
' G 1/3/2002 12:00:00 AM
'
' m January 03
' MMMM dd (MonthDayPattern)
'
' M January 03
' MMMM dd (MonthDayPattern)
'
' r Thu, 03 Jan 2002 00:00:00 GMT
' ddd, dd MMM yyyy HH':'mm':'ss 'GMT' (RFC1123Pattern)
'
' R Thu, 03 Jan 2002 00:00:00 GMT
' ddd, dd MMM yyyy HH':'mm':'ss 'GMT' (RFC1123Pattern)
'
' s 2002-01-03T00:00:00
' yyyy'-'MM'-'dd'T'HH':'mm':'ss (SortableDateTimePattern)
'
' t 12:00 AM
' h:mm tt (ShortTimePattern)
'
' T 12:00:00 AM
' h:mm:ss tt (LongTimePattern)
'
' u 2002-01-03 00:00:00Z
' yyyy'-'MM'-'dd HH':'mm':'ss'Z' (UniversalSortableDateTimePattern)
'
' U Thursday, January 03, 2002 8:00:00 AM
'
' y January, 2002
' MMMM, yyyy (YearMonthPattern)
'
' Y January, 2002
' MMMM, yyyy (YearMonthPattern)
'
using System;
using System.Globalization;
public class SamplesDTFI {
public static void Main() {
// Creates and initializes a DateTimeFormatInfo associated with the en-US culture.
DateTimeFormatInfo myDTFI = new CultureInfo( "en-US", false ).DateTimeFormat;
// Creates a DateTime with the Gregorian date January 3, 2002 (year=2002, month=1, day=3).
// The Gregorian calendar is the default calendar for the en-US culture.
DateTime myDT = new DateTime( 2002, 1, 3 );
// Displays the format pattern associated with each format character.
Console.WriteLine( "FORMAT en-US EXAMPLE" );
Console.WriteLine( "CHAR VALUE OF ASSOCIATED PROPERTY, IF ANY\n" );
Console.WriteLine( " d {0}", myDT.ToString("d") );
Console.WriteLine( " {0} {1}\n", myDTFI.ShortDatePattern, "(ShortDatePattern)" );
Console.WriteLine( " D {0}", myDT.ToString("D") );
Console.WriteLine( " {0} {1}\n", myDTFI.LongDatePattern, "(LongDatePattern)" );
Console.WriteLine( " f {0}\n", myDT.ToString("f") );
Console.WriteLine( " F {0}", myDT.ToString("F") );
Console.WriteLine( " {0} {1}\n", myDTFI.FullDateTimePattern, "(FullDateTimePattern)" );
Console.WriteLine( " g {0}\n", myDT.ToString("g") );
Console.WriteLine( " G {0}\n", myDT.ToString("G") );
Console.WriteLine( " m {0}", myDT.ToString("m") );
Console.WriteLine( " {0} {1}\n", myDTFI.MonthDayPattern, "(MonthDayPattern)" );
Console.WriteLine( " M {0}", myDT.ToString("M") );
Console.WriteLine( " {0} {1}\n", myDTFI.MonthDayPattern, "(MonthDayPattern)" );
Console.WriteLine( " r {0}", myDT.ToString("r") );
Console.WriteLine( " {0} {1}\n", myDTFI.RFC1123Pattern, "(RFC1123Pattern)" );
Console.WriteLine( " R {0}", myDT.ToString("R") );
Console.WriteLine( " {0} {1}\n", myDTFI.RFC1123Pattern, "(RFC1123Pattern)" );
Console.WriteLine( " s {0}", myDT.ToString("s") );
Console.WriteLine( " {0} {1}\n", myDTFI.SortableDateTimePattern, "(SortableDateTimePattern)" );
Console.WriteLine( " t {0}", myDT.ToString("t") );
Console.WriteLine( " {0} {1}\n", myDTFI.ShortTimePattern, "(ShortTimePattern)" );
Console.WriteLine( " T {0}", myDT.ToString("T") );
Console.WriteLine( " {0} {1}\n", myDTFI.LongTimePattern, "(LongTimePattern)" );
Console.WriteLine( " u {0}", myDT.ToString("u") );
Console.WriteLine( " {0} {1}\n", myDTFI.UniversalSortableDateTimePattern, "(UniversalSortableDateTimePattern)" );
Console.WriteLine( " U {0}\n", myDT.ToString("U") );
Console.WriteLine( " y {0}", myDT.ToString("y") );
Console.WriteLine( " {0} {1}\n", myDTFI.YearMonthPattern, "(YearMonthPattern)" );
Console.WriteLine( " Y {0}", myDT.ToString("Y") );
Console.WriteLine( " {0} {1}\n", myDTFI.YearMonthPattern, "(YearMonthPattern)" );
}
}
/*
This code produces the following output.
FORMAT en-US EXAMPLE
CHAR VALUE OF ASSOCIATED PROPERTY, IF ANY
d 1/3/2002
M/d/yyyy (ShortDatePattern)
D Thursday, January 03, 2002
dddd, MMMM dd, yyyy (LongDatePattern)
f Thursday, January 03, 2002 12:00 AM
F Thursday, January 03, 2002 12:00:00 AM
dddd, MMMM dd, yyyy h:mm:ss tt (FullDateTimePattern)
g 1/3/2002 12:00 AM
G 1/3/2002 12:00:00 AM
m January 03
MMMM dd (MonthDayPattern)
M January 03
MMMM dd (MonthDayPattern)
r Thu, 03 Jan 2002 00:00:00 GMT
ddd, dd MMM yyyy HH':'mm':'ss 'GMT' (RFC1123Pattern)
R Thu, 03 Jan 2002 00:00:00 GMT
ddd, dd MMM yyyy HH':'mm':'ss 'GMT' (RFC1123Pattern)
s 2002-01-03T00:00:00
yyyy'-'MM'-'dd'T'HH':'mm':'ss (SortableDateTimePattern)
t 12:00 AM
h:mm tt (ShortTimePattern)
T 12:00:00 AM
h:mm:ss tt (LongTimePattern)
u 2002-01-03 00:00:00Z
yyyy'-'MM'-'dd HH':'mm':'ss'Z' (UniversalSortableDateTimePattern)
U Thursday, January 03, 2002 8:00:00 AM
y January, 2002
MMMM, yyyy (YearMonthPattern)
Y January, 2002
MMMM, yyyy (YearMonthPattern)
*/
using namespace System;
using namespace System::Globalization;
int main()
{
// Creates and initializes a DateTimeFormatInfo associated with the en-US culture.
CultureInfo^ MyCI = gcnew CultureInfo( "en-US",false );
DateTimeFormatInfo^ myDTFI = MyCI->DateTimeFormat;
// Creates a DateTime with the Gregorian date January 3, 2002 (year=2002, month=1, day=3).
// The Gregorian calendar is the default calendar for the en-US culture.
DateTime myDT = DateTime(2002,1,3);
// Displays the format pattern associated with each format character.
Console::WriteLine( "FORMAT en-US EXAMPLE" );
Console::WriteLine( "CHAR VALUE OF ASSOCIATED PROPERTY, IF ANY\n" );
Console::WriteLine( " d {0}", myDT.ToString( "d" ) );
Console::WriteLine( " {0} {1}\n", myDTFI->ShortDatePattern, "(ShortDatePattern)" );
Console::WriteLine( " D {0}", myDT.ToString( "D" ) );
Console::WriteLine( " {0} {1}\n", myDTFI->LongDatePattern, "(LongDatePattern)" );
Console::WriteLine( " f {0}\n", myDT.ToString( "f" ) );
Console::WriteLine( " F {0}", myDT.ToString( "F" ) );
Console::WriteLine( " {0} {1}\n", myDTFI->FullDateTimePattern, "(FullDateTimePattern)" );
Console::WriteLine( " g {0}\n", myDT.ToString( "g" ) );
Console::WriteLine( " G {0}\n", myDT.ToString( "G" ) );
Console::WriteLine( " m {0}", myDT.ToString( "m" ) );
Console::WriteLine( " {0} {1}\n", myDTFI->MonthDayPattern, "(MonthDayPattern)" );
Console::WriteLine( " M {0}", myDT.ToString( "M" ) );
Console::WriteLine( " {0} {1}\n", myDTFI->MonthDayPattern, "(MonthDayPattern)" );
Console::WriteLine( " r {0}", myDT.ToString( "r" ) );
Console::WriteLine( " {0} {1}\n", myDTFI->RFC1123Pattern, "(RFC1123Pattern)" );
Console::WriteLine( " R {0}", myDT.ToString( "R" ) );
Console::WriteLine( " {0} {1}\n", myDTFI->RFC1123Pattern, "(RFC1123Pattern)" );
Console::WriteLine( " s {0}", myDT.ToString( "s" ) );
Console::WriteLine( " {0} {1}\n", myDTFI->SortableDateTimePattern, "(SortableDateTimePattern)" );
Console::WriteLine( " t {0}", myDT.ToString( "t" ) );
Console::WriteLine( " {0} {1}\n", myDTFI->ShortTimePattern, "(ShortTimePattern)" );
Console::WriteLine( " T {0}", myDT.ToString( "T" ) );
Console::WriteLine( " {0} {1}\n", myDTFI->LongTimePattern, "(LongTimePattern)" );
Console::WriteLine( " u {0}", myDT.ToString( "u" ) );
Console::WriteLine( " {0} {1}\n", myDTFI->UniversalSortableDateTimePattern, "(UniversalSortableDateTimePattern)" );
Console::WriteLine( " U {0}\n", myDT.ToString( "U" ) );
Console::WriteLine( " y {0}", myDT.ToString( "y" ) );
Console::WriteLine( " {0} {1}\n", myDTFI->YearMonthPattern, "(YearMonthPattern)" );
Console::WriteLine( " Y {0}", myDT.ToString( "Y" ) );
Console::WriteLine( " {0} {1}\n", myDTFI->YearMonthPattern, "(YearMonthPattern)" );
}
/*
This code produces the following output.
FORMAT en-US EXAMPLE
CHAR VALUE OF ASSOCIATED PROPERTY, IF ANY
d 1/3/2002
M/d/yyyy (ShortDatePattern)
D Thursday, January 03, 2002
dddd, MMMM dd, yyyy (LongDatePattern)
f Thursday, January 03, 2002 12:00 AM
F Thursday, January 03, 2002 12:00:00 AM
dddd, MMMM dd, yyyy h:mm:ss tt (FullDateTimePattern)
g 1/3/2002 12:00 AM
G 1/3/2002 12:00:00 AM
m January 03
MMMM dd (MonthDayPattern)
M January 03
MMMM dd (MonthDayPattern)
r Thu, 03 Jan 2002 00:00:00 GMT
ddd, dd MMM yyyy HH':'mm':'ss 'GMT' (RFC1123Pattern)
R Thu, 03 Jan 2002 00:00:00 GMT
ddd, dd MMM yyyy HH':'mm':'ss 'GMT' (RFC1123Pattern)
s 2002-01-03T00:00:00
yyyy'-'MM'-'dd'T'HH':'mm':'ss (SortableDateTimePattern)
t 12:00 AM
h:mm tt (ShortTimePattern)
T 12:00:00 AM
h:mm:ss tt (LongTimePattern)
u 2002-01-03 00:00:00Z
yyyy'-'MM'-'dd HH':'mm':'ss'Z' (UniversalSortableDateTimePattern)
U Thursday, January 03, 2002 8:00:00 AM
y January, 2002
MMMM, yyyy (YearMonthPattern)
Y January, 2002
MMMM, yyyy (YearMonthPattern)
*/
import System.* ;
import System.Globalization.* ;
public class SamplesDTFI
{
public static void main(String[] args)
{
// Creates and initializes a DateTimeFormatInfo associated with
// the en-US culture.
DateTimeFormatInfo myDTFI =
(new CultureInfo("en-US", false)).get_DateTimeFormat();
// Creates a DateTime with the Gregorian date January 3, 2002
// (year=2002, month=1, day=3).
// The Gregorian calendar is the default calendar for the
// en-US culture.
DateTime myDT = new DateTime(2002, 1, 3);
// Displays the format pattern associated with each format character.
Console.WriteLine("FORMAT en-US EXAMPLE");
Console.WriteLine("CHAR VALUE OF ASSOCIATED PROPERTY, IF ANY\n");
Console.WriteLine(" d {0}", myDT.ToString("d"));
Console.WriteLine(" {0} {1}\n", myDTFI.get_ShortDatePattern(),
"(ShortDatePattern)");
Console.WriteLine(" D {0}", myDT.ToString("D"));
Console.WriteLine(" {0} {1}\n", myDTFI.get_LongDatePattern(),
"(LongDatePattern)");
Console.WriteLine(" f {0}\n", myDT.ToString("f"));
Console.WriteLine(" F {0}", myDT.ToString("F"));
Console.WriteLine(" {0} {1}\n", myDTFI.get_FullDateTimePattern(),
"(FullDateTimePattern)");
Console.WriteLine(" g {0}\n", myDT.ToString("g"));
Console.WriteLine(" G {0}\n", myDT.ToString("G"));
Console.WriteLine(" m {0}", myDT.ToString("m"));
Console.WriteLine(" {0} {1}\n", myDTFI.get_MonthDayPattern(),
"(MonthDayPattern)");
Console.WriteLine(" M {0}", myDT.ToString("M"));
Console.WriteLine(" {0} {1}\n", myDTFI.get_MonthDayPattern(),
"(MonthDayPattern)");
Console.WriteLine(" r {0}", myDT.ToString("r"));
Console.WriteLine(" {0} {1}\n", myDTFI.get_RFC1123Pattern(),
"(RFC1123Pattern)");
Console.WriteLine(" R {0}", myDT.ToString("R"));
Console.WriteLine(" {0} {1}\n", myDTFI.get_RFC1123Pattern(),
"(RFC1123Pattern)");
Console.WriteLine(" s {0}", myDT.ToString("s"));
Console.WriteLine(" {0} {1}\n",
myDTFI.get_SortableDateTimePattern(), "(SortableDateTimePattern)");
Console.WriteLine(" t {0}", myDT.ToString("t"));
Console.WriteLine(" {0} {1}\n", myDTFI.get_ShortTimePattern(),
"(ShortTimePattern)");
Console.WriteLine(" T {0}", myDT.ToString("T"));
Console.WriteLine(" {0} {1}\n", myDTFI.get_LongTimePattern(),
"(LongTimePattern)");
Console.WriteLine(" u {0}", myDT.ToString("u"));
Console.WriteLine(" {0} {1}\n",
myDTFI.get_UniversalSortableDateTimePattern(),
"(UniversalSortableDateTimePattern)");
Console.WriteLine(" U {0}\n", myDT.ToString("U"));
Console.WriteLine(" y {0}", myDT.ToString("y"));
Console.WriteLine(" {0} {1}\n", myDTFI.get_YearMonthPattern(),
"(YearMonthPattern)");
Console.WriteLine(" Y {0}", myDT.ToString("Y"));
Console.WriteLine(" {0} {1}\n", myDTFI.get_YearMonthPattern(),
"(YearMonthPattern)");
} //main
} //SamplesDTFI
/*
This code produces the following output.
FORMAT en-US EXAMPLE
CHAR VALUE OF ASSOCIATED PROPERTY, IF ANY
d 1/3/2002
M/d/yyyy (ShortDatePattern)
D Thursday, January 03, 2002
dddd, MMMM dd, yyyy (LongDatePattern)
f Thursday, January 03, 2002 12:00 AM
F Thursday, January 03, 2002 12:00:00 AM
dddd, MMMM dd, yyyy h:mm:ss tt (FullDateTimePattern)
g 1/3/2002 12:00 AM
G 1/3/2002 12:00:00 AM
m January 03
MMMM dd (MonthDayPattern)
M January 03
MMMM dd (MonthDayPattern)
r Thu, 03 Jan 2002 00:00:00 GMT
ddd, dd MMM yyyy HH':'mm':'ss 'GMT' (RFC1123Pattern)
R Thu, 03 Jan 2002 00:00:00 GMT
ddd, dd MMM yyyy HH':'mm':'ss 'GMT' (RFC1123Pattern)
s 2002-01-03T00:00:00
yyyy'-'MM'-'dd'T'HH':'mm':'ss (SortableDateTimePattern)
t 12:00 AM
h:mm tt (ShortTimePattern)
T 12:00:00 AM
h:mm:ss tt (LongTimePattern)
u 2002-01-03 00:00:00Z
yyyy'-'MM'-'dd HH':'mm':'ss'Z' (UniversalSortableDateTimePattern)
U Thursday, January 03, 2002 8:00:00 AM
y January, 2002
MMMM, yyyy (YearMonthPattern)
Y January, 2002
MMMM, yyyy (YearMonthPattern)
*/
Vererbungshierarchie
System.Object
System.Globalization.DateTimeFormatInfo
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
DateTimeFormatInfo-Member
System.Globalization-Namespace
DateTime
Calendar-Klasse
CultureInfo-Klasse
Weitere Ressourcen
Formatierung von Typen
Übersicht über Formatierung
DateTime-Standardformatzeichenfolgen
Benutzerdefinierte DateTime-Formatzeichenfolgen