Standardformatzeichenfolgen für Datum und Uhrzeit

Artikel
06/05/2023

Eine standardmäßige Formatzeichenfolge für Datum und Uhrzeit verwendet einen einzelnen Formatbezeichner, um die Textdarstellung eines DateTime- oder DateTimeOffset-Werts zu definieren. Jede Formatzeichenfolge für Datum und Uhrzeit, die mehr als ein Zeichen (einschließlich Leerzeichen) enthält, wird als benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit interpretiert. Eine standardmäßige oder benutzerdefinierte Formatzeichenfolge kann auf zwei Arten verwendet werden:

Zum Definieren der Zeichenfolge, die das Ergebnis eines Formatierungsvorgangs ist.
Zum Definieren der Textdarstellung eines Datums- und Uhrzeitwerts, der bei einem Analysevorgang in einen DateTime-Wert oder in einen DateTimeOffset-Wert konvertiert werden kann.

Tipp

Sie können das Hilfsprogramm zur Formatierung herunterladen. Dabei handelt sich um eine Windows Forms-Anwendung für .NET, mit der Sie Formatzeichenfolgen auf numerische Werte oder Datums- und Uhrzeitwerte anwenden und die Ergebniszeichenfolge anzeigen können. Für C# und Visual Basic ist Quellcode verfügbar.

Hinweis

Einige der C#-Beispiele in diesem Artikel werden in der Inlinecodeausführung und dem Playground von Try.NET ausgeführt. Klicken Sie auf die Schaltfläche Ausführen, um ein Beispiel in einem interaktiven Fenster auszuführen. Nachdem Sie den Code ausgeführt haben, können Sie ihn ändern und den geänderten Code durch erneutes Anklicken der Schaltfläche Ausführen ausführen. Der geänderte Code wird entweder im interaktiven Fenster ausgeführt, oder das interaktive Fenster zeigt alle C#-Compilerfehlermeldungen an, wenn die Kompilierung fehlschlägt.

Die lokale Zeitzone der Inlinecodeausführung und dem Playground von Try.NET wird ist die Koordinierte Weltzeit (UTC). Dies kann sich auf das Verhalten und die Ausgabe von Beispielen auswirken, die die Typen DateTime, DateTimeOffset und TimeZoneInfo sowie deren Member veranschaulichen.

Tabelle mit Formatbezeichern

In der folgenden Tabelle werden die Standardformatbezeichner für Datum und Uhrzeit beschrieben. Sofern nicht anders angegeben, erzeugt ein bestimmter Standardformatbezeichner für Datum und Uhrzeit eine identische Zeichenfolgendarstellung, unabhängig davon, ob sie mit einem DateTime-Wert oder einem DateTimeOffset-Wert verwendet wird. Unter Systemsteuerungseinstellungen und DateTimeFormatInfo-Eigenschaften finden Sie weitere Informationen zur Verwendung von Standardzeichenfolgen für Datums- und Uhrzeitformate.

Formatbezeichner	Beschreibung	Beispiele
"d"	Kurzes Datumsmuster. Weitere Informationen finden Sie unter Der Formatbezeichner für das kurze Datum („d“).	2009-06-15T13:45:30 -> 6/15/2009 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 (fr-FR) 2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D"	Langes Datumsmuster. Weitere Informationen finden Sie unter Der Formatbezeichner für das lange Datum („D“).	2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US) 2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (ru-RU) 2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)
"f"	Vollständiges Datums-/Zeitmuster (kurze Zeit). Weitere Informationen finden Sie unter: Der Formatbezeichner für vollständiges Datum und kurze Zeit („f“).	2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45 PM (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)
"F"	Vollständiges Datums-/Zeitmuster (lange Zeit). Weitere Informationen finden Sie unter: Der Formatbezeichner für vollständiges Datum und lange Zeit („F“).	2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)
"g"	Allgemeines Datums-/Zeitmuster (kurze Zeit). Weitere Informationen finden Sie unter: Der allgemeine Formatbezeichner für Datum und kurze Zeit („g“).	2009-06-15T13:45:30 -> 6/15/2009 1:45 PM (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G"	Allgemeines Datums-/Zeitmuster (lange Zeit). Weitere Informationen finden Sie unter: Der allgemeine Formatbezeichner für Datum und lange Zeit („G“).	2009-06-15T13:45:30 -> 6/15/2009 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)
"M", "m"	Monatstagmuster. Weitere Informationen finden Sie unter: Der Formatbezeichner für den Monat („M“, „m“).	2009-06-15T13:45:30 -> June 15 (en-US) 2009-06-15T13:45:30 -> 15. juni (da-DK) 2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o"	Datums-/Uhrzeitmuster für Roundtrip. Weitere Informationen finden Sie unter: Der Formatbezeichner für Roundtrips („O“, „o“).	DateTime-Werte sind: 2009-06-15T13:45:30 (DateTimeKind.Local) --> 2009-06-15T13:45:30.0000000-07:00 2009-06-15T13:45:30 (DateTimeKind.Utc) --> 2009-06-15T13:45:30.0000000Z 2009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.0000000 DateTimeOffset: 2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:00
"R", "r"	RFC1123-Muster. Weitere Informationen finden Sie unter: Der RFC1123-Formatbezeichner („R“, „r“).	DateTimeOffset-Eingabe: 2009-06-15T13:45:30 -> Mon, 15 Jun 2009 20:45:30 GMT DateTime-Eingabe: 2009-06-15T13:45:30 -> Mon, 15 Jun 2009 13:45:30 GMT
"s"	Sortierbares Datums-/Zeitmuster. Weitere Informationen finden Sie unter: Der sortierbare Formatbezeichner („s“).	2009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:30 2009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:30
"t"	Kurzes Zeitmuster. Weitere Informationen finden Sie unter: Der Formatbezeichner für kurze Zeit („t“).	2009-06-15T13:45:30 -> 1:45 PM (en-US) 2009-06-15T13:45:30 -> 13:45 (hr-HR) 2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T"	Langes Zeitmuster. Weitere Informationen finden Sie unter: Der Formatbezeichner für lange Zeit („T“).	2009-06-15T13:45:30 -> 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> 13:45:30 (hr-HR) 2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"u"	Universelles, sortierbares Datums-/Zeitmuster. Weitere Informationen finden Sie unter: Der universelle sortierbare Formatbezeichner („u“).	Mit einem DateTime-Wert: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z Mit einem DateTimeOffset-Wert: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U"	Universelles Datums-/Zeitmuster (Koordinierte Weltzeit). Weitere Informationen finden Sie unter: Der universelle vollständige Formatbezeichner („U“).	2009-06-15T13:45:30 -> Monday, June 15, 2009 8:45:30 PM (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 20:45:30 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 8:45:30 μμ (el-GR)
"Y", "y"	Jahr-Monat-Muster. Weitere Informationen finden Sie unter: Der Formatbezeichner für Jahr-Monat („Y“).	2009-06-15T13:45:30 -> June 2009 (en-US) 2009-06-15T13:45:30 -> juni 2009 (da-DK) 2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Jedes andere einzelne Zeichen	Unbekannter Bezeichner.	Löst eine FormatException zur Laufzeit aus.

Funktionsweise der Standardformatzeichenfolgen

Bei einem Formatierungsvorgang ist eine Standardformatzeichenfolge lediglich ein Alias für eine benutzerdefinierte Formatzeichenfolge. Die Verwendung eines Alias, der auf eine benutzerdefinierte Formatzeichenfolge verweist, hat den Vorteil, dass der Alias unveränderlich bleibt, während die benutzerdefinierte Formatzeichenfolge selbst variieren kann. Dies ist wichtig, da sich die Zeichenfolgenentsprechungen von Datums- und Uhrzeitwerten i. d. R. abhängig von der Kultur unterscheiden. So gibt beispielsweise die Standardformatzeichenfolge "d" an, dass der Datums- und Uhrzeitwert in einem kurzen Datumsmuster angezeigt wird. Für die invariante Kultur lautet dieses Muster "MM/dd/yyyy". Für die Kultur fr-FR lautet es "dd/MM/yyyy". Für die Kultur ja-JP lautet es "yyyy/MM/dd".

Wenn eine Standardformatzeichenfolge in einem Formatierungsvorgang der benutzerdefinierte Formatzeichenfolge einer bestimmten Kultur zugeordnet wird, kann die Anwendung eine bestimmte Kultur definieren, deren benutzerdefinierte Formatzeichenfolgen auf eine der folgenden Weisen verwendet werden:

Sie können die Standardkultur (die aktuelle Kultur) verwenden. Das folgende Beispiel zeigt ein Datum unter Verwendung des kurzen Datumsformat der aktuellen Kultur an. In diesem Fall ist die aktuelle Kultur en-US.

// Display using current (en-us) culture's short date format
DateTime thisDate = new DateTime(2008, 3, 15);
Console.WriteLine(thisDate.ToString("d"));           // Displays 3/15/2008

' Display using current (en-us) culture's short date format
Dim thisDate As Date = #03/15/2008#
Console.WriteLine(thisDate.ToString("d"))     ' Displays 3/15/2008

Sie können ein CultureInfo-Objekt, das die Kultur darstellt, deren Formatierung verwendet werden soll, an eine Methode mit einem IFormatProvider-Parameter übergeben. Das folgenden Beispiel zeigt ein Datum unter Verwendung des kurzen Datumsformat der Kultur pt-BR an.

// Display using pt-BR culture's short date format
DateTime thisDate = new DateTime(2008, 3, 15);
CultureInfo culture = new CultureInfo("pt-BR");
Console.WriteLine(thisDate.ToString("d", culture));  // Displays 15/3/2008

' Display using pt-BR culture's short date format
Dim thisDate As Date = #03/15/2008#
Dim culture As New CultureInfo("pt-BR")
Console.WriteLine(thisDate.ToString("d", culture))   ' Displays 15/3/2008

Sie können ein DateTimeFormatInfo-Objekt, das Formatierungsinformationen liefert, an eine Methode mit einem IFormatProvider-Parameter übergeben. Das folgenden Beispiel zeigt ein Datum unter Verwendung des kurzen Datumsformat aus einem DateTimeFormatInfo-Objekt für die Kultur hr-HR an.

// Display using date format information from hr-HR culture
DateTime thisDate = new DateTime(2008, 3, 15);
DateTimeFormatInfo fmt = (new CultureInfo("hr-HR")).DateTimeFormat;
Console.WriteLine(thisDate.ToString("d", fmt));      // Displays 15.3.2008

' Display using date format information from hr-HR culture
Dim thisDate As Date = #03/15/2008#
Dim fmt As DateTimeFormatInfo = (New CultureInfo("hr-HR")).DateTimeFormat
Console.WriteLine(thisDate.ToString("d", fmt))   ' Displays 15.3.2008

Hinweis

Informationen zum Anpassen der Muster oder Zeichenfolgen, die beim Formatieren der Datums- und Uhrzeitwerte verwendet werden, finden Sie im Thema zur NumberFormatInfo-Klasse.

In einigen Fällen dient die Standardformatzeichenfolge als praktische Abkürzung für eine längere benutzerdefinierte Formatzeichenfolge, die unveränderlich ist. Vier Standardformatzeichenfolgen fallen in diese Kategorie: „O“ (oder „o“), „R“ (oder „r“), „s“ und „u“. Diese Zeichenfolgen entsprechen benutzerdefinierten Formatzeichenfolgen, die durch die invariante Kultur definiert werden. Sie erzeugen Zeichenfolgenentsprechungen von Datums- und Uhrzeitwerten, die über Kulturen hinweg identisch sein sollen. In der folgenden Tabelle werden Informationen über dieses vier Standardformatzeichenfolgen für Datum und Uhrzeit bereitgestellt.

Standardformatzeichenfolge	Definiert durch die DateTimeFormatInfo.InvariantInfo-Eigenschaft	Benutzerdefinierte Formatzeichenfolge
"O" oder "o"	Keine	jjjj'-'MM'-'tt'T'HH':'mm':'ss'.'fffffffK
"R" oder "r"	RFC1123Pattern	ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
"s"	SortableDateTimePattern	yyyy'-'MM'-'dd'T'HH':'mm':'ss
"u"	UniversalSortableDateTimePattern	yyyy'-'MM'-'dd HH':'mm':'ss'Z'

Standardformatzeichenfolgen können in Analysevorgängen auch mit der DateTime.ParseExact-Methode oder mit der DateTimeOffset.ParseExact-Methode verwendet werden. Dabei muss eine Eingabezeichenfolge genau einem bestimmten Muster entsprechen, damit der Analysevorgang erfolgreich durchgeführt wird. Viele Standardformatzeichenfolgen entsprechen mehreren benutzerdefinierten Formatzeichenfolgen. Ein Datums- und Uhrzeitwert kann also in einer Vielzahl von Formaten dargestellt werden, und dennoch wird der Analysevorgang erfolgreich durchgeführt. Sie können die benutzerdefinierten Formatzeichenfolgen festlegen, die einer Standardformatzeichenfolge entsprechen, indem Sie die DateTimeFormatInfo.GetAllDateTimePatterns(Char)-Methode aufrufen. Im folgenden Beispiel werden die benutzerdefinierten Formatzeichenfolgen angezeigt, die der Standardformatzeichenfolge "d" (kurzes Datumsmuster) zugeordnet sind.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      Console.WriteLine("'d' standard format string:");
      foreach (var customString in DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns('d'))
          Console.WriteLine("   {0}", customString);
   }
}
// The example displays the following output:
//       'd' standard format string:
//          M/d/yyyy
//          M/d/yy
//          MM/dd/yy
//          MM/dd/yyyy
//          yy/MM/dd
//          yyyy-MM-dd
//          dd-MMM-yy

Imports System.Globalization

Module Example
    Public Sub Main()
        Console.WriteLine("'d' standard format string:")
        For Each customString In DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns("d"c)
            Console.WriteLine("   {0}", customString)
        Next
    End Sub
End Module
' The example displays the following output:
'    'd' standard format string:
'       M/d/yyyy
'       M/d/yy
'       MM/dd/yy
'       MM/dd/yyyy
'       yy/MM/dd
'       yyyy-MM-dd
'       dd-MMM-yy

In den folgenden Abschnitten werden die Standardformatbezeichner für den DateTime-Wert und den DateTimeOffset-Wert beschrieben.

Datumsformate

Diese Gruppe enthält die folgenden Formate:

Der Formatbezeichner für das kurze Datum („d“)
Der Formatbezeichner für das lange Datum („D“)

Der Formatbezeichner „d“ für kurzes Datum

Der Standardformatbezeichner "d" stellt eine benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit dar, die von der DateTimeFormatInfo.ShortDatePattern-Eigenschaft einer bestimmten Kultur definiert wird. Die benutzerdefinierte Formatzeichenfolge, die durch die ShortDatePattern-Eigenschaft der invarianten Kultur zurückgegeben wird, lautet beispielsweise "MM/dd/yyyy".

In der folgenden Tabellen sind die DateTimeFormatInfo-Objekteigenschaften aufgeführt, die die Formatierung der zurückgegebenen Zeichenfolge steuern.

Eigenschaft	Beschreibung
ShortDatePattern	Definiert das Gesamtformat der Ergebniszeichenfolge.
DateSeparator	Definiert die Zeichenfolge, die die Komponenten Jahr, Monat und Tag eines Datums trennt.

Im folgenden Beispiel wird der d-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.

DateTime date1 = new DateTime(2008,4, 10);
Console.WriteLine(date1.ToString("d", DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays 4/10/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("en-NZ")));
// Displays 10/04/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("de-DE")));
// Displays 10.04.2008

Dim date1 As Date = #4/10/2008#
Console.WriteLine(date1.ToString("d", DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays 4/10/2008                       
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("en-NZ")))
' Displays 10/04/2008                       
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("de-DE")))
' Displays 10.04.2008

Eigenschaft	Beschreibung
LongDatePattern	Definiert das Gesamtformat der Ergebniszeichenfolge.
DayNames	Definiert die lokalisierten Tagesnamen, die in der Ergebniszeichenfolge vorkommen können.
MonthNames	Definiert die lokalisierten Monatsnamen, die in der Ergebniszeichenfolge vorkommen können.

Eigenschaft	Beschreibung
LongDatePattern	Definiert das Format der Datumskomponente der Ergebniszeichenfolge.
ShortTimePattern	Definiert das Format der Zeitkomponente der Ergebniszeichenfolge.
DayNames	Definiert die lokalisierten Tagesnamen, die in der Ergebniszeichenfolge vorkommen können.
MonthNames	Definiert die lokalisierten Monatsnamen, die in der Ergebniszeichenfolge vorkommen können.
TimeSeparator	Definiert die Zeichenfolge, die die Komponenten Stunde, Minute und Sekunde einer Uhrzeit trennt.
AMDesignator	Definiert die Zeichenfolge, die Zeiten zwischen Mitternacht und Mittag im 12-Stunden-Format angibt.
PMDesignator	Definiert die Zeichenfolge, die Zeiten zwischen Mittag und Mitternacht im 12-Stunden-Format angibt.

Eigenschaft	Beschreibung
FullDateTimePattern	Definiert das Gesamtformat der Ergebniszeichenfolge.
DayNames	Definiert die lokalisierten Tagesnamen, die in der Ergebniszeichenfolge vorkommen können.
MonthNames	Definiert die lokalisierten Monatsnamen, die in der Ergebniszeichenfolge vorkommen können.
TimeSeparator	Definiert die Zeichenfolge, die die Komponenten Stunde, Minute und Sekunde einer Uhrzeit trennt.
AMDesignator	Definiert die Zeichenfolge, die Zeiten zwischen Mitternacht und Mittag im 12-Stunden-Format angibt.
PMDesignator	Definiert die Zeichenfolge, die Zeiten zwischen Mittag und Mitternacht im 12-Stunden-Format angibt.

Eigenschaft	Beschreibung
ShortDatePattern	Definiert das Format der Datumskomponente der Ergebniszeichenfolge.
LongTimePattern	Definiert das Format der Zeitkomponente der Ergebniszeichenfolge.
DateSeparator	Definiert die Zeichenfolge, die die Komponenten Jahr, Monat und Tag eines Datums trennt.
TimeSeparator	Definiert die Zeichenfolge, die die Komponenten Stunde, Minute und Sekunde einer Uhrzeit trennt.
AMDesignator	Definiert die Zeichenfolge, die Zeiten zwischen Mitternacht und Mittag im 12-Stunden-Format angibt.
PMDesignator	Definiert die Zeichenfolge, die Zeiten zwischen Mittag und Mitternacht im 12-Stunden-Format angibt.

Eigenschaft	Beschreibung
RFC1123Pattern	Definiert das Format der Ergebniszeichenfolge.
AbbreviatedDayNames	Definiert die abgekürzten Tagesnamen, die in der Ergebniszeichenfolge vorkommen können.
AbbreviatedMonthNames	Definiert die abgekürzten Monatsnamen, die in der Ergebniszeichenfolge vorkommen können.

Eigenschaft	Beschreibung
MonthDayPattern	Definiert das Gesamtformat der Ergebniszeichenfolge.
MonthNames	Definiert die lokalisierten Monatsnamen, die in der Ergebniszeichenfolge vorkommen können.

Eigenschaft	Beschreibung
YearMonthPattern	Definiert das Gesamtformat der Ergebniszeichenfolge.
MonthNames	Definiert die lokalisierten Monatsnamen, die in der Ergebniszeichenfolge vorkommen können.

Standardformatzeichenfolgen für Datum und Uhrzeit

Tabelle mit Formatbezeichern

Funktionsweise der Standardformatzeichenfolgen

Datumsformate

Der Formatbezeichner „d“ für kurzes Datum

Der Formatbezeichner „D“ für langes Datum

Formate für Datum und Uhrzeit

Der Formatbezeichner „f“ für vollständiges Datum und kurze Zeit

Der Formatbezeichner „F“ für vollständiges Datum und lange Zeit

Der Formatbezeichner „g“ für allgemeines Datum und kurze Zeit

Der Formatbezeichner „G“ für allgemeines Datum und lange Zeit

Die Formatbezeichner „O“, „o“ für Roundtrips

Die RFC1123-Formatbezeichner „R“, „r“

Der Bezeichner „s“ für sortierbares Format

Der Bezeichner „u“ für universelles sortierbares Format

Der Bezeichner „U“ für universelles vollständiges Format

Uhrzeitformate

Der Formatbezeichner „t“ für kurze Zeit

Der Formatbezeichner „T“ für lange Zeit

Partielle Datumsformate

Die Formatbezeichner „M“, „m“ für Monat

Die Formatbezeichner „Y“, „y“ für Jahr-Monat

Einstellungen der Systemsteuerung

DateTimeFormatInfo-Eigenschaften

Siehe auch

Feedback

Zusätzliche Ressourcen