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	ShortDatePattern
D	LongDatePattern
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	MonthDayPattern
r, R	RFC1123Pattern
s	SortableDateTimePattern auf der Grundlage von ISO 8601 unter Verwendung der Ortszeit
t	ShortTimePattern
T	LongTimePattern
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	YearMonthPattern

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