Standard-Formatzeichenfolgen für Datum und UhrzeitStandard Date and Time Format Strings

Eine standardmäßige Formatzeichenfolge für Datum und Uhrzeit verwendet einen einzelnen Formatbezeichner, um die Textdarstellung eines Datums- und Uhrzeitwerts zu definieren.A standard date and time format string uses a single format specifier to define the text representation of a date and time value. 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. Weitere Informationen finden Sie unter Benutzerdefinierte Formatzeichenfolgen für Datum und Uhrzeit.Any date and time format string that contains more than one character, including white space, is interpreted as a custom date and time format string; for more information, see Custom Date and Time Format Strings. Eine standardmäßige oder benutzerdefinierte Formatzeichenfolge kann auf zwei Arten verwendet werden:A standard or custom format string can be used in two ways:

  • Zum Definieren der Zeichenfolge, die das Ergebnis eines Formatierungsvorgangs ist.To define the string that results from a formatting operation.

  • Zum Definieren der Textdarstellung eines Datums- und Uhrzeitwerts, der bei einem Analysevorgang in einen DateTime-Wert oder in einen DateTimeOffset-Wert konvertiert werden kann.To define the text representation of a date and time value that can be converted to a DateTime or DateTimeOffset value by a parsing operation.

Tipp

Sie können das Hilfsprogramm zur Formatierung herunterladen. Dabei handelt sich um eine Windows Forms-Anwendung für .NET Core, mit der Sie Formatzeichenfolgen auf numerische Werte oder Datums- und Zeitwerte anwenden und die Ergebniszeichenfolge anzeigen können.You can download the Formatting Utility, a .NET Core Windows Forms application that lets you apply format strings to either numeric or date and time values and displays the result string. Für C# und Visual Basic ist Quellcode verfügbar.Source code is available for C# and Visual Basic.

Standard-Formatzeichenfolgen für Datum und Uhrzeit können mit dem Wert DateTime und mit dem Wert DateTimeOffset verwendet werden.Standard date and time format strings can be used with both DateTime and DateTimeOffset values.

Hinweis

Einige der C#-Beispiele in diesem Artikel werden in der Inlinecodeausführung und dem Playground von Try.NET ausgeführt.Some of the C# examples in this article run in the Try.NET inline code runner and playground. Klicken Sie auf die Schaltfläche Ausführen, um ein Beispiel in einem interaktiven Fenster auszuführen.Select the Run button to run an example in an interactive window. 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.Once you execute the code, you can modify it and run the modified code by selecting Run again. 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.The modified code either runs in the interactive window or, if compilation fails, the interactive window displays all C# compiler error messages.

Die lokale Zeitzone der Inlinecodeausführung und dem Playground von Try.NET wird ist die Koordinierte Weltzeit (UTC).The local time zone of the Try.NET inline code runner and playground is Coordinated Universal Time, or UTC. Dies kann sich auf das Verhalten und die Ausgabe von Beispielen auswirken, die die Typen DateTime, DateTimeOffset und TimeZoneInfo sowie deren Member veranschaulichen.This may affect the behavior and the output of examples that illustrate the DateTime, DateTimeOffset, and TimeZoneInfo types and their members.

In der folgenden Tabelle werden die Standardformatbezeichner für Datum und Uhrzeit beschrieben.The following table describes the standard date and time format specifiers. 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.Unless otherwise noted, a particular standard date and time format specifier produces an identical string representation regardless of whether it is used with a DateTime or a DateTimeOffset value. Weitere Informationen zum Verwenden von standardmäßigen Formatzeichenfolgen für Datum und Uhrzeit finden Sie im Abschnitt Hinweise.See the Notes section for additional information about using standard date and time format strings.

FormatbezeichnerFormat specifier BESCHREIBUNGDescription BeispieleExamples
"d""d" Kurzes Datumsmuster.Short date pattern.

Weitere Informationen finden Sie unter Der Formatbezeichner "d" für das kurze Datum.More information:The Short Date ("d") Format Specifier.
2009-06-15T13:45:30 -> 6/15/2009 (en-US)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 -> 15/06/2009 (fr-FR)

2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D""D" Langes Datumsmuster.Long date pattern.

Weitere Informationen finden Sie unter Der Formatbezeichner "D" für das lange Datum.More information:The Long Date ("D") Format Specifier.
2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US)2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US)

2009-06-15T13:45:30 -> 15 июня 2009 г.2009-06-15T13:45:30 -> 15 июня 2009 г. (ru-RU)(ru-RU)

2009-06-15T13:45:30 -> Montag, 15.2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)Juni 2009 (de-DE)
"f""f" Vollständiges Datums-/Zeitmuster (kurze Zeit).Full date/time pattern (short time).

Weitere Informationen finden Sie unter: Der Formatspezifizierer „f“ für vollständiges Datum und kurze Zeit.More information: The Full Date Short Time ("f") Format Specifier.
2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45 PM (en-US)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 -> den 15 juni 2009 13:45 (sv-SE)

2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)
"F""F" Vollständiges Datums-/Zeitmuster (lange Zeit).Full date/time pattern (long time).

Weitere Informationen finden Sie unter: Der Formatspezifizierer „F“ für vollständiges Datum und lange Zeit.More information: The Full Date Long Time ("F") Format Specifier.
2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45:30 PM (en-US)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 -> den 15 juni 2009 13:45:30 (sv-SE)

2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)
"g""g" Allgemeines Datums-/Zeitmuster (kurze Zeit).General date/time pattern (short time).

Weitere Informationen finden Sie unter: Der allgemeine Formatspezifizierer „g“ für Datum und kurze Zeit.More information: The General Date Short Time ("g") Format Specifier.
2009-06-15T13:45:30 -> 6/15/2009 1:45 PM (en-US)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 -> 15/06/2009 13:45 (es-ES)

2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G""G" Allgemeines Datums-/Zeitmuster (lange Zeit).General date/time pattern (long time).

Weitere Informationen finden Sie unter: Der allgemeine Formatspezifizierer „G“ für Datum und lange Zeit.More information: The General Date Long Time ("G") Format Specifier.
2009-06-15T13:45:30 -> 6/15/2009 1:45:30 PM (en-US)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 -> 15/06/2009 13:45:30 (es-ES)

2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)
"M", "m""M", "m" Monatstagmuster.Month/day pattern.

Weitere Informationen finden Sie unter: Der Formatspezifizierer „M“, „m“ für den Monat.More information: The Month ("M", "m") Format Specifier.
2009-06-15T13:45:30 -> June 15 (en-US)2009-06-15T13:45:30 -> June 15 (en-US)

2009-06-15T13:45:30 -> 15.2009-06-15T13:45:30 -> 15. juni (da-DK)juni (da-DK)

2009-06-15T13:45:30 -> 15 Juni (id-ID)2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o""O", "o" Zurückkonvertieren von Datums-/Zeitmuster.Round-trip date/time pattern.

Weitere Informationen finden Sie unter: Der Formatspezifizierer „O“, „o“ für Roundtrips.More information: The Round-trip ("O", "o") Format Specifier.
DateTime-Werte sind:DateTime values:

2009-06-15T13:45:30 (DateTimeKind.Local) --> 2009-06-15T13:45:30.0000000-07:002009-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.0000000Z2009-06-15T13:45:30 (DateTimeKind.Utc) --> 2009-06-15T13:45:30.0000000Z

2009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.00000002009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.0000000

DateTimeOffset:DateTimeOffset values:

2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:002009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:00
"R", "r""R", "r" RFC1123-Muster.RFC1123 pattern.

Weitere Informationen finden Sie unter: Der RFC1123-Formatspezifizierer „R“, „r“.More information: The RFC1123 ("R", "r") Format Specifier.
2009-06-15T13:45:30 -> Mon, 15 Jun 2009 20:45:30 GMT2009-06-15T13:45:30 -> Mon, 15 Jun 2009 20:45:30 GMT
"s""s" Sortierbares Datums-/Zeitmuster.Sortable date/time pattern.

Weitere Informationen finden Sie unter: Der sortierbare Formatspezifizierer „s“.More information: The Sortable ("s") Format Specifier.
2009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:302009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:30

2009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:302009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:30
"t""t" Kurzes Zeitmuster.Short time pattern.

