Standardformatzeichenfolgen für Datum und Uhrzeit

Artikel
03/22/2025

Eine Standardformatzeichenfolge für Datum und Uhrzeit verwendet ein einzelnes Zeichen als Formatbezeichner, um die Textdarstellung eines DateTime oder eines 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 Standard- oder benutzerdefinierte Formatzeichenfolge kann auf zwei Arten verwendet werden:

So definieren Sie die Zeichenfolge, die aus einem Formatierungsvorgang resultiert.
So definieren Sie die Textdarstellung eines Datums- und Uhrzeitwerts, der durch einen Analysevorgang in einen DateTime- oder DateTimeOffset Wert konvertiert werden kann.

Tipp

Sie können das Formatierungsprogrammherunterladen, eine .NET Windows Forms-Anwendung, mit der Sie Formatzeichenfolgen auf numerische oder Datums- und Uhrzeitwerte anwenden und die Ergebniszeichenfolge anzeigen können. Quellcode ist für C#- und Visual Basicverfügbar.

Hinweis

Einige der C#-Beispiele in diesem Artikel werden im Try.NET Inlinecode-Runner und Playground 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 lokalen Zeitzone des Try.NET Inlinecodeläufers und Playgrounds ist koordinierte Weltzeit oder UTC. Dies kann sich auf das Verhalten und die Ausgabe von Beispielen auswirken, die die DateTime, DateTimeOffsetund TimeZoneInfo Typen und 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 Standard-Datums- und Uhrzeitformatbezeichner eine identische Zeichenfolgendarstellung, unabhängig davon, ob er mit einem DateTime oder einem DateTimeOffset Wert verwendet wird. Weitere Informationen zur Verwendung von Standardmäßigen Datums- und Uhrzeitformatzeichenfolgen finden Sie unter Einstellungen der Systemsteuerung und DateTimeFormatInfo-Eigenschaften.