Weitere Informationen finden Sie unter: Der Formatspezifizierer „t“ für kurze Zeit.More information: The Short Time ("t") Format Specifier.
2009-06-15T13:45:30 -> 1:45 PM (en-US)2009-06-15T13:45:30 -> 1:45 PM (en-US)

2009-06-15T13:45:30 -> 13:45 (hr-HR)2009-06-15T13:45:30 -> 13:45 (hr-HR)

2009-06-15T13:45:30 -> 01:45 م (ar-EG)2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T""T" Langes Zeitmuster.Long time pattern.

Weitere Informationen finden Sie unter: Der Formatspezifizierer „T“ für lange Zeit.More information: The Long Time ("T") Format Specifier.
2009-06-15T13:45:30 -> 1:45:30 PM (en-US)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 -> 13:45:30 (hr-HR)

2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"u""u" Universelles, sortierbares Datums-/Zeitmuster.Universal sortable date/time pattern.

Weitere Informationen finden Sie unter: Der universelle sortierbare Formatspezifizierer „u“.More information: The Universal Sortable ("u") Format Specifier.
Mit einem DateTime-Wert: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30ZWith a DateTime value: 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:30ZWith a DateTimeOffset value: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U""U" Universelles Datums-/Zeitmuster (Koordinierte Weltzeit).Universal full date/time pattern.

Weitere Informationen finden Sie unter: Der universelle vollständige Formatspezifizierer „U“.More information: The Universal Full ("U") Format Specifier.
2009-06-15T13:45:30 -> Monday, June 15, 2009 8:45:30 PM (en-US)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 -> den 15 juni 2009 20:45:30 (sv-SE)

2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 8:45:30 μμ (el-GR)2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 8:45:30 μμ (el-GR)
"Y", "y""Y", "y" Jahr-Monat-Muster.Year month pattern.

Weitere Informationen finden Sie unter: Der Formatspezifizierer „Y“, „y“ für Jahr-Monat.More information: The Year Month ("Y") Format Specifier.
2009-06-15T13:45:30 -> June, 2009 (en-US)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 (da-DK)

2009-06-15T13:45:30 -> Juni 2009 (id-ID)2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Jedes andere einzelne ZeichenAny other single character Unbekannter Bezeichner.Unknown specifier. Löst eine FormatException zur Laufzeit aus.Throws a run-time FormatException.

Funktionsweise der StandardformatzeichenfolgenHow Standard Format Strings Work

Bei einem Formatierungsvorgang ist eine Standardformatzeichenfolge lediglich ein Alias für eine benutzerdefinierte Formatzeichenfolge.In a formatting operation, a standard format string is simply an alias for a custom format string. 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.The advantage of using an alias to refer to a custom format string is that, although the alias remains invariant, the custom format string itself can vary. Dies ist wichtig, da sich die Zeichenfolgenentsprechungen von Datums- und Uhrzeitwerten i. d. R. abhängig von der Kultur unterscheiden.This is important because the string representations of date and time values typically vary by culture. So gibt beispielsweise die Standardformatzeichenfolge "d" an, dass der Datums- und Uhrzeitwert in einem kurzen Datumsmuster angezeigt wird.For example, the "d" standard format string indicates that a date and time value is to be displayed using a short date pattern. Für die invariante Kultur lautet dieses Muster "MM/dd/yyyy".For the invariant culture, this pattern is "MM/dd/yyyy". Für die Kultur fr-FR lautet es "dd/MM/yyyy".For the fr-FR culture, it is "dd/MM/yyyy". Für die Kultur ja-JP lautet es "yyyy/MM/dd".For the ja-JP culture, it is "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:If a standard format string in a formatting operation maps to a particular culture's custom format string, your application can define the specific culture whose custom format strings are used in one of these ways:

  • Sie können die Standardkultur (die aktuelle Kultur) verwenden.You can use the default (or current) culture. Das folgende Beispiel zeigt ein Datum unter Verwendung des kurzen Datumsformat der aktuellen Kultur an.The following example displays a date using the current culture's short date format. In diesem Fall ist die aktuelle Kultur en-US.In this case, the current culture is 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.You can pass a CultureInfo object representing the culture whose formatting is to be used to a method that has an IFormatProvider parameter. Das folgenden Beispiel zeigt ein Datum unter Verwendung des kurzen Datumsformat der Kultur pt-BR an.The following example displays a date using the short date format of the pt-BR culture.

    // 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.You can pass a DateTimeFormatInfo object that provides formatting information to a method that has an IFormatProvider parameter. Das folgenden Beispiel zeigt ein Datum unter Verwendung des kurzen Datumsformat aus einem DateTimeFormatInfo-Objekt für die Kultur hr-HR an.The following example displays a date using the short date format from a DateTimeFormatInfo object for the hr-HR culture.

    // 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.For information about customizing the patterns or strings used in formatting date and time values, see the NumberFormatInfo class topic.

In einigen Fällen dient die Standardformatzeichenfolge als praktische Abkürzung für eine längere benutzerdefinierte Formatzeichenfolge, die unveränderlich ist.In some cases, the standard format string serves as a convenient abbreviation for a longer custom format string that is invariant. Vier Standardformatzeichenfolgen fallen in diese Kategorie: „O“ (oder „o“), „R“ (oder „r“), „s“ und „u“.Four standard format strings fall into this category: "O" (or "o"), "R" (or "r"), "s", and "u". Diese Zeichenfolgen entsprechen benutzerdefinierten Formatzeichenfolgen, die durch die invariante Kultur definiert werden.These strings correspond to custom format strings defined by the invariant culture. Sie erzeugen Zeichenfolgenentsprechungen von Datums- und Uhrzeitwerten, die über Kulturen hinweg identisch sein sollen.They produce string representations of date and time values that are intended to be identical across cultures. In der folgenden Tabelle werden Informationen über dieses vier Standardformatzeichenfolgen für Datum und Uhrzeit bereitgestellt.The following table provides information on these four standard date and time format strings.

StandardformatzeichenfolgeStandard format string Definiert durch die DateTimeFormatInfo.InvariantInfo-EigenschaftDefined by DateTimeFormatInfo.InvariantInfo property Benutzerdefinierte FormatzeichenfolgeCustom format string
"O" oder "o""O" or "o" KeineNone yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzzyyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzz
"R" oder "r""R" or "r" RFC1123Pattern ddd, dd MMM yyyy HH':'mm':'ss 'GMT'ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
"s""s" SortableDateTimePattern yyyy'-'MM'-'dd'T'HH':'mm':'ssyyyy'-'MM'-'dd'T'HH':'mm':'ss
"u""u" UniversalSortableDateTimePattern yyyy'-'MM'-'dd HH':'mm':'ss'Z'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.Standard format strings can also be used in parsing operations with the DateTime.ParseExact or DateTimeOffset.ParseExact methods, which require an input string to exactly conform to a particular pattern for the parse operation to succeed. 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.Many standard format strings map to multiple custom format strings, so a date and time value can be represented in a variety of formats and the parse operation will still succeed. Sie können die benutzerdefinierten Formatzeichenfolgen festlegen, die einer Standardformatzeichenfolge entsprechen, indem Sie die DateTimeFormatInfo.GetAllDateTimePatterns(Char)-Methode aufrufen.You can determine the custom format string or strings that correspond to a standard format string by calling the DateTimeFormatInfo.GetAllDateTimePatterns(Char) method. Im folgenden Beispiel werden die benutzerdefinierten Formatzeichenfolgen angezeigt, die der Standardformatzeichenfolge "d" (kurzes Datumsmuster) zugeordnet sind.The following example displays the custom format strings that map to the "d" (short date pattern) standard format string.

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.The following sections describe the standard format specifiers for DateTime and DateTimeOffset values.

Der Formatbezeichner "d" für das kurze DatumThe Short Date ("d") Format Specifier

Der Standardformatbezeichner "d" stellt eine benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit dar, die von der DateTimeFormatInfo.ShortDatePattern-Eigenschaft einer bestimmten Kultur definiert wird.The "d" standard format specifier represents a custom date and time format string that is defined by a specific culture's DateTimeFormatInfo.ShortDatePattern property. Die benutzerdefinierte Formatzeichenfolge, die durch die ShortDatePattern-Eigenschaft der invarianten Kultur zurückgegeben wird, lautet beispielsweise "MM/dd/yyyy".For example, the custom format string that is returned by the ShortDatePattern property of the invariant culture is "MM/dd/yyyy".

In der folgenden Tabellen sind die DateTimeFormatInfo-Objekteigenschaften aufgeführt, die die Formatierung der zurückgegebenen Zeichenfolge steuern.The following table lists the DateTimeFormatInfo object properties that control the formatting of the returned string.

EigenschaftProperty BESCHREIBUNGDescription
ShortDatePattern Definiert das Gesamtformat der Ergebniszeichenfolge.Defines the overall format of the result string.
DateSeparator Definiert die Zeichenfolge, die die Komponenten Jahr, Monat und Tag eines Datums trennt.Defines the string that separates the year, month, and day components of a date.

Im folgenden Beispiel wird der d-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.The following example uses the "d" format specifier to display a date and time value.

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                       

Zurück zur TabelleBack to table

Der Formatbezeichner "D" für langes DatumThe Long Date ("D") Format Specifier

Der Standardformatbezeichner "D" stellt eine benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit dar, die von der aktuellen DateTimeFormatInfo.LongDatePattern-Eigenschaft definiert wird.The "D" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.LongDatePattern property. Die benutzerdefinierte Formatzeichenfolge für die invariante Kultur lautet beispielsweise "dddd, dd MMMM yyyy".For example, the custom format string for the invariant culture is "dddd, dd MMMM yyyy".

In der folgenden Tabelle sind die Eigenschaften des DateTimeFormatInfo-Objekts aufgeführt, die die Formatierung der zurückgegebenen Zeichenfolge steuern können.The following table lists the properties of the DateTimeFormatInfo object that control the formatting of the returned string.

EigenschaftProperty BESCHREIBUNGDescription
LongDatePattern Definiert das Gesamtformat der Ergebniszeichenfolge.Defines the overall format of the result string.
DayNames Definiert die lokalisierten Tagesnamen, die in der Ergebniszeichenfolge vorkommen können.Defines the localized day names that can appear in the result string.
MonthNames Definiert die lokalisierten Monatsnamen, die in der Ergebniszeichenfolge vorkommen können.Defines the localized month names that can appear in the result string.

Im folgenden Beispiel wird der D-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.The following example uses the "D" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10);
Console.WriteLine(date1.ToString("D", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008                        
Console.WriteLine(date1.ToString("D", 
                  CultureInfo.CreateSpecificCulture("pt-BR")));
// Displays quinta-feira, 10 de abril de 2008                        
Console.WriteLine(date1.ToString("D", 
                  CultureInfo.CreateSpecificCulture("es-MX")));
// Displays jueves, 10 de abril de 2008                        
Dim date1 As Date = #4/10/2008#
Console.WriteLine(date1.ToString("D", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008                        
Console.WriteLine(date1.ToString("D", _
                  CultureInfo.CreateSpecificCulture("pt-BR")))
' Displays quinta-feira, 10 de abril de 2008                        
Console.WriteLine(date1.ToString("D", _
                  CultureInfo.CreateSpecificCulture("es-MX")))
' Displays jueves, 10 de abril de 2008                        

Zurück zur TabelleBack to table

Der Formatbezeichner "f" für vollständiges Datum und kurze ZeitThe Full Date Short Time ("f") Format Specifier

Der Standardformatbezeichner "f" stellt eine Kombination aus dem Muster für langes Datum ("D") und dem Muster für kurze Zeit ("t") getrennt durch ein Leerzeichen dar.The "f" standard format specifier represents a combination of the long date ("D") and short time ("t") patterns, separated by a space.

Die Ergebniszeichenfolge wird von den Formatierungsinformationen eines bestimmten DateTimeFormatInfo-Objekts beeinflusst.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. In der folgenden Tabelle sind die DateTimeFormatInfo-Objekteigenschaften aufgeführt, die die Formatierung der zurückgegebenen Zeichenfolge steuern können.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. Der von der DateTimeFormatInfo.LongDatePattern-Eigenschaft und DateTimeFormatInfo.ShortTimePattern-Eigenschaft einiger Kulturen zurückgegebene benutzerdefinierte Formatbezeichner nutzt möglicherweise nicht alle Eigenschaften.The custom format specifier returned by the DateTimeFormatInfo.LongDatePattern and DateTimeFormatInfo.ShortTimePattern properties of some cultures may not make use of all properties.

EigenschaftProperty BESCHREIBUNGDescription
LongDatePattern Definiert das Format der Datumskomponente der Ergebniszeichenfolge.Defines the format of the date component of the result string.
ShortTimePattern Definiert das Format der Zeitkomponente der Ergebniszeichenfolge.Defines the format of the time component of the result string.
DayNames Definiert die lokalisierten Tagesnamen, die in der Ergebniszeichenfolge vorkommen können.Defines the localized day names that can appear in the result string.
MonthNames Definiert die lokalisierten Monatsnamen, die in der Ergebniszeichenfolge vorkommen können.Defines the localized month names that can appear in the result string.
TimeSeparator Definiert die Zeichenfolge, die die Komponenten Stunde, Minute und Sekunde einer Uhrzeit trennt.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Definiert die Zeichenfolge, die Zeiten zwischen Mitternacht und Mittag im 12-Stunden-Format angibt.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Definiert die Zeichenfolge, die Zeiten zwischen Mittag und Mitternacht im 12-Stunden-Format angibt.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

Im folgenden Beispiel wird der f-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.The following example uses the "f" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("f", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008 6:30 AM                        
Console.WriteLine(date1.ToString("f", 
                  CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays jeudi 10 avril 2008 06:30                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("f", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008 6:30 AM                        
Console.WriteLine(date1.ToString("f", _
                  CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays jeudi 10 avril 2008 06:30                       

Zurück zur TabelleBack to table

Der Formatbezeichner "F" für vollständiges Datum und lange ZeitThe Full Date Long Time ("F") Format Specifier

Der Standardformatbezeichner "F" stellt eine benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit dar, die von der aktuellen DateTimeFormatInfo.FullDateTimePattern-Eigenschaft definiert wird.The "F" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.FullDateTimePattern property. Die benutzerdefinierte Formatzeichenfolge für die invariante Kultur lautet beispielsweise "dddd, dd MMMM yyyy HH:mm:ss".For example, the custom format string for the invariant culture is "dddd, dd MMMM yyyy HH:mm:ss".

In der folgenden Tabelle sind die DateTimeFormatInfo-Objekteigenschaften aufgeführt, die die Formatierung der zurückgegebenen Zeichenfolge steuern können.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. Der von der FullDateTimePattern-Eigenschaft einiger Kulturen zurückgegebene benutzerdefinierte Formatbezeichner nutzt möglicherweise nicht alle Eigenschaften.The custom format specifier that is returned by the FullDateTimePattern property of some cultures may not make use of all properties.

EigenschaftProperty BESCHREIBUNGDescription
FullDateTimePattern Definiert das Gesamtformat der Ergebniszeichenfolge.Defines the overall format of the result string.
DayNames Definiert die lokalisierten Tagesnamen, die in der Ergebniszeichenfolge vorkommen können.Defines the localized day names that can appear in the result string.
MonthNames Definiert die lokalisierten Monatsnamen, die in der Ergebniszeichenfolge vorkommen können.Defines the localized month names that can appear in the result string.
TimeSeparator Definiert die Zeichenfolge, die die Komponenten Stunde, Minute und Sekunde einer Uhrzeit trennt.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Definiert die Zeichenfolge, die Zeiten zwischen Mitternacht und Mittag im 12-Stunden-Format angibt.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Definiert die Zeichenfolge, die Zeiten zwischen Mittag und Mitternacht im 12-Stunden-Format angibt.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

Im folgenden Beispiel wird der F-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.The following example uses the "F" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("F", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008 6:30:00 AM                        
Console.WriteLine(date1.ToString("F", 
                  CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays jeudi 10 avril 2008 06:30:00                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("F", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008 6:30:00 AM                        
Console.WriteLine(date1.ToString("F", _
                  CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays jeudi 10 avril 2008 06:30:00                       

Zurück zur TabelleBack to table

Der allgemeine Formatbezeichner "g" für Datum und kurze ZeitThe General Date Short Time ("g") Format Specifier

Der Standardformatbezeichner "g" stellt eine Kombination aus dem Muster für kurzes Datum ("d") und dem Muster für kurze Zeit ("t") getrennt durch ein Leerzeichen dar.The "g" standard format specifier represents a combination of the short date ("d") and short time ("t") patterns, separated by a space.

Die Ergebniszeichenfolge wird von den Formatierungsinformationen eines bestimmten DateTimeFormatInfo-Objekts beeinflusst.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. In der folgenden Tabelle sind die DateTimeFormatInfo-Objekteigenschaften aufgeführt, die die Formatierung der zurückgegebenen Zeichenfolge steuern können.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. Der von der DateTimeFormatInfo.ShortDatePattern-Eigenschaft und der DateTimeFormatInfo.ShortTimePattern-Eigenschaft einiger Kulturen zurückgegebene benutzerdefinierte Formatbezeichner nutzt möglicherweise nicht alle Eigenschaften.The custom format specifier that is returned by the DateTimeFormatInfo.ShortDatePattern and DateTimeFormatInfo.ShortTimePattern properties of some cultures may not make use of all properties.

EigenschaftProperty BESCHREIBUNGDescription
ShortDatePattern Definiert das Format der Datumskomponente der Ergebniszeichenfolge.Defines the format of the date component of the result string.
ShortTimePattern Definiert das Format der Zeitkomponente der Ergebniszeichenfolge.Defines the format of the time component of the result string.
DateSeparator Definiert die Zeichenfolge, die die Komponenten Jahr, Monat und Tag eines Datums trennt.Defines the string that separates the year, month, and day components of a date.
TimeSeparator Definiert die Zeichenfolge, die die Komponenten Stunde, Minute und Sekunde einer Uhrzeit trennt.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Definiert die Zeichenfolge, die Zeiten zwischen Mitternacht und Mittag im 12-Stunden-Format angibt.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Definiert die Zeichenfolge, die Zeiten zwischen Mittag und Mitternacht im 12-Stunden-Format angibt.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

Im folgenden Beispiel wird der g-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.The following example uses the "g" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("g", 
                  DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008 06:30                      
Console.WriteLine(date1.ToString("g", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays 4/10/2008 6:30 AM                       
Console.WriteLine(date1.ToString("g", 
                  CultureInfo.CreateSpecificCulture("fr-BE")));
// Displays 10/04/2008 6:30                        
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("g", _
                  DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008 06:30                      
Console.WriteLine(date1.ToString("g", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays 4/10/2008 6:30 AM                       
Console.WriteLine(date1.ToString("g", _
                  CultureInfo.CreateSpecificCulture("fr-BE")))
' Displays 10/04/2008 6:30                        

Zurück zur TabelleBack to table

Der allgemeine Formatbezeichner "G" für Datum und lange ZeitThe General Date Long Time ("G") Format Specifier

Der Standardformatbezeichner "G" stellt eine Kombination aus dem Muster für kurzes Datum ("d") und dem Muster für lange Zeit ("T") getrennt durch ein Leerzeichen dar.The "G" standard format specifier represents a combination of the short date ("d") and long time ("T") patterns, separated by a space.

Die Ergebniszeichenfolge wird von den Formatierungsinformationen eines bestimmten DateTimeFormatInfo-Objekts beeinflusst.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. In der folgenden Tabelle sind die DateTimeFormatInfo-Objekteigenschaften aufgeführt, die die Formatierung der zurückgegebenen Zeichenfolge steuern können.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. Der von der DateTimeFormatInfo.ShortDatePattern-Eigenschaft und der DateTimeFormatInfo.LongTimePattern-Eigenschaft einiger Kulturen zurückgegebene benutzerdefinierte Formatbezeichner nutzt möglicherweise nicht alle Eigenschaften.The custom format specifier that is returned by the DateTimeFormatInfo.ShortDatePattern and DateTimeFormatInfo.LongTimePattern properties of some cultures may not make use of all properties.

EigenschaftProperty BESCHREIBUNGDescription
ShortDatePattern Definiert das Format der Datumskomponente der Ergebniszeichenfolge.Defines the format of the date component of the result string.
LongTimePattern Definiert das Format der Zeitkomponente der Ergebniszeichenfolge.Defines the format of the time component of the result string.
DateSeparator Definiert die Zeichenfolge, die die Komponenten Jahr, Monat und Tag eines Datums trennt.Defines the string that separates the year, month, and day components of a date.
TimeSeparator Definiert die Zeichenfolge, die die Komponenten Stunde, Minute und Sekunde einer Uhrzeit trennt.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Definiert die Zeichenfolge, die Zeiten zwischen Mitternacht und Mittag im 12-Stunden-Format angibt.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Definiert die Zeichenfolge, die Zeiten zwischen Mittag und Mitternacht im 12-Stunden-Format angibt.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

Im folgenden Beispiel wird der G-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.The following example uses the "G" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("G", 
                  DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008 06:30:00
Console.WriteLine(date1.ToString("G", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays 4/10/2008 6:30:00 AM                        
Console.WriteLine(date1.ToString("G", 
                  CultureInfo.CreateSpecificCulture("nl-BE")));
// Displays 10/04/2008 6:30:00                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("G", _
                  DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008 06:30:00
Console.WriteLine(date1.ToString("G", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays 4/10/2008 6:30:00 AM                        
Console.WriteLine(date1.ToString("G", _
                  CultureInfo.CreateSpecificCulture("nl-BE")))
' Displays 10/04/2008 6:30:00                       

Zurück zur TabelleBack to table

Der Formatbezeichner "M", "m" für den MonatThe Month ("M", "m") Format Specifier

Der Standardformatbezeichner "M" oder "m" stellt eine benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit dar, die von der aktuellen DateTimeFormatInfo.MonthDayPattern-Eigenschaft definiert wird.The "M" or "m" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.MonthDayPattern property. Die benutzerdefinierte Formatzeichenfolge für die invariante Kultur lautet beispielsweise "MMMM dd".For example, the custom format string for the invariant culture is "MMMM dd".

In der folgenden Tabellen sind die DateTimeFormatInfo-Objekteigenschaften aufgeführt, die die Formatierung der zurückgegebenen Zeichenfolge steuern.The following table lists the DateTimeFormatInfo object properties that control the formatting of the returned string.

EigenschaftProperty BESCHREIBUNGDescription
MonthDayPattern Definiert das Gesamtformat der Ergebniszeichenfolge.Defines the overall format of the result string.
MonthNames Definiert die lokalisierten Monatsnamen, die in der Ergebniszeichenfolge vorkommen können.Defines the localized month names that can appear in the result string.

Im folgenden Beispiel wird der m-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.The following example uses the "m" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("m", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays April 10                        
Console.WriteLine(date1.ToString("m", 
                  CultureInfo.CreateSpecificCulture("ms-MY")));
// Displays 10 April                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("m", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays April 10                        
Console.WriteLine(date1.ToString("m", _
                  CultureInfo.CreateSpecificCulture("ms-MY")))
' Displays 10 April                       

Zurück zur TabelleBack to table

Der Formatbezeichner "O", "o" für RoundtripsThe Round-trip ("O", "o") Format Specifier

Der Standardformatbezeichner "O" oder "o" stellt eine benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit unter Verwendung eines Musters dar, bei dem die Zeitzoneninformationen beibehalten werden, und gibt eine Ergebniszeichenfolge aus, die die Anforderungen von ISO 8601 erfüllt.The "O" or "o" standard format specifier represents a custom date and time format string using a pattern that preserves time zone information and emits a result string that complies with ISO 8601. Für DateTime-Werte wurde diese Formatzeichenfolge entwickelt, um Datums- und Uhrzeitwerte zusammen mit der DateTime.Kind-Eigenschaft in Text beizubehalten.For DateTime values, this format specifier is designed to preserve date and time values along with the DateTime.Kind property in text. Die formatierte Zeichenfolge kann mit der DateTime.Parse(String, IFormatProvider, DateTimeStyles)-Methode oder mit DateTime.ParseExact-Methode rückkonvertiert werden, wenn der styles-Parameter auf DateTimeStyles.RoundtripKind festgelegt wird.The formatted string can be parsed back by using the DateTime.Parse(String, IFormatProvider, DateTimeStyles) or DateTime.ParseExact method if the styles parameter is set to DateTimeStyles.RoundtripKind.

Der Standardformatbezeichner "O" oder "o" entspricht der benutzerdefinierten Formatzeichenfolge "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK" für DateTime-Werte und der benutzerdefinierten Formatzeichenfolge "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzzz" für DateTimeOffset-Werte.The "O" or "o" standard format specifier corresponds to the "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK" custom format string for DateTime values and to the "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzzz" custom format string for DateTimeOffset values. In dieser Zeichenfolge signalisieren die einfachen Anführungszeichen, die einzelne Zeichen wie Bindestriche, Doppelpunkte oder den Buchstaben "T" begrenzen, dass das einzelne Zeichen ein Literal ist, das nicht geändert werden kann.In this string, the pairs of single quotation marks that delimit individual characters, such as the hyphens, the colons, and the letter "T", indicate that the individual character is a literal that cannot be changed. Die Anführungszeichen werden nicht in der Ausgabezeichenfolge angezeigt.The apostrophes do not appear in the output string.

Der Standardformatbezeichner „O“ oder „o“ (und die benutzerdefinierte Formatzeichenfolge „yyyy'-'MM'-'dd'T'HH':'mm':'ss'.fffffffK“) nutzt die drei Methoden, mit denen ISO 8601 Zeitzoneninformationen darstellt, um die Kind-Eigenschaft der DateTime-Werte beizubehalten:The "O" or "o" standard format specifier (and the "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK" custom format string) takes advantage of the three ways that ISO 8601 represents time zone information to preserve the Kind property of DateTime values:

  • Die Zeitzonenkomponente der DateTimeKind.Local-Datums- und Uhrzeitwerte ist ein Offset von UTC (z. B. +01:00, -07:00).The time zone component of DateTimeKind.Local date and time values is an offset from UTC (for example, +01:00, -07:00). Alle DateTimeOffset-Werte sind auch in diesem Format dargestellt.All DateTimeOffset values are also represented in this format.

  • Die Zeitzonenkomponente der DateTimeKind.Utc-Datums- und Uhrzeitwerte verwendet "Z" (null Offset), um UTC darzustellen.The time zone component of DateTimeKind.Utc date and time values uses "Z" (which stands for zero offset) to represent UTC.

  • DateTimeKind.Unspecified-Datums- und Uhrzeitwerte enthalten keine Zeitzoneninformationen.DateTimeKind.Unspecified date and time values have no time zone information.

Da der Standardformatbezeichner „O“ oder „o“ einem internationalen Standard entspricht, nutzt der Formatierungs- oder Analysevorgang, der den Bezeichner verwendet, stets die invariante Kultur und den gregorianischen Kalender.Because the "O" or "o" standard format specifier conforms to an international standard, the formatting or parsing operation that uses the specifier always uses the invariant culture and the Gregorian calendar.

Zeichenfolgen, die an die Parse-, TryParse-, ParseExact und TryParseExact-Methoden von DateTime und DateTimeOffset weitergegeben werden, können mit dem Formatbezeichner "O" oder "o" analysiert werden, wenn sie in einem dieser Formate vorliegen.Strings that are passed to the Parse, TryParse, ParseExact, and TryParseExact methods of DateTime and DateTimeOffset can be parsed by using the "O" or "o" format specifier if they are in one of these formats. Bei DateTime-Objekten sollte die Überladung, die Sie aufrufen, auch einen styles-Parameter mit einem Wert von DateTimeStyles.RoundtripKind enthalten.In the case of DateTime objects, the parsing overload that you call should also include a styles parameter with a value of DateTimeStyles.RoundtripKind. Beachten Sie, dass Sie durch Aufrufen einer Analysemethode mit der benutzerdefinierten Formatzeichenfolge, die dem Formatbezeichner "O" oder "o" entspricht, nicht die gleichen Ergebnisse wie "O" oder "o" erhalten.Note that if you call a parsing method with the custom format string that corresponds to the "O" or "o" format specifier, you won't get the same results as "O" or "o". Der Grund dafür ist, dass Analysemethoden, die benutzerdefinierte Formatzeichenfolgen verwenden, die Zeichenfolgendarstellung von Datums- und Zeitwerten nicht analysieren können, wenn diese keine Zeitzonenkomponente enthalten oder "Z" zur Angabe von UTC verwenden.This is because parsing methods that use a custom format string can't parse the string representation of date and time values that lack a time zone component or use "Z" to indicate UTC.

Sie sehen im folgenden Beispiel, dass der „o“-Formatbezeichner zum Anzeigen einer Reihe von DateTime-Werten und eines DateTimeOffset-Werts in einem System in der Zeitzone Pacific verwendet wird.The following example uses the "o" format specifier to display a series of DateTime values and a DateTimeOffset value on a system in the U.S. Pacific Time zone.

using System;

public class Example
{
   public static void Main()
   {
       DateTime dat = new DateTime(2009, 6, 15, 13, 45, 30, 
                                   DateTimeKind.Unspecified);
       Console.WriteLine("{0} ({1}) --> {0:O}", dat, dat.Kind); 
   
       DateTime uDat = new DateTime(2009, 6, 15, 13, 45, 30, 
                                    DateTimeKind.Utc);
       Console.WriteLine("{0} ({1}) --> {0:O}", uDat, uDat.Kind);
       
       DateTime lDat = new DateTime(2009, 6, 15, 13, 45, 30, 
                                    DateTimeKind.Local);
       Console.WriteLine("{0} ({1}) --> {0:O}\n", lDat, lDat.Kind);
       
       DateTimeOffset dto = new DateTimeOffset(lDat);
       Console.WriteLine("{0} --> {0:O}", dto);
   }
}
// The example displays the following output:
//    6/15/2009 1:45:30 PM (Unspecified) --> 2009-06-15T13:45:30.0000000
//    6/15/2009 1:45:30 PM (Utc) --> 2009-06-15T13:45:30.0000000Z
//    6/15/2009 1:45:30 PM (Local) --> 2009-06-15T13:45:30.0000000-07:00
//    
//    6/15/2009 1:45:30 PM -07:00 --> 2009-06-15T13:45:30.0000000-07:00
Module Example
   Public Sub Main()
       Dim dat As New Date(2009, 6, 15, 13, 45, 30, 
                           DateTimeKind.Unspecified)
       Console.WriteLine("{0} ({1}) --> {0:O}", dat, dat.Kind) 
   
       Dim uDat As New Date(2009, 6, 15, 13, 45, 30, DateTimeKind.Utc)
       Console.WriteLine("{0} ({1}) --> {0:O}", uDat, uDat.Kind)
       
       Dim lDat As New Date(2009, 6, 15, 13, 45, 30, DateTimeKind.Local)
       Console.WriteLine("{0} ({1}) --> {0:O}", lDat, lDat.Kind)
       Console.WriteLine()
       
       Dim dto As New DateTimeOffset(lDat)
       Console.WriteLine("{0} --> {0:O}", dto)
   End Sub
End Module
' The example displays the following output:
'    6/15/2009 1:45:30 PM (Unspecified) --> 2009-06-15T13:45:30.0000000
'    6/15/2009 1:45:30 PM (Utc) --> 2009-06-15T13:45:30.0000000Z
'    6/15/2009 1:45:30 PM (Local) --> 2009-06-15T13:45:30.0000000-07:00
'    
'    6/15/2009 1:45:30 PM -07:00 --> 2009-06-15T13:45:30.0000000-07:00

Im folgenden Beispiel wird der o-Formatbezeichner verwendet, um eine formatierte Zeichenfolge zu erstellen, und anschließend wird der ursprüngliche Datums- und Uhrzeitwert wiederhergestellt, indem eine Parse-Methode für Datum und Uhrzeit aufgerufen wird.The following example uses the "o" format specifier to create a formatted string, and then restores the original date and time value by calling a date and time Parse method.

// Round-trip DateTime values.
DateTime originalDate, newDate;
string dateString;
// Round-trip a local time.
originalDate = DateTime.SpecifyKind(new DateTime(2008, 4, 10, 6, 30, 0), DateTimeKind.Local);
dateString = originalDate.ToString("o");
newDate = DateTime.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, 
                  newDate, newDate.Kind);
// Round-trip a UTC time.
originalDate = DateTime.SpecifyKind(new DateTime(2008, 4, 12, 9, 30, 0), DateTimeKind.Utc);                  
dateString = originalDate.ToString("o");
newDate = DateTime.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, 
                  newDate, newDate.Kind);
// Round-trip time in an unspecified time zone.
originalDate = DateTime.SpecifyKind(new DateTime(2008, 4, 13, 12, 30, 0), DateTimeKind.Unspecified);                  
dateString = originalDate.ToString("o");
newDate = DateTime.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, 
                  newDate, newDate.Kind);

// Round-trip a DateTimeOffset value.
DateTimeOffset originalDTO = new DateTimeOffset(2008, 4, 12, 9, 30, 0, new TimeSpan(-8, 0, 0));
dateString = originalDTO.ToString("o");
DateTimeOffset newDTO = DateTimeOffset.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine("Round-tripped {0} to {1}.", originalDTO, newDTO);
// The example displays the following output:
//    Round-tripped 4/10/2008 6:30:00 AM Local to 4/10/2008 6:30:00 AM Local.
//    Round-tripped 4/12/2008 9:30:00 AM Utc to 4/12/2008 9:30:00 AM Utc.
//    Round-tripped 4/13/2008 12:30:00 PM Unspecified to 4/13/2008 12:30:00 PM Unspecified.
//    Round-tripped 4/12/2008 9:30:00 AM -08:00 to 4/12/2008 9:30:00 AM -08:00.
' Round-trip DateTime values.
Dim originalDate, newDate As Date
Dim dateString As String
' Round-trip a local time.
originalDate = Date.SpecifyKind(#4/10/2008 6:30AM#, DateTimeKind.Local)
dateString = originalDate.ToString("o")
newDate = Date.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, _
                  newDate, newDate.Kind)
' Round-trip a UTC time.
originalDate = Date.SpecifyKind(#4/12/2008 9:30AM#, DateTimeKind.Utc)                  
dateString = originalDate.ToString("o")
newDate = Date.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, _
                  newDate, newDate.Kind)
' Round-trip time in an unspecified time zone.
originalDate = Date.SpecifyKind(#4/13/2008 12:30PM#, DateTimeKind.Unspecified)                  
dateString = originalDate.ToString("o")
newDate = Date.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, _
                  newDate, newDate.Kind)

' Round-trip a DateTimeOffset value.
Dim originalDTO As New DateTimeOffset(#4/12/2008 9:30AM#, New TimeSpan(-8, 0, 0))
dateString = originalDTO.ToString("o")
Dim newDTO As DateTimeOffset = DateTimeOffset.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} to {1}.", originalDTO, newDTO)
' The example displays the following output:
'    Round-tripped 4/10/2008 6:30:00 AM Local to 4/10/2008 6:30:00 AM Local.
'    Round-tripped 4/12/2008 9:30:00 AM Utc to 4/12/2008 9:30:00 AM Utc.
'    Round-tripped 4/13/2008 12:30:00 PM Unspecified to 4/13/2008 12:30:00 PM Unspecified.
'    Round-tripped 4/12/2008 9:30:00 AM -08:00 to 4/12/2008 9:30:00 AM -08:00.

Zurück zur TabelleBack to table

Der RFC1123-Formatbezeichner "R", "r"The RFC1123 ("R", "r") Format Specifier

Der Standardformatbezeichner "R" oder "r" stellt eine benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit dar, die von der aktuellen DateTimeFormatInfo.RFC1123Pattern-Eigenschaft definiert wird.The "R" or "r" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.RFC1123Pattern property. Bei dem Muster handelt es sich um einen definierten Standard. Die Eigenschaft ist schreibgeschützt.The pattern reflects a defined standard, and the property is read-only. Es ist daher unabhängig von der verwendeten Kultur oder dem bereitgestellten Formatanbieter immer identisch.Therefore, it is always the same, regardless of the culture used or the format provider supplied. Die benutzerdefinierte Formatzeichenfolge lautet "ddd, dd MMM yyyy HH':'mm':'ss 'GMT'".The custom format string is "ddd, dd MMM yyyy HH':'mm':'ss 'GMT'". Wenn dieser Standardformatbezeichner verwendet wird, wird bei der Formatierungs- oder Analysemethode immer die invariante Kultur verwendet.When this standard format specifier is used, the formatting or parsing operation always uses the invariant culture.

Die Ergebniszeichenfolge wird von den folgenden Eigenschaften des DateTimeFormatInfo-Objekts beeinflusst, die von der DateTimeFormatInfo.InvariantInfo-Eigenschaft zurückgegeben wurden, die die invariante Kultur darstellt.The result string is affected by the following properties of the DateTimeFormatInfo object returned by the DateTimeFormatInfo.InvariantInfo property that represents the invariant culture.

EigenschaftProperty BESCHREIBUNGDescription
RFC1123Pattern Definiert das Format der Ergebniszeichenfolge.Defines the format of the result string.
AbbreviatedDayNames Definiert die abgekürzten Tagesnamen, die in der Ergebniszeichenfolge vorkommen können.Defines the abbreviated day names that can appear in the result string.
AbbreviatedMonthNames Definiert die abgekürzten Monatsnamen, die in der Ergebniszeichenfolge vorkommen können.Defines the abbreviated month names that can appear in the result string.

Auch wenn eine Zeitangabe gemäß der RFC-Spezifikation 1123 als koordinierte Weltzeit (UTC) ausgedrückt wird, wird der Wert des DateTime-Objekts, das formatiert wird, durch den Formatierungsvorgang nicht geändert.Although the RFC 1123 standard expresses a time as Coordinated Universal Time (UTC), the formatting operation does not modify the value of the DateTime object that is being formatted. Daher müssen Sie den DateTime-Wert in UTC konvertieren. Rufen Sie hierfür die DateTime.ToUniversalTime-Methode auf, bevor Sie den Formatierungsvorgang ausführen.Therefore, you must convert the DateTime value to UTC by calling the DateTime.ToUniversalTime method before you perform the formatting operation. Im Gegensatz dazu wird diese Konvertierung durch DateTimeOffset-Werte automatisch ausgeführt, und es besteht keine Notwendigkeit, die DateTimeOffset.ToUniversalTime-Methode vor Ausführung des Formatierungsvorgangs aufzurufen.In contrast, DateTimeOffset values perform this conversion automatically; there is no need to call the DateTimeOffset.ToUniversalTime method before the formatting operation.

Sie sehen im folgenden Beispiel, dass der „r“-Formatbezeichner zum Anzeigen eines DateTime-Werts und eines DateTimeOffset-Werts in einem System in der Zeitzone Pacific verwendet wird.The following example uses the "r" format specifier to display a DateTime and a DateTimeOffset value on a system in the U.S. Pacific Time zone.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
DateTimeOffset dateOffset = new DateTimeOffset(date1, 
                            TimeZoneInfo.Local.GetUtcOffset(date1));
Console.WriteLine(date1.ToUniversalTime().ToString("r"));
// Displays Thu, 10 Apr 2008 13:30:00 GMT                       
Console.WriteLine(dateOffset.ToUniversalTime().ToString("r"));
// Displays Thu, 10 Apr 2008 13:30:00 GMT                        
Dim date1 As Date = #4/10/2008 6:30AM#
Dim dateOffset As New DateTimeOffset(date1, TimeZoneInfo.Local.GetUtcOFfset(date1))
Console.WriteLine(date1.ToUniversalTime.ToString("r"))
' Displays Thu, 10 Apr 2008 13:30:00 GMT                       
Console.WriteLine(dateOffset.ToUniversalTime.ToString("r"))
' Displays Thu, 10 Apr 2008 13:30:00 GMT                        

Zurück zur TabelleBack to table

Der sortierbare Formatbezeichner "s"The Sortable ("s") Format Specifier

Der Standardformatbezeichner "s" stellt eine benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit dar, die von der aktuellen DateTimeFormatInfo.SortableDateTimePattern-Eigenschaft definiert wird.The "s" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.SortableDateTimePattern property. Bei dem Muster handelt es sich um einen definierten Standard (ISO 8601). Die Eigenschaft ist schreibgeschützt.The pattern reflects a defined standard (ISO 8601), and the property is read-only. Es ist daher unabhängig von der verwendeten Kultur oder dem bereitgestellten Formatanbieter immer identisch.Therefore, it is always the same, regardless of the culture used or the format provider supplied. Die benutzerdefinierte Formatzeichenfolge lautet "yyyy'-'MM'-'dd'T'HH':'mm':'ss".The custom format string is "yyyy'-'MM'-'dd'T'HH':'mm':'ss".

Der Formatbezeichner "s" dient dazu, Ergebniszeichenfolgen zu generieren, die konsistent in aufsteigender oder absteigender Reihenfolge auf der Grundlage von Datums-und Uhrzeitwerten sortieren.The purpose of the "s" format specifier is to produce result strings that sort consistently in ascending or descending order based on date and time values. Obwohl der Standardformatbezeichner "s" einen Datums- und Uhrzeitwert in einem konsistenten Format darstellt, ändert der Formatierungsvorgang daher nicht den Wert des Datums- und Uhrzeitobjekts, das formatiert wird, entsprechend seiner Eigenschaft DateTime.Kind oder seines Werts DateTimeOffset.Offset.As a result, although the "s" standard format specifier represents a date and time value in a consistent format, the formatting operation does not modify the value of the date and time object that is being formatted to reflect its DateTime.Kind property or its DateTimeOffset.Offset value. Die Ergebniszeichenfolgen, die durch Formatieren der Datums- und Uhrzeitwerte 2014-11-15T18:32:17+00:00 und 2014-11-15T18:32:17+08:00 generiert werden, sind z. B. identisch.For example, the result strings produced by formatting the date and time values 2014-11-15T18:32:17+00:00 and 2014-11-15T18:32:17+08:00 are identical.

Wenn dieser Standardformatbezeichner verwendet wird, wird bei der Formatierungs- oder Analysemethode immer die invariante Kultur verwendet.When this standard format specifier is used, the formatting or parsing operation always uses the invariant culture.

Sie sehen im folgenden Beispiel, dass der „s“-Formatbezeichner zum Anzeigen eines DateTime-Werts und eines DateTimeOffset-Werts in einem System in der Zeitzone Pacific verwendet wird.The following example uses the "s" format specifier to display a DateTime and a DateTimeOffset value on a system in the U.S. Pacific Time zone.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("s"));
// Displays 2008-04-10T06:30:00                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("s"))
' Displays 2008-04-10T06:30:00                       

Zurück zur TabelleBack to table

Der Formatbezeichner "t" für kurze ZeitThe Short Time ("t") Format Specifier

Der Standardformatbezeichner "t" stellt eine benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit dar, die von der aktuellen DateTimeFormatInfo.ShortTimePattern-Eigenschaft definiert wird.The "t" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.ShortTimePattern property. Die benutzerdefinierte Formatzeichenfolge für die invariante Kultur lautet beispielsweise "HH:mm".For example, the custom format string for the invariant culture is "HH:mm".

Die Ergebniszeichenfolge wird von den Formatierungsinformationen eines bestimmten DateTimeFormatInfo-Objekts beeinflusst.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. In der folgenden Tabelle sind die DateTimeFormatInfo-Objekteigenschaften aufgeführt, die die Formatierung der zurückgegebenen Zeichenfolge steuern können.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. Der von der DateTimeFormatInfo.ShortTimePattern-Eigenschaft einiger Kulturen zurückgegebene benutzerdefinierte Formatbezeichner nutzt möglicherweise nicht alle Eigenschaften.The custom format specifier that is returned by the DateTimeFormatInfo.ShortTimePattern property of some cultures may not make use of all properties.

EigenschaftProperty BESCHREIBUNGDescription
ShortTimePattern Definiert das Format der Zeitkomponente der Ergebniszeichenfolge.Defines the format of the time component of the result string.
TimeSeparator Definiert die Zeichenfolge, die die Komponenten Stunde, Minute und Sekunde einer Uhrzeit trennt.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Definiert die Zeichenfolge, die Zeiten zwischen Mitternacht und Mittag im 12-Stunden-Format angibt.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Definiert die Zeichenfolge, die Zeiten zwischen Mittag und Mitternacht im 12-Stunden-Format angibt.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

Im folgenden Beispiel wird der t-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.The following example uses the "t" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("t", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays 6:30 AM                        
Console.WriteLine(date1.ToString("t", 
                  CultureInfo.CreateSpecificCulture("es-ES")));
// Displays 6:30                      
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("t", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays 6:30 AM                        
Console.WriteLine(date1.ToString("t", _
                  CultureInfo.CreateSpecificCulture("es-ES")))
' Displays 6:30                      

Zurück zur TabelleBack to table

Der Formatbezeichner "T" für lange ZeitThe Long Time ("T") Format Specifier

Der Standardformatbezeichner "T" stellt eine benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit dar, die von der DateTimeFormatInfo.LongTimePattern-Eigenschaft einer bestimmten Kultur definiert wird.The "T" standard format specifier represents a custom date and time format string that is defined by a specific culture's DateTimeFormatInfo.LongTimePattern property. Die benutzerdefinierte Formatzeichenfolge für die invariante Kultur lautet beispielsweise "HH:mm:ss".For example, the custom format string for the invariant culture is "HH:mm:ss".

In der folgenden Tabelle sind die DateTimeFormatInfo-Objekteigenschaften aufgeführt, die die Formatierung der zurückgegebenen Zeichenfolge steuern können.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. Der von der DateTimeFormatInfo.LongTimePattern-Eigenschaft einiger Kulturen zurückgegebene benutzerdefinierte Formatbezeichner nutzt möglicherweise nicht alle Eigenschaften.The custom format specifier that is returned by the DateTimeFormatInfo.LongTimePattern property of some cultures may not make use of all properties.

EigenschaftProperty BESCHREIBUNGDescription
LongTimePattern Definiert das Format der Zeitkomponente der Ergebniszeichenfolge.Defines the format of the time component of the result string.
TimeSeparator Definiert die Zeichenfolge, die die Komponenten Stunde, Minute und Sekunde einer Uhrzeit trennt.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Definiert die Zeichenfolge, die Zeiten zwischen Mitternacht und Mittag im 12-Stunden-Format angibt.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Definiert die Zeichenfolge, die Zeiten zwischen Mittag und Mitternacht im 12-Stunden-Format angibt.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

Im folgenden Beispiel wird der T-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.The following example uses the "T" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("T", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays 6:30:00 AM                       
Console.WriteLine(date1.ToString("T", 
                  CultureInfo.CreateSpecificCulture("es-ES")));
// Displays 6:30:00                      
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("T", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays 6:30:00 AM                       
Console.WriteLine(date1.ToString("T", _
                  CultureInfo.CreateSpecificCulture("es-ES")))
' Displays 6:30:00                      

Zurück zur TabelleBack to table

Der universelle sortierbare Formatbezeichner "u"The Universal Sortable ("u") Format Specifier

Der Standardformatbezeichner "u" stellt eine benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit dar, die von der aktuellen DateTimeFormatInfo.UniversalSortableDateTimePattern-Eigenschaft definiert wird.The "u" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.UniversalSortableDateTimePattern property. Bei dem Muster handelt es sich um einen definierten Standard. Die Eigenschaft ist schreibgeschützt.The pattern reflects a defined standard, and the property is read-only. Es ist daher unabhängig von der verwendeten Kultur oder dem bereitgestellten Formatanbieter immer identisch.Therefore, it is always the same, regardless of the culture used or the format provider supplied. Die benutzerdefinierte Formatzeichenfolge lautet "yyyy'-'MM'-'dd HH':'mm':'ss'Z'".The custom format string is "yyyy'-'MM'-'dd HH':'mm':'ss'Z'". Wenn dieser Standardformatbezeichner verwendet wird, wird bei der Formatierungs- oder Analysemethode immer die invariante Kultur verwendet.When this standard format specifier is used, the formatting or parsing operation always uses the invariant culture.

Obwohl die Ergebniszeichenfolge eine Zeitangabe als koordinierte Weltzeit (UTC) ausdrücken soll, wird der ursprüngliche DateTime-Wert während des Formatierungsvorgangs nicht konvertiert.Although the result string should express a time as Coordinated Universal Time (UTC), no conversion of the original DateTime value is performed during the formatting operation. Daher müssen Sie einen DateTime-Wert in UTC konvertieren, indem Sie die DateTime.ToUniversalTime-Methode vor dem Formatieren aufrufen.Therefore, you must convert a DateTime value to UTC by calling the DateTime.ToUniversalTime method before formatting it. Im Gegensatz dazu wird diese Konvertierung durch DateTimeOffset-Werte automatisch ausgeführt, und es besteht keine Notwendigkeit, die DateTimeOffset.ToUniversalTime-Methode vor Ausführung des Formatierungsvorgangs aufzurufen.In contrast, DateTimeOffset values perform this conversion automatically; there is no need to call the DateTimeOffset.ToUniversalTime method before the formatting operation.

Im folgenden Beispiel wird der u-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.The following example uses the "u" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToUniversalTime().ToString("u"));
// Displays 2008-04-10 13:30:00Z                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToUniversalTime.ToString("u"))
' Displays 2008-04-10 13:30:00Z                       

Zurück zur TabelleBack to table

Der universelle vollständige Formatbezeichner "U"The Universal Full ("U") Format Specifier

Der Standardformatbezeichner "U" stellt eine benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit dar, die von der DateTimeFormatInfo.FullDateTimePattern-Eigenschaft einer angegebenen Kultur definiert wird.The "U" standard format specifier represents a custom date and time format string that is defined by a specified culture's DateTimeFormatInfo.FullDateTimePattern property. Das Muster ist gleich dem F-Muster.The pattern is the same as the "F" pattern. Der DateTime-Wert wird jedoch vor der Formatierung automatisch in UTC konvertiert.However, the DateTime value is automatically converted to UTC before it is formatted.

In der folgenden Tabelle sind die DateTimeFormatInfo-Objekteigenschaften aufgeführt, die die Formatierung der zurückgegebenen Zeichenfolge steuern können.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. Der von der FullDateTimePattern-Eigenschaft einiger Kulturen zurückgegebene benutzerdefinierte Formatbezeichner nutzt möglicherweise nicht alle Eigenschaften.The custom format specifier that is returned by the FullDateTimePattern property of some cultures may not make use of all properties.

EigenschaftProperty BESCHREIBUNGDescription
FullDateTimePattern Definiert das Gesamtformat der Ergebniszeichenfolge.Defines the overall format of the result string.
DayNames Definiert die lokalisierten Tagesnamen, die in der Ergebniszeichenfolge vorkommen können.Defines the localized day names that can appear in the result string.
MonthNames Definiert die lokalisierten Monatsnamen, die in der Ergebniszeichenfolge vorkommen können.Defines the localized month names that can appear in the result string.
TimeSeparator Definiert die Zeichenfolge, die die Komponenten Stunde, Minute und Sekunde einer Uhrzeit trennt.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Definiert die Zeichenfolge, die Zeiten zwischen Mitternacht und Mittag im 12-Stunden-Format angibt.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Definiert die Zeichenfolge, die Zeiten zwischen Mittag und Mitternacht im 12-Stunden-Format angibt.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

Der U-Formatbezeichner wird vom DateTimeOffset-Typ nicht unterstützt und löst eine FormatException aus, wenn er zum Formatieren eines DateTimeOffset-Werts verwendet wird.The "U" format specifier is not supported by the DateTimeOffset type and throws a FormatException if it is used to format a DateTimeOffset value.

Im folgenden Beispiel wird der U-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.The following example uses the "U" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("U", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008 1:30:00 PM                       
Console.WriteLine(date1.ToString("U", 
                  CultureInfo.CreateSpecificCulture("sv-FI")));
// Displays den 10 april 2008 13:30:00                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("U", CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008 1:30:00 PM                       
Console.WriteLine(date1.ToString("U", CultureInfo.CreateSpecificCulture("sv-FI")))
' Displays den 10 april 2008 13:30:00                       

Zurück zur TabelleBack to table

Der Formatbezeichner "Y", "y" für Jahr-MonatThe Year Month ("Y", "y") Format Specifier

Der Standardformatbezeichner "Y" oder "y" stellt eine benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit dar, die von der DateTimeFormatInfo.YearMonthPattern-Eigenschaft einer angegebenen Kultur definiert wird.The "Y" or "y" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.YearMonthPattern property of a specified culture. Die benutzerdefinierte Formatzeichenfolge für die invariante Kultur lautet beispielsweise "yyyy MMMM".For example, the custom format string for the invariant culture is "yyyy MMMM".

In der folgenden Tabellen sind die DateTimeFormatInfo-Objekteigenschaften aufgeführt, die die Formatierung der zurückgegebenen Zeichenfolge steuern.The following table lists the DateTimeFormatInfo object properties that control the formatting of the returned string.

EigenschaftProperty BESCHREIBUNGDescription
YearMonthPattern Definiert das Gesamtformat der Ergebniszeichenfolge.Defines the overall format of the result string.
MonthNames Definiert die lokalisierten Monatsnamen, die in der Ergebniszeichenfolge vorkommen können.Defines the localized month names that can appear in the result string.

Im folgenden Beispiel wird der y-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.The following example uses the "y" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("Y", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays April, 2008                       
Console.WriteLine(date1.ToString("y", 
                  CultureInfo.CreateSpecificCulture("af-ZA")));
// Displays April 2008                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("Y", CultureInfo.CreateSpecificCulture("en-US")))
' Displays April, 2008                       
Console.WriteLine(date1.ToString("y", CultureInfo.CreateSpecificCulture("af-ZA")))
' Displays April 2008                       

Zurück zur TabelleBack to table

HinweiseNotes

Einstellungen der SystemsteuerungControl Panel Settings

Die Einstellungen der Regions- und Sprachoptionen in der Systemsteuerung beeinflussen die durch einen Formatierungsvorgang erstellte Ergebniszeichenfolge.The settings in the Regional and Language Options item in Control Panel influence the result string produced by a formatting operation. Mithilfe dieser Einstellungen wird das DateTimeFormatInfo-Objekt initialisiert, das der aktuellen Threadkultur zugeordnet ist. Sie stellt Werte zur Steuerung der Formatierung bereit.These settings are used to initialize the DateTimeFormatInfo object associated with the current thread culture, which provides values used to govern formatting. Auf Computern mit anderen Einstellungen werden andere Ergebniszeichenfolgen generiert.Computers that use different settings generate different result strings.

Wenn der CultureInfo.CultureInfo(String) -Constructor verwendet wird, um ein neues CultureInfo -Objekt zu instanziieren, das dieselbe Kultur repräsentiert wie die aktuelle Systemkultur, werden darüber hinaus alle Anpassungen, die über die Einstellung Regions- und Sprachoptionen in der Systemsteuerung eingerichtet werden, auf das neue CultureInfo -Objekt angewendet.In addition, if you use the CultureInfo.CultureInfo(String) constructor to instantiate a new CultureInfo object that represents the same culture as the current system culture, any customizations established by the Regional and Language Options item in Control Panel will be applied to the new CultureInfo object. Sie können den CultureInfo.CultureInfo(String, Boolean) -Konstruktor verwenden, um ein CultureInfo -Objekt zu erstellen, das die Anpassungen eines Systems nicht wiedergibt.You can use the CultureInfo.CultureInfo(String, Boolean) constructor to create a CultureInfo object that does not reflect a system's customizations.

DateTimeFormatInfo-EigenschaftenDateTimeFormatInfo Properties

Die Formatierung wird durch die Eigenschaften des aktuellen DateTimeFormatInfo-Objekts beeinflusst, das implizit durch die aktuelle Threadkultur oder explizit durch den IFormatProvider-Parameter der Methode bereitgestellt wird, die die Formatierung aufruft.Formatting is influenced by properties of the current DateTimeFormatInfo object, which is provided implicitly by the current thread culture or explicitly by the IFormatProvider parameter of the method that invokes formatting. Für den IFormatProvider-Parameter sollte Ihre Anwendung ein CultureInfo-Objekt angeben, das eine Kultur darstellt, oder ein DateTimeFormatInfo-Objekt, das die Formatierungskonventionen für Datum und Uhrzeit einer bestimmten Kultur darstellt.For the IFormatProvider parameter, your application should specify a CultureInfo object, which represents a culture, or a DateTimeFormatInfo object, which represents a particular culture's date and time formatting conventions. Bei vielen der Standardformatbezeichner für Datum und Uhrzeit handelt es sich um Aliase für Formatierungsmuster, die durch Eigenschaften des aktuellen DateTimeFormatInfo-Objekts definiert werden.Many of the standard date and time format specifiers are aliases for formatting patterns defined by properties of the current DateTimeFormatInfo object. Die Anwendung kann das von einigen Standardformatbezeichner für Datum und Uhrzeit erstellte Ergebnis ändern, indem sie die entsprechenden Formatmuster für Datum und Uhrzeit der entsprechenden DateTimeFormatInfo-Eigenschaft ändert.Your application can change the result produced by some standard date and time format specifiers by changing the corresponding date and time format patterns of the corresponding DateTimeFormatInfo property.

Siehe auchSee also