Formatbezeichner	BESCHREIBUNG	Beispiele
"d"	Kurzes Datumsmuster. Weitere Informationen:Der kurze Datumsformatbezeichner ("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: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: 2009-06-15T13:45:30 (DateTimeKind.Local) --> 2009-06-15T13:45:30.000000-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.00000000 DateTimeOffset Werte: 2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.000000-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. Juni 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 vollständiges Datums-/Uhrzeitmuster. Weitere Informationen: Der universelle Vollformatbezeichner ("U").	2009-06-15T13:45:30 -> Montag, 15. Juni 2009 8:45:30 Uhr (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 Laufzeit FormatExceptionaus.

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 übergeben, das die Kultur darstellt, deren Formatierung für eine Methode mit einem IFormatProvider-Parameter verwendet werden soll. 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 übergeben, das Formatierungsinformationen an eine Methode mit einem IFormatProvider Parameter bereitstellt. Im folgenden Beispiel wird ein Datum mithilfe des kurzen Datumsformats aus einem DateTimeFormatInfo-Objekt für die hr-HR Kultur angezeigt.

// 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 zum Formatieren von Datums- und Uhrzeitwerten finden Sie im Thema 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 dateTimeFormatInfo.InvariantInfo-Eigenschaft	Benutzerdefinierte Formatzeichenfolge
"O" oder "o"	Nichts	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 auch bei Analysevorgängen mit den methoden DateTime.ParseExact oder DateTimeOffset.ParseExact verwendet werden, die eine Eingabezeichenfolge erfordern, um genau einem bestimmten Muster für den erfolgreichen Analysevorgang zu entsprechen. Viele Standardformatzeichenfolgen werden mehreren benutzerdefinierten Formatzeichenfolgen zugeordnet, sodass ein Datums- und Uhrzeitwert in einer Vielzahl von Formaten dargestellt werden kann und der Analysevorgang weiterhin erfolgreich ist. Sie können die benutzerdefinierte Formatzeichenfolge oder Zeichenfolgen bestimmen, 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($"   {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 DateTime und DateTimeOffset Werte 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 Datums- und Uhrzeitformatzeichenfolge dar, die durch die DateTimeFormatInfo.ShortDatePattern-Eigenschaft einer bestimmten Kultur definiert wird. Die benutzerdefinierte Formatzeichenfolge, die von der ShortDatePattern Eigenschaft der invarianten Kultur zurückgegeben wird, lautet z. B. "MM/dd/yyyy".

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

Eigentum	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 Formatbezeichner "d" verwendet, um einen Datums- und Uhrzeitwert 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

Eigentum	BESCHREIBUNG
LongDatePattern	Definiert das Gesamtformat der Ergebniszeichenfolge.
DayNames	Definiert die lokalisierten Tagnamen, die in der Ergebniszeichenfolge angezeigt werden können.
MonthNames	Definiert die lokalisierten Monatsnamen, die in der Ergebniszeichenfolge angezeigt werden können.

Eigentum	BESCHREIBUNG
LongDatePattern	Definiert das Format der Datumskomponente der Ergebniszeichenfolge.
ShortTimePattern	Definiert das Format der Zeitkomponente der Ergebniszeichenfolge.
DayNames	Definiert die lokalisierten Tagnamen, die in der Ergebniszeichenfolge angezeigt werden können.
MonthNames	Definiert die lokalisierten Monatsnamen, die in der Ergebniszeichenfolge angezeigt werden können.
TimeSeparator	Definiert die Zeichenfolge, die die Komponenten "Stunde", "Minute" und "Sekunde" einer Uhrzeit trennt.
AMDesignator	Definiert die Zeichenfolge, die Uhrzeiten von Mitternacht bis vor Mittag im 12-Stunden-Format angibt.
PMDesignator	Definiert die Zeichenfolge, die Uhrzeiten von Mittag bis Mitternacht im 12-Stunden-Format angibt.

Eigentum	BESCHREIBUNG
FullDateTimePattern	Definiert das Gesamtformat der Ergebniszeichenfolge.
DayNames	Definiert die lokalisierten Tagnamen, die in der Ergebniszeichenfolge angezeigt werden können.
MonthNames	Definiert die lokalisierten Monatsnamen, die in der Ergebniszeichenfolge angezeigt werden können.
TimeSeparator	Definiert die Zeichenfolge, die die Komponenten "Stunde", "Minute" und "Sekunde" einer Uhrzeit trennt.
AMDesignator	Definiert die Zeichenfolge, die Uhrzeiten von Mitternacht bis vor Mittag im 12-Stunden-Format angibt.
PMDesignator	Definiert die Zeichenfolge, die Uhrzeiten von Mittag bis Mitternacht im 12-Stunden-Format angibt.

Eigentum	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 Uhrzeiten von Mitternacht bis vor Mittag im 12-Stunden-Format angibt.
PMDesignator	Definiert die Zeichenfolge, die Uhrzeiten von Mittag bis Mitternacht im 12-Stunden-Format angibt.

Eigentum	BESCHREIBUNG
RFC1123Pattern	Definiert das Format der Ergebniszeichenfolge.
AbbreviatedDayNames	Definiert die abgekürzten Tagnamen, die in der Ergebniszeichenfolge angezeigt werden können.
AbbreviatedMonthNames	Definiert die abgekürzten Monatsnamen, die in der Ergebniszeichenfolge angezeigt werden können.

Eigentum	BESCHREIBUNG
MonthDayPattern	Definiert das Gesamtformat der Ergebniszeichenfolge.
MonthNames	Definiert die lokalisierten Monatsnamen, die in der Ergebniszeichenfolge angezeigt werden können.

Eigentum	BESCHREIBUNG
YearMonthPattern	Definiert das Gesamtformat der Ergebniszeichenfolge.
MonthNames	Definiert die lokalisierten Monatsnamen, die in der Ergebniszeichenfolge angezeigt werden können.

Freigeben über

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

Datums- und Uhrzeitformate

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 universelle Vollformatbezeichner ("U")

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

Systemsteuerungseinstellungen

DateTimeFormatInfo-Eigenschaften

Siehe auch

Zusätzliche Ressourcen