DateTime.ToString DateTime.ToString DateTime.ToString DateTime.ToString Method

Definition

Konvertiert den Wert des aktuellen DateTime-Objekts in die entsprechende Zeichenfolgendarstellung.Converts the value of the current DateTime object to its equivalent string representation.

Überlädt

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Konvertiert den Wert des aktuellen DateTime-Objekts unter Verwendung des angegebenen Formats sowie der kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.Converts the value of the current DateTime object to its equivalent string representation using the specified format and culture-specific format information.

ToString(String) ToString(String) ToString(String) ToString(String)

Konvertiert den Wert des aktuellen DateTime-Objekts unter Verwendung des angegebenen Formats und der Formatierungskonventionen der aktuellen Kultur in die entsprechende Zeichenfolgendarstellung.Converts the value of the current DateTime object to its equivalent string representation using the specified format and the formatting conventions of the current culture.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Konvertiert den Wert des aktuellen DateTime-Objekts unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.Converts the value of the current DateTime object to its equivalent string representation using the specified culture-specific format information.

ToString() ToString() ToString() ToString()

Konvertiert den Wert des aktuellen DateTime-Objekts unter Verwendung der Formatierungskonventionen der aktuellen Kultur in die entsprechende Zeichenfolgendarstellung.Converts the value of the current DateTime object to its equivalent string representation using the formatting conventions of the current culture.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Konvertiert den Wert des aktuellen DateTime-Objekts unter Verwendung des angegebenen Formats sowie der kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.Converts the value of the current DateTime object to its equivalent string representation using the specified format and culture-specific format information.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);
public string ToString (string format, IFormatProvider provider);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String

Parameter

format
String String String String

Eine Standard- oder benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit.A standard or custom date and time format string.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.An object that supplies culture-specific formatting information.

Gibt zurück

Die Zeichenfolgendarstellung des Werts des aktuellen DateTime-Objekts entsprechend der Angabe in format und provider.A string representation of value of the current DateTime object as specified by format and provider.

Implementiert

Ausnahmen

Die Länge des format ist 1, und es ist keines der Formatbezeichnerzeichen, die für DateTimeFormatInfo definiert sind.The length of format is 1, and it is not one of the format specifier characters defined for DateTimeFormatInfo.

- oder --or- format enthält kein gültiges benutzerdefiniertes Formatmuster.format does not contain a valid custom format pattern.

Datum und Uhrzeit liegen außerhalb des Bereichs von Datumsangaben, die vom Kalender unterstützt werden, der von provider verwendet wird.The date and time is outside the range of dates supported by the calendar used by provider.

Beispiele

Im folgenden Beispiel wird jede der standardmäßigen Datums-/uhrzeitformatzeichenfolgen verwendet, um die Zeichen folgen Darstellung eines Datums und einer Uhrzeit für vier verschiedene Kulturen anzuzeigen.The following example uses each of the standard date time format strings to display the string representation of a date and time for four different cultures.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Create an array of all supported standard date and time format specifiers.
      string[] formats = {"d", "D", "f", "F", "g", "G", "m", "o", "r", 
                          "s", "t", "T", "u", "U", "Y"};
      // Create an array of four cultures.                                 
      CultureInfo[] cultures = {CultureInfo.CreateSpecificCulture("de-DE"), 
                                CultureInfo.CreateSpecificCulture("en-US"), 
                                CultureInfo.CreateSpecificCulture("es-ES"), 
                                CultureInfo.CreateSpecificCulture("fr-FR")};
       // Define date to be displayed.
      DateTime dateToDisplay = new DateTime(2008, 10, 1, 17, 4, 32);

      // Iterate each standard format specifier.
      foreach (string formatSpecifier in formats)
      {
         foreach (CultureInfo culture in cultures)
            Console.WriteLine("{0} Format Specifier {1, 10} Culture {2, 40}", 
                              formatSpecifier, culture.Name, 
                              dateToDisplay.ToString(formatSpecifier, culture));
         Console.WriteLine();
      }   
   }
}
// The example displays the following output:
//    d Format Specifier      de-DE Culture                               01.10.2008
//    d Format Specifier      en-US Culture                                10/1/2008
//    d Format Specifier      es-ES Culture                               01/10/2008
//    d Format Specifier      fr-FR Culture                               01/10/2008
//    
//    D Format Specifier      de-DE Culture                Mittwoch, 1. Oktober 2008
//    D Format Specifier      en-US Culture              Wednesday, October 01, 2008
//    D Format Specifier      es-ES Culture         miércoles, 01 de octubre de 2008
//    D Format Specifier      fr-FR Culture                  mercredi 1 octobre 2008
//    
//    f Format Specifier      de-DE Culture          Mittwoch, 1. Oktober 2008 17:04
//    f Format Specifier      en-US Culture      Wednesday, October 01, 2008 5:04 PM
//    f Format Specifier      es-ES Culture   miércoles, 01 de octubre de 2008 17:04
//    f Format Specifier      fr-FR Culture            mercredi 1 octobre 2008 17:04
//    
//    F Format Specifier      de-DE Culture       Mittwoch, 1. Oktober 2008 17:04:32
//    F Format Specifier      en-US Culture   Wednesday, October 01, 2008 5:04:32 PM
//    F Format Specifier      es-ES Culture miércoles, 01 de octubre de 2008 17:04:3
//    F Format Specifier      fr-FR Culture         mercredi 1 octobre 2008 17:04:32
//    
//    g Format Specifier      de-DE Culture                         01.10.2008 17:04
//    g Format Specifier      en-US Culture                        10/1/2008 5:04 PM
//    g Format Specifier      es-ES Culture                         01/10/2008 17:04
//    g Format Specifier      fr-FR Culture                         01/10/2008 17:04
//    
//    G Format Specifier      de-DE Culture                      01.10.2008 17:04:32
//    G Format Specifier      en-US Culture                     10/1/2008 5:04:32 PM
//    G Format Specifier      es-ES Culture                      01/10/2008 17:04:32
//    G Format Specifier      fr-FR Culture                      01/10/2008 17:04:32
//    
//    m Format Specifier      de-DE Culture                               01 Oktober
//    m Format Specifier      en-US Culture                               October 01
//    m Format Specifier      es-ES Culture                               01 octubre
//    m Format Specifier      fr-FR Culture                                1 octobre
//    
//    o Format Specifier      de-DE Culture              2008-10-01T17:04:32.0000000
//    o Format Specifier      en-US Culture              2008-10-01T17:04:32.0000000
//    o Format Specifier      es-ES Culture              2008-10-01T17:04:32.0000000
//    o Format Specifier      fr-FR Culture              2008-10-01T17:04:32.0000000
//    
//    r Format Specifier      de-DE Culture            Wed, 01 Oct 2008 17:04:32 GMT
//    r Format Specifier      en-US Culture            Wed, 01 Oct 2008 17:04:32 GMT
//    r Format Specifier      es-ES Culture            Wed, 01 Oct 2008 17:04:32 GMT
//    r Format Specifier      fr-FR Culture            Wed, 01 Oct 2008 17:04:32 GMT
//    
//    s Format Specifier      de-DE Culture                      2008-10-01T17:04:32
//    s Format Specifier      en-US Culture                      2008-10-01T17:04:32
//    s Format Specifier      es-ES Culture                      2008-10-01T17:04:32
//    s Format Specifier      fr-FR Culture                      2008-10-01T17:04:32
//    
//    t Format Specifier      de-DE Culture                                    17:04
//    t Format Specifier      en-US Culture                                  5:04 PM
//    t Format Specifier      es-ES Culture                                    17:04
//    t Format Specifier      fr-FR Culture                                    17:04
//    
//    T Format Specifier      de-DE Culture                                 17:04:32
//    T Format Specifier      en-US Culture                               5:04:32 PM
//    T Format Specifier      es-ES Culture                                 17:04:32
//    T Format Specifier      fr-FR Culture                                 17:04:32
//    
//    u Format Specifier      de-DE Culture                     2008-10-01 17:04:32Z
//    u Format Specifier      en-US Culture                     2008-10-01 17:04:32Z
//    u Format Specifier      es-ES Culture                     2008-10-01 17:04:32Z
//    u Format Specifier      fr-FR Culture                     2008-10-01 17:04:32Z
//    
//    U Format Specifier      de-DE Culture     Donnerstag, 2. Oktober 2008 00:04:32
//    U Format Specifier      en-US Culture   Thursday, October 02, 2008 12:04:32 AM
//    U Format Specifier      es-ES Culture    jueves, 02 de octubre de 2008 0:04:32
//    U Format Specifier      fr-FR Culture            jeudi 2 octobre 2008 00:04:32
//    
//    Y Format Specifier      de-DE Culture                             Oktober 2008
//    Y Format Specifier      en-US Culture                            October, 2008
//    Y Format Specifier      es-ES Culture                          octubre de 2008
//    Y Format Specifier      fr-FR Culture                             octobre 2008
Imports System.Globalization

Module Example
   Public Sub Main()
      ' Create an array of all supported standard date and time format specifiers.
      Dim formats() As String = {"d", "D", "f", "F", "g", "G", "m", "o", "r", _
                                 "s", "t", "T", "u", "U", "Y"}
      ' Create an array of four cultures.                                 
      Dim cultures() As CultureInfo = {CultureInfo.CreateSpecificCulture("de-DE"), _
                                       CultureInfo.CreateSpecificCulture("en-US"), _
                                       CultureInfo.CreateSpecificCulture("es-ES"), _
                                       CultureInfo.CreateSpecificCulture("fr-FR")}
       ' Define date to be displayed.
      Dim dateToDisplay As Date = #10/1/2008 17:04:32#

      ' Iterate each standard format specifier.
      For Each formatSpecifier As String In formats
         For Each culture As CultureInfo In cultures
            Console.WriteLine("{0} Format Specifier {1, 10} Culture {2, 40}", _
                              formatSpecifier, culture.Name, _
                              dateToDisplay.ToString(formatSpecifier, culture))
         Next
         Console.WriteLine()
      Next                                       
   End Sub
End Module
' The example displays the following output:
'    d Format Specifier      de-DE Culture                               01.10.2008
'    d Format Specifier      en-US Culture                                10/1/2008
'    d Format Specifier      es-ES Culture                               01/10/2008
'    d Format Specifier      fr-FR Culture                               01/10/2008
'    
'    D Format Specifier      de-DE Culture                Mittwoch, 1. Oktober 2008
'    D Format Specifier      en-US Culture              Wednesday, October 01, 2008
'    D Format Specifier      es-ES Culture         miércoles, 01 de octubre de 2008
'    D Format Specifier      fr-FR Culture                  mercredi 1 octobre 2008
'    
'    f Format Specifier      de-DE Culture          Mittwoch, 1. Oktober 2008 17:04
'    f Format Specifier      en-US Culture      Wednesday, October 01, 2008 5:04 PM
'    f Format Specifier      es-ES Culture   miércoles, 01 de octubre de 2008 17:04
'    f Format Specifier      fr-FR Culture            mercredi 1 octobre 2008 17:04
'    
'    F Format Specifier      de-DE Culture       Mittwoch, 1. Oktober 2008 17:04:32
'    F Format Specifier      en-US Culture   Wednesday, October 01, 2008 5:04:32 PM
'    F Format Specifier      es-ES Culture miércoles, 01 de octubre de 2008 17:04:3
'    F Format Specifier      fr-FR Culture         mercredi 1 octobre 2008 17:04:32
'    
'    g Format Specifier      de-DE Culture                         01.10.2008 17:04
'    g Format Specifier      en-US Culture                        10/1/2008 5:04 PM
'    g Format Specifier      es-ES Culture                         01/10/2008 17:04
'    g Format Specifier      fr-FR Culture                         01/10/2008 17:04
'    
'    G Format Specifier      de-DE Culture                      01.10.2008 17:04:32
'    G Format Specifier      en-US Culture                     10/1/2008 5:04:32 PM
'    G Format Specifier      es-ES Culture                      01/10/2008 17:04:32
'    G Format Specifier      fr-FR Culture                      01/10/2008 17:04:32
'    
'    m Format Specifier      de-DE Culture                               01 Oktober
'    m Format Specifier      en-US Culture                               October 01
'    m Format Specifier      es-ES Culture                               01 octubre
'    m Format Specifier      fr-FR Culture                                1 octobre
'    
'    o Format Specifier      de-DE Culture              2008-10-01T17:04:32.0000000
'    o Format Specifier      en-US Culture              2008-10-01T17:04:32.0000000
'    o Format Specifier      es-ES Culture              2008-10-01T17:04:32.0000000
'    o Format Specifier      fr-FR Culture              2008-10-01T17:04:32.0000000
'    
'    r Format Specifier      de-DE Culture            Wed, 01 Oct 2008 17:04:32 GMT
'    r Format Specifier      en-US Culture            Wed, 01 Oct 2008 17:04:32 GMT
'    r Format Specifier      es-ES Culture            Wed, 01 Oct 2008 17:04:32 GMT
'    r Format Specifier      fr-FR Culture            Wed, 01 Oct 2008 17:04:32 GMT
'    
'    s Format Specifier      de-DE Culture                      2008-10-01T17:04:32
'    s Format Specifier      en-US Culture                      2008-10-01T17:04:32
'    s Format Specifier      es-ES Culture                      2008-10-01T17:04:32
'    s Format Specifier      fr-FR Culture                      2008-10-01T17:04:32
'    
'    t Format Specifier      de-DE Culture                                    17:04
'    t Format Specifier      en-US Culture                                  5:04 PM
'    t Format Specifier      es-ES Culture                                    17:04
'    t Format Specifier      fr-FR Culture                                    17:04
'    
'    T Format Specifier      de-DE Culture                                 17:04:32
'    T Format Specifier      en-US Culture                               5:04:32 PM
'    T Format Specifier      es-ES Culture                                 17:04:32
'    T Format Specifier      fr-FR Culture                                 17:04:32
'    
'    u Format Specifier      de-DE Culture                     2008-10-01 17:04:32Z
'    u Format Specifier      en-US Culture                     2008-10-01 17:04:32Z
'    u Format Specifier      es-ES Culture                     2008-10-01 17:04:32Z
'    u Format Specifier      fr-FR Culture                     2008-10-01 17:04:32Z
'    
'    U Format Specifier      de-DE Culture     Donnerstag, 2. Oktober 2008 00:04:32
'    U Format Specifier      en-US Culture   Thursday, October 02, 2008 12:04:32 AM
'    U Format Specifier      es-ES Culture    jueves, 02 de octubre de 2008 0:04:32
'    U Format Specifier      fr-FR Culture            jeudi 2 octobre 2008 00:04:32
'    
'    Y Format Specifier      de-DE Culture                             Oktober 2008
'    Y Format Specifier      en-US Culture                            October, 2008
'    Y Format Specifier      es-ES Culture                          octubre de 2008
'    Y Format Specifier      fr-FR Culture                             octobre 2008

Im folgenden Beispiel werden verschiedene Möglichkeiten zum Formatieren DateTime eines Werts mit dem invariante DateTimeFormatInfoveranschaulicht.The following example demonstrates different ways of formatting a DateTime value using the invariant DateTimeFormatInfo.

using namespace System;
using namespace System::Globalization;
void main()
{
   DateTime dt = DateTime::Now;
   array<String^>^format = {L"d",L"D",L"f",L"F",L"g",L"G",L"m",L"r",L"s",L"t",L"T",L"u",L"U",L"y",L"dddd, MMMM dd yyyy",L"ddd, MMM d \"'\"yy",L"dddd, MMMM dd",L"M/yy",L"dd-MM-yy"};
   String^ date;
   for ( int i = 0; i < format->Length; i++ )
   {
      date = dt.ToString( format[ i ], DateTimeFormatInfo::InvariantInfo );
      Console::WriteLine( String::Concat( format[ i ], L" :", date ) );

   }
   
   /** Output.
       *
       * d :08/17/2000
       * D :Thursday, August 17, 2000
       * f :Thursday, August 17, 2000 16:32
       * F :Thursday, August 17, 2000 16:32:32
       * g :08/17/2000 16:32
       * G :08/17/2000 16:32:32
       * m :August 17
       * r :Thu, 17 Aug 2000 23:32:32 GMT
       * s :2000-08-17T16:32:32
       * t :16:32
       * T :16:32:32
       * u :2000-08-17 23:32:32Z
       * U :Thursday, August 17, 2000 23:32:32
       * y :August, 2000
       * dddd, MMMM dd yyyy :Thursday, August 17 2000
       * ddd, MMM d "'"yy :Thu, Aug 17 '00
       * dddd, MMMM dd :Thursday, August 17
       * M/yy :8/00
       * dd-MM-yy :17-08-00
       */
}

 using System;
 using System.Globalization; 
 
public class MainClass { 
    public static void Main(string[] args)  {
        DateTime dt = DateTime.Now;
        String[] format = {
            "d", "D",
            "f", "F",
            "g", "G",
            "m",
            "r",
            "s",
            "t", "T",
            "u", "U",
            "y",
            "dddd, MMMM dd yyyy",
            "ddd, MMM d \"'\"yy",
            "dddd, MMMM dd",
            "M/yy",
            "dd-MM-yy",
        };
        String date;
        for (int i = 0; i < format.Length; i++) {
            date = dt.ToString(format[i], DateTimeFormatInfo.InvariantInfo);
            Console.WriteLine(String.Concat(format[i], " :" , date));
        }
  
   /** Output.
    *
    * d :08/17/2000
    * D :Thursday, August 17, 2000
    * f :Thursday, August 17, 2000 16:32
    * F :Thursday, August 17, 2000 16:32:32
    * g :08/17/2000 16:32
    * G :08/17/2000 16:32:32
    * m :August 17
    * r :Thu, 17 Aug 2000 23:32:32 GMT
    * s :2000-08-17T16:32:32
    * t :16:32
    * T :16:32:32
    * u :2000-08-17 23:32:32Z
    * U :Thursday, August 17, 2000 23:32:32
    * y :August, 2000
    * dddd, MMMM dd yyyy :Thursday, August 17 2000
    * ddd, MMM d "'"yy :Thu, Aug 17 '00
    * dddd, MMMM dd :Thursday, August 17
    * M/yy :8/00
    * dd-MM-yy :17-08-00
    */
    }
}
Option Explicit
Option Strict

Imports System
Imports System.Globalization

Public Class MainClass
    
    Public Shared Sub Main()
        Dim dt As DateTime = DateTime.Now
        Dim myformat() As String =  {"d", "D", _
                                    "f", "F", _
                                    "g", "G", _
                                    "m", _
                                    "r", _
                                    "s", _
                                    "t", "T", _
                                    "u", "U", _
                                    "y", _
                                    "dddd, MMMM dd yyyy", _
                                    "ddd, MMM d ""'""yy", _
                                    "dddd, MMMM dd", _
                                    "M/yy", _
                                    "dd-MM-yy"}
        Dim mydate As String
        Dim i As Integer
        For i = 0 To myformat.Length - 1
            mydate = dt.ToString(myformat(i), DateTimeFormatInfo.InvariantInfo)
            Console.WriteLine(String.Concat(myformat(i), " :", mydate))
        Next i

    ' Output.
    '
    ' d :08/17/2000
    ' D :Thursday, August 17, 2000
    ' f :Thursday, August 17, 2000 16:32
    ' F :Thursday, August 17, 2000 16:32:32
    ' g :08/17/2000 16:32
    ' G :08/17/2000 16:32:32
    ' m :August 17
    ' r :Thu, 17 Aug 2000 23:32:32 GMT
    ' s :2000-08-17T16:32:32
    ' t :16:32
    ' T :16:32:32
    ' u :2000-08-17 23:32:32Z
    ' U :Thursday, August 17, 2000 23:32:32
    ' y :August, 2000
    ' dddd, MMMM dd yyyy :Thursday, August 17 2000
    ' ddd, MMM d "'"yy :Thu, Aug 17 '00
    ' dddd, MMMM dd :Thursday, August 17
    ' M/yy :8/00
    ' dd-MM-yy :17-08-00
    End Sub 'Main 
End Class 'MainClass

Hinweise

Der format -Parameter kann entweder ein einzelnes formatspezifiziererzeichen (siehe Standard Format Zeichenfolgen für Datum und Uhrzeit) oder ein benutzerdefiniertes Format Muster (siehe benutzerdefinierte Format Zeichenfolgen für Datum und Uhrzeit) enthalten.The format parameter can contain either a single format specifier character (see Standard Date and Time Format Strings) or a custom format pattern (see Custom Date and Time Format Strings). Wenn format oder null eine leere Zeichenfolge ("") ist, wird der Standardformat Bezeichner "G" verwendet.If format is null or an empty string (""), the standard format specifier, "G", is used.

Der provider -Parameter definiert das Muster, das den Standardformat Bezeichnernamen entspricht, sowie die Symbole und Namen von Datums-und Uhrzeit Komponenten.The provider parameter defines the pattern that corresponds to the standard format specifiers, as well as the symbols and names of date and time components. Der provider -Parameter kann eine der folgenden sein:The provider parameter can be any of the following:

Wenn providerden Wert DateTimeFormatInfo hat, wird der der aktuellen Kultur zugeordnete verwendet. nullIf provider is null, the DateTimeFormatInfo associated with the current culture is used. Weitere Informationen finden Sie unter CultureInfo.CurrentCulture.For more information, see CultureInfo.CurrentCulture.

Hinweise für Aufrufer

Die ToString(String, IFormatProvider) -Methode gibt die Zeichen folgen Darstellung des Datums und der Uhrzeit im Kalender zurück, provider der vom-Parameter verwendet wird.The ToString(String, IFormatProvider) method returns the string representation of the date and time in the calendar used by the provider parameter. Der Kalender wird durch die Calendar -Eigenschaft definiert.Its calendar is defined by the Calendar property. Wenn DateTime der Wert der aktuellen Instanz früher als MinSupportedDateTime oder später als MaxSupportedDateTimeist, löst die Methode eine ArgumentOutOfRangeExceptionaus.If the value of the current DateTime instance is earlier than MinSupportedDateTime or later than MaxSupportedDateTime, the method throws an ArgumentOutOfRangeException. Dies wird im folgenden Beispiel veranschaulicht.The following example provides an illustration. Es wird versucht, ein Datum zu formatieren, das außerhalb des UmAlQuraCalendar Bereichs der-Klasse liegt.It attempts to format a date that is outside the range of the UmAlQuraCalendar class.

[! Code-csharpSystem. DateTime. destring. argumentoudefrangeexception # 4] [! Code-vbSystem. DateTime. destring. argumentoudefrangeexception # 4][!code-csharpSystem.DateTime.ToString.ArgumentOutOfRangeException#4] [!code-vbSystem.DateTime.ToString.ArgumentOutOfRangeException#4]

Siehe auch

ToString(String) ToString(String) ToString(String) ToString(String)

Konvertiert den Wert des aktuellen DateTime-Objekts unter Verwendung des angegebenen Formats und der Formatierungskonventionen der aktuellen Kultur in die entsprechende Zeichenfolgendarstellung.Converts the value of the current DateTime object to its equivalent string representation using the specified format and the formatting conventions of the current culture.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (string format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

Parameter

format
String String String String

Eine Standard- oder benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit.A standard or custom date and time format string.

Gibt zurück

Die Zeichenfolgendarstellung des Werts des aktuellen DateTime-Objekts entsprechend der Angabe in format.A string representation of value of the current DateTime object as specified by format.

Ausnahmen

Die Länge des format ist 1, und es ist keines der Formatbezeichnerzeichen, die für DateTimeFormatInfo definiert sind.The length of format is 1, and it is not one of the format specifier characters defined for DateTimeFormatInfo.

- oder --or- format enthält kein gültiges benutzerdefiniertes Formatmuster.format does not contain a valid custom format pattern.

Datum und Uhrzeit liegen außerhalb des Bereichs von Datumsangaben, die von dem Kalender unterstützt werden, der von der aktuellen Kultur verwendet wird.The date and time is outside the range of dates supported by the calendar used by the current culture.

Beispiele

Im folgenden Beispiel wird jede der Standardformat Zeichenfolgen für Datum und Uhrzeit und eine Auswahl von benutzerdefinierten Format Zeichenfolgen für Datum und Uhrzeit verwendet DateTime , um die Zeichen folgen Darstellung eines-Werts anzuzeigen.The following example uses each of the standard date and time format strings and a selection of custom date and time format strings to display the string representation of a DateTime value. Die aktuelle Thread Kultur für das Beispiel ist "en-US".The thread current culture for the example is en-US.

using System;

public class DateToStringExample
{
   public static void Main()
   {
      DateTime dateValue = new DateTime(2008, 6, 15, 21, 15, 07);
      // Create an array of standard format strings.
      string[] standardFmts = {"d", "D", "f", "F", "g", "G", "m", "o", 
                               "R", "s", "t", "T", "u", "U", "y"};
      // Output date and time using each standard format string.
      foreach (string standardFmt in standardFmts)
         Console.WriteLine("{0}: {1}", standardFmt, 
                           dateValue.ToString(standardFmt));
      Console.WriteLine();
      
      // Create an array of some custom format strings.
      string[] customFmts = {"h:mm:ss.ff t", "d MMM yyyy", "HH:mm:ss.f", 
                             "dd MMM HH:mm:ss", @"\Mon\t\h\: M", "HH:mm:ss.ffffzzz" };
      // Output date and time using each custom format string.
      foreach (string customFmt in customFmts)
         Console.WriteLine("'{0}': {1}", customFmt,
                           dateValue.ToString(customFmt));
   }
}
// This example displays the following output to the console:
//       d: 6/15/2008
//       D: Sunday, June 15, 2008
//       f: Sunday, June 15, 2008 9:15 PM
//       F: Sunday, June 15, 2008 9:15:07 PM
//       g: 6/15/2008 9:15 PM
//       G: 6/15/2008 9:15:07 PM
//       m: June 15
//       o: 2008-06-15T21:15:07.0000000
//       R: Sun, 15 Jun 2008 21:15:07 GMT
//       s: 2008-06-15T21:15:07
//       t: 9:15 PM
//       T: 9:15:07 PM
//       u: 2008-06-15 21:15:07Z
//       U: Monday, June 16, 2008 4:15:07 AM
//       y: June, 2008
//       
//       'h:mm:ss.ff t': 9:15:07.00 P
//       'd MMM yyyy': 15 Jun 2008
//       'HH:mm:ss.f': 21:15:07.0
//       'dd MMM HH:mm:ss': 15 Jun 21:15:07
//       '\Mon\t\h\: M': Month: 6
//       'HH:mm:ss.ffffzzz': 21:15:07.0000-07:00
Module DateToStringExample
   Public Sub Main()
      Dim dateValue As Date = #6/15/2008 9:15:07PM#
      ' Create an array of standard format strings.
      Dim standardFmts() As String = {"d", "D", "f", "F", "g", "G", _
                                      "m", "o", "R", "s", "t", "T", _
                                      "u", "U", "y"}
      ' Output date and time using each standard format string.
      For Each standardFmt As String In standardFmts
         Console.WriteLine("{0}: {1}", standardFmt, _
                           dateValue.ToString(standardFmt))
      Next
      Console.WriteLine()
      
      ' Create an array of some custom format strings.
      Dim customFmts() As String = {"h:mm:ss.ff t", "d MMM yyyy", "HH:mm:ss.f", _
                                    "dd MMM HH:mm:ss", "\Mon\t\h\: M", "HH:mm:ss.ffffzzz" }
      ' Output date and time using each custom format string.
      For Each customFmt As String In customFmts
         Console.WriteLine("'{0}': {1}", customFmt, _
                           dateValue.ToString(customFmt))
      Next
   End Sub
End Module
' This example displays the following output to the console:
'       d: 6/15/2008
'       D: Sunday, June 15, 2008
'       f: Sunday, June 15, 2008 9:15 PM
'       F: Sunday, June 15, 2008 9:15:07 PM
'       g: 6/15/2008 9:15 PM
'       G: 6/15/2008 9:15:07 PM
'       m: June 15
'       o: 2008-06-15T21:15:07.0000000
'       R: Sun, 15 Jun 2008 21:15:07 GMT
'       s: 2008-06-15T21:15:07
'       t: 9:15 PM
'       T: 9:15:07 PM
'       u: 2008-06-15 21:15:07Z
'       U: Monday, June 16, 2008 4:15:07 AM
'       y: June, 2008
'       
'       'h:mm:ss.ff t': 9:15:07.00 P
'       'd MMM yyyy': 15 Jun 2008
'       'HH:mm:ss.f': 21:15:07.0
'       'dd MMM HH:mm:ss': 15 Jun 21:15:07
'       '\Mon\t\h\: M': Month: 6
'       'HH:mm:ss.ffffzzz': 21:15:07.0000-07:00

Hinweise

Die ToString(String) -Methode gibt die Zeichen folgen Darstellung eines Datums-und Uhrzeitwerts in einem bestimmten Format zurück, das die Formatierungs Konventionen der aktuellen Kultur verwendet. CultureInfo.CurrentCultureWeitere Informationen finden Sie unter.The ToString(String) method returns the string representation of a date and time value in a specific format that uses the formatting conventions of the current culture; for more information, see CultureInfo.CurrentCulture.

Der format -Parameter muss entweder ein einzelnes formatspezifiziererzeichen (siehe Standard Format Zeichenfolgen für Datum und Uhrzeit) oder ein benutzerdefiniertes Format Muster (siehe benutzerdefinierte Format Zeichenfolgen für Datum und Uhrzeit) enthalten, das das Format der zurückgegebenen definiert. Schnür.The format parameter should contain either a single format specifier character (see Standard Date and Time Format Strings) or a custom format pattern (see Custom Date and Time Format Strings) that defines the format of the returned string. Wenn format oder null eine leere Zeichenfolge ist, wird der allgemeine Format Bezeichner "G" verwendet.If format is null or an empty string, the general format specifier, 'G', is used.

Zu den Verwendungsmöglichkeiten dieser Methode gehören:Some uses of this method include:

  • Eine Zeichenfolge, die das Datum und die Uhrzeit im kurzen Datums-und Uhrzeit Format der aktuellen Kultur anzeigt.Getting a string that displays the date and time in the current culture's short date and time format. Verwenden Sie hierzu den Format Bezeichner "G".To do this, you use the "G" format specifier.

  • Eine Zeichenfolge, die nur den Monat und das Jahr enthält.Getting a string that contains only the month and year. Zu diesem Zweck verwenden Sie die Format Zeichenfolge "mm/yyyy".To do this, you use the "MM/yyyy" format string. Die Format Zeichenfolge verwendet das Datums Trennzeichen der aktuellen Kultur.The format string uses the current culture's date separator.

  • Eine Zeichenfolge, die das Datum und die Uhrzeit in einem bestimmten Format enthält.Getting a string that contains the date and time in a specific format. Die Format Zeichenfolge "mm/dd/yyyyhh: mm" zeigt z. b. die Datums-und Uhrzeit Zeichenfolge in einem bestimmten Format an, z. b. "19//03//2013 18:06".For example, the "MM/dd/yyyyHH:mm" format string displays the date and time string in a fixed format such as "19//03//2013 18:06". Die Format Zeichenfolge verwendet "/" als Trennzeichen für ein festes Datum, unabhängig von kulturspezifischen Einstellungen.The format string uses "/" as a fixed date separator regardless of culture-specific settings.

  • Das erhalten eines Datums in einem komprimierten Format, das zum Serialisieren einer Datums Zeichenfolge verwendet werden kann.Getting a date in a condensed format that could be used for serializing a date string. Die Format Zeichenfolge "YYYYMMDD" zeigt beispielsweise eine vierstellige Jahres Angabe an, gefolgt von einem zweistelligen Monat und einem zweistelligen Tag ohne Datums Trennzeichen.For example, the "yyyyMMdd" format string displays a four-digit year followed by a two-digit month and a two-digit day with no date separator.

Im folgenden Beispiel werden diese drei Format Zeichenfolgen verwendet, um einen Datums-und Uhrzeitwert mithilfe der Konventionen der Kultur en-US und fr-FR anzuzeigen.The following example uses these three format strings to display a date and time value by using the conventions of the en-US and fr-FR cultures.

using System;
using System.Globalization;
using System.Threading;

public class Example
{
   public static void Main()
   {
      String[] formats = { "G", "MM/yyyy", @"MM\/dd\/yyyy HH:mm",
                           "yyyyMMdd" };
      String[] cultureNames = { "en-US", "fr-FR" };
      DateTime date = new DateTime(2015, 8, 18, 13, 31, 17);
      foreach (var cultureName in cultureNames) {
         var culture = new CultureInfo(cultureName);
         CultureInfo.CurrentCulture = culture;
         Console.WriteLine(culture.NativeName);
         foreach (var format in formats)
            Console.WriteLine("   {0}: {1}", format,
                              date.ToString(format));
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//       English (United States)
//          G: 8/18/2015 1:31:17 PM
//          MM/yyyy: 08/2015
//          MM\/dd\/yyyy HH:mm: 08/18/2015 13:31
//          yyyyMMdd: 20150818
//
//       français (France)
//          G: 18/08/2015 13:31:17
//          MM/yyyy: 08/2015
//          MM\/dd\/yyyy HH:mm: 08/18/2015 13:31
//          yyyyMMdd: 20150818
Imports System.Globalization
Imports System.Threading

Public Module Example
   Public Sub Main()
      Dim formats() As String = { "G", "MM/yyyy", "MM\/dd\/yyyy HH:mm",
                                  "yyyyMMdd" }
      Dim cultureNames() As String = { "en-US", "fr-FR" }
      Dim dat As New DateTime(2015, 8, 18, 13, 31, 17)
      For Each cultureName In cultureNames
         Dim culture As New CultureInfo(cultureName)
         CultureInfo.CurrentCulture = culture
         Console.WriteLine(culture.NativeName)
         For Each fmt In formats
            Console.WriteLine("   {0}: {1}", fmt,
                              dat.ToString(fmt))
         Next
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output:
'       English (United States)
'          G: 8/18/2015 1:31:17 PM
'          MM/yyyy: 08/2015
'          MM\/dd\/yyyy HH:mm: 08/18/2015 13:31
'          yyyyMMdd: 20150818
'
'       français (France)
'          G: 18/08/2015 13:31:17
'          MM/yyyy: 08/2015
'          MM\/dd\/yyyy HH:mm: 08/18/2015 13:31
'          yyyyMMdd: 20150818

Hinweise für Aufrufer

Die ToString(String) -Methode gibt die Zeichen folgen Darstellung des Datums und der Uhrzeit im Kalender zurück, der von der aktuellen Kultur verwendet wird.The ToString(String) method returns the string representation of the date and time in the calendar used by the current culture. Wenn DateTime der Wert der aktuellen Instanz früher als MinSupportedDateTime oder später als MaxSupportedDateTimeist, löst die Methode eine ArgumentOutOfRangeExceptionaus.If the value of the current DateTime instance is earlier than MinSupportedDateTime or later than MaxSupportedDateTime, the method throws an ArgumentOutOfRangeException. Dies wird im folgenden Beispiel veranschaulicht.The following example provides an illustration. Es wird versucht, ein Datum zu formatieren, das außerhalb des HebrewCalendar Bereichs der-Klasse liegt, wenn die aktuelle Kultur Hebräisch (Israel) ist.It attempts to format a date that is outside the range of the HebrewCalendar class when the current culture is Hebrew (Israel).

[! Code-csharpSystem. DateTime. destring. argumentoudefrangeexception # 3] [! Code-vbSystem. DateTime. destring. argumentoudefrangeexception # 3][!code-csharpSystem.DateTime.ToString.ArgumentOutOfRangeException#3] [!code-vbSystem.DateTime.ToString.ArgumentOutOfRangeException#3]

Siehe auch

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Konvertiert den Wert des aktuellen DateTime-Objekts unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.Converts the value of the current DateTime object to its equivalent string representation using the specified culture-specific format information.

public:
 virtual System::String ^ ToString(IFormatProvider ^ provider);
public string ToString (IFormatProvider provider);
override this.ToString : IFormatProvider -> string
Public Function ToString (provider As IFormatProvider) As String

Parameter

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.An object that supplies culture-specific formatting information.

Gibt zurück

Die Zeichenfolgendarstellung des Werts des aktuellen DateTime-Objekts entsprechend der Angabe in provider.A string representation of value of the current DateTime object as specified by provider.

Implementiert

Ausnahmen

Datum und Uhrzeit liegen außerhalb des Bereichs von Datumsangaben, die vom Kalender unterstützt werden, der von provider verwendet wird.The date and time is outside the range of dates supported by the calendar used by provider.

Beispiele

Im folgenden Beispiel wird die Zeichen folgen Darstellung eines Datums und einer Uhrzeit CultureInfo mithilfe von Objekten angezeigt, die fünf verschiedene Kulturen darstellen.The following example displays the string representation of a date and time using CultureInfo objects that represent five different cultures.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      CultureInfo[] cultures = new CultureInfo[] {CultureInfo.InvariantCulture, 
                                                  new CultureInfo("en-us"), 
                                                  new CultureInfo("fr-fr"), 
                                                  new CultureInfo("de-DE"), 
                                                  new CultureInfo("es-ES"),
                                                  new CultureInfo("ja-JP")};

      DateTime thisDate = new DateTime(2009, 5, 1, 9, 0, 0);                                            

      foreach (CultureInfo culture in cultures)
      {
         string cultureName; 
         if (string.IsNullOrEmpty(culture.Name))
            cultureName = culture.NativeName;
         else
            cultureName = culture.Name;
      
         Console.WriteLine("In {0}, {1}", 
                           cultureName, thisDate.ToString(culture));
      }                                            
      }
}
// The example produces the following output:
//    In Invariant Language (Invariant Country), 05/01/2009 09:00:00
//    In en-US, 5/1/2009 9:00:00 AM
//    In fr-FR, 01/05/2009 09:00:00
//    In de-DE, 01.05.2009 09:00:00
//    In es-ES, 01/05/2009 9:00:00
//    In ja-JP, 2009/05/01 9:00:00
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim cultures() As CultureInfo = {CultureInfo.InvariantCulture, _
                                       New CultureInfo("en-us"), _
                                       New CultureInfo("fr-fr"), _
                                       New CultureInfo("de-DE"), _
                                       New CultureInfo("es-ES"), _
                                       New CultureInfo("ja-JP")}
      
      Dim thisDate As Date =#5/1/2009 9:00AM#                                            
      
      For Each culture As CultureInfo In cultures
         Dim cultureName As String 
         If String.IsNullOrEmpty(culture.Name) Then
            cultureName = culture.NativeName
         Else
            cultureName = culture.Name
         End If

         Console.WriteLine("In {0}, {1}", _
                           cultureName, thisDate.ToString(culture))
      Next                                            
   End Sub
End Module
' The example produces the following output:
'    In Invariant Language (Invariant Country), 05/01/2009 09:00:00
'    In en-US, 5/1/2009 9:00:00 AM
'    In fr-FR, 01/05/2009 09:00:00
'    In de-DE, 01.05.2009 09:00:00
'    In es-ES, 01/05/2009 9:00:00
'    In ja-JP, 2009/05/01 9:00:00

Hinweise

Der Wert des aktuellen DateTime -Objekts wird mit dem allgemeinen Format Bezeichner für Datum und Uhrzeit ("G") formatiert, der die Ausgabe mit dem kurzen Datums Muster und dem langen Zeitmuster formatiert.The value of the current DateTime object is formatted using the general date and time format specifier ('G'), which formats output using the short date pattern and the long time pattern.

Das Format des kurzen Datums-und des langen Uhrzeit Musters wird durch den provider -Parameter definiert.The format of the short date and long time pattern is defined by the provider parameter. Der provider -Parameter kann eine der folgenden sein:The provider parameter can be any of the following:

Wenn providerden Wert DateTimeFormatInfo hat, wird das-Objekt verwendet, das der aktuellen Kultur zugeordnet ist. nullIf provider is null, the DateTimeFormatInfo object associated with the current culture is used. Weitere Informationen finden Sie unter CultureInfo.CurrentCulture.For more information, see CultureInfo.CurrentCulture.

Hinweise für Aufrufer

Die ToString(IFormatProvider) -Methode gibt die Zeichen folgen Darstellung des Datums und der Uhrzeit im Kalender zurück, der von der durch provider den-Parameter dargestellten Kultur verwendet wird.The ToString(IFormatProvider) method returns the string representation of the date and time in the calendar used by the culture represented by the provider parameter. Der Kalender wird durch die Calendar -Eigenschaft definiert.Its calendar is defined by the Calendar property. Wenn DateTime der Wert der aktuellen Instanz früher als MinSupportedDateTime oder später als MaxSupportedDateTimeist, löst die Methode eine ArgumentOutOfRangeExceptionaus.If the value of the current DateTime instance is earlier than MinSupportedDateTime or later than MaxSupportedDateTime, the method throws an ArgumentOutOfRangeException. Dies wird im folgenden Beispiel veranschaulicht.The following example provides an illustration. Es wird versucht, ein Datum zu formatieren, das außerhalb des JapaneseCalendar Bereichs der-Klasse liegt.It attempts to format a date that is outside the range of the JapaneseCalendar class.

[! Code-csharpSystem. DateTime. destring. argumentoudefrangeexception # 1] [! Code-vbSystem. DateTime. destring. argumentoudefrangeexception # 1][!code-csharpSystem.DateTime.ToString.ArgumentOutOfRangeException#1] [!code-vbSystem.DateTime.ToString.ArgumentOutOfRangeException#1]

Siehe auch

ToString() ToString() ToString() ToString()

Konvertiert den Wert des aktuellen DateTime-Objekts unter Verwendung der Formatierungskonventionen der aktuellen Kultur in die entsprechende Zeichenfolgendarstellung.Converts the value of the current DateTime object to its equivalent string representation using the formatting conventions of the current culture.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Gibt zurück

Die Zeichenfolgendarstellung des Werts des aktuellen DateTime-Objekts.A string representation of the value of the current DateTime object.

Ausnahmen

Datum und Uhrzeit liegen außerhalb des Bereichs von Datumsangaben, die von dem Kalender unterstützt werden, der von der aktuellen Kultur verwendet wird.The date and time is outside the range of dates supported by the calendar used by the current culture.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die Zeichen folgen DateTime Darstellung eines Werts, ToString() der von der-Methode zurückgegeben wird, von der aktuellen Thread Kultur abhängt.The following example illustrates how the string representation of a DateTime value returned by the ToString() method depends on the thread current culture. Sie ändert die aktuelle Thread Kultur von en-US in fr-fr in ja-JP.It changes the current thread culture from en-US to fr-FR to ja-JP. und in jedem Fall ruft die ToString() -Methode auf, um die Zeichen folgen Darstellung eines Datums-und Uhrzeitwerts mithilfe dieser Kultur zurückzugeben.and in each case calls the ToString() method to return the string representation of a date and time value using that culture.

using System;
using System.Globalization;
using System.Threading;

public class DateToStringExample
{
   public static void Main()
   {
      CultureInfo currentCulture = Thread.CurrentThread.CurrentCulture;
      DateTime exampleDate = new DateTime(2008, 5, 1, 18, 32, 6);
      
      // Display the date using the current (en-US) culture.
      Console.WriteLine(exampleDate.ToString());

      // Change the current culture to fr-FR and display the date.
      Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("fr-FR");
      Console.WriteLine(exampleDate.ToString());

      // Change the current culture to ja-JP and display the date.
      Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("ja-JP");
      Console.WriteLine(exampleDate.ToString());
      
      // Restore the original culture
      Thread.CurrentThread.CurrentCulture = currentCulture;
   }
}
// The example displays the following output to the console:
//       5/1/2008 6:32:06 PM
//       01/05/2008 18:32:06
//       2008/05/01 18:32:06
Imports System.Globalization
Imports System.Threading

Module DateToStringExample
   Public Sub Main()
      Dim currentCulture As CultureInfo = Thread.CurrentThread.CurrentCulture
      Dim exampleDate As Date = #05/01/2008 6:32:06PM#
      
      ' Display the date using the current (en-US) culture.
      Console.WriteLine(exampleDate.ToString())

      ' Change the current culture to fr-FR and display the date.
      Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("fr-FR")
      Console.WriteLine(exampleDate.ToString())

      ' Change the current culture to ja-JP and display the date.
      Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("ja-JP")
      Console.WriteLine(exampleDate.ToString())
      
      ' Restore the original culture
      Thread.CurrentThread.CurrentCulture = currentCulture
   End Sub
End Module
' The example displays the following output to the console:
'       5/1/2008 6:32:06 PM
'       01/05/2008 18:32:06
'       2008/05/01 18:32:06

Hinweise

Der Wert des aktuellen DateTime -Objekts wird mit dem allgemeinen Format Bezeichner für Datum und Uhrzeit ("G") formatiert.The value of the current DateTime object is formatted using the general date and time format specifier ('G'). Um ihn mit einem bestimmten Format Bezeichner für Datum und Uhrzeit zu formatieren ToString(String) , müssen Sie die-Methode aufzurufen.To format it using a specific date and time format specifier, call the ToString(String) method. Um es mit dem allgemeinen Format Bezeichner für Datum und Uhrzeit ("G") für eine bestimmte Kultur zu formatieren ToString(IFormatProvider) , müssen Sie die-Methode aufzurufen.To format it using the general date and time format specifier ('G') for a specific culture, call the ToString(IFormatProvider) method. Um ihn mit einem bestimmten Format Bezeichner für Datum und Uhrzeit und den Konventionen einer bestimmten Kultur zu formatieren, ToString(String, IFormatProvider) müssen Sie die-Methode aufzurufen.To format it using a specific date and time format specifier and the conventions of a specific culture, call the ToString(String, IFormatProvider) method.

Diese Methode verwendet Formatierungsinformationen, die von der aktuellen Kultur abgeleitet werden.This method uses formatting information derived from the current culture. Insbesondere werden die benutzerdefinierten Format Zeichenfolgen kombiniert, die ShortDatePattern von LongTimePattern den-und DateTimeFormatInfo -Eigenschaften des- Thread.CurrentThread.CurrentCulture.DateTimeFormat Objekts zurückgegeben werden, das von der-EigenschaftIn particular, it combines the custom format strings returned by the ShortDatePattern and LongTimePattern properties of the DateTimeFormatInfo object returned by the Thread.CurrentThread.CurrentCulture.DateTimeFormat property. Weitere Informationen finden Sie unter CultureInfo.CurrentCulture.For more information, see CultureInfo.CurrentCulture. Mit anderen über Ladungen der ToString -Methode können Sie die Kultur angeben, deren Formatierung verwendet werden soll, sowie das Ausgabemuster DateTime des Werts definieren.Other overloads of the ToString method enable you to specify the culture whose formatting to use and to define the output pattern of the DateTime value.

Hinweise für Aufrufer

Die ToString() -Methode gibt die Zeichen folgen Darstellung des Datums und der Uhrzeit im Kalender zurück, der von der aktuellen Kultur verwendet wird.The ToString() method returns the string representation of the date and time in the calendar used by the current culture. Wenn DateTime der Wert der aktuellen Instanz früher als MinSupportedDateTime oder später als MaxSupportedDateTimeist, löst die Methode eine ArgumentOutOfRangeExceptionaus.If the value of the current DateTime instance is earlier than MinSupportedDateTime or later than MaxSupportedDateTime, the method throws an ArgumentOutOfRangeException. Dies wird im folgenden Beispiel veranschaulicht.The following example provides an illustration. Es wird versucht, ein Datum zu formatieren, das außerhalb des HijriCalendar Bereichs der Klasse liegt, wenn die aktuelle Kultur Arabisch (Syrien) ist.It attempts to format a date that is outside the range of the HijriCalendar class when the current culture is Arabic (Syria).

[! Code-csharpSystem. DateTime. destring. argumentoudefrangeexception # 2] [! Code-vbSystem. DateTime. destring. argumentoudefrangeexception # 2][!code-csharpSystem.DateTime.ToString.ArgumentOutOfRangeException#2] [!code-vbSystem.DateTime.ToString.ArgumentOutOfRangeException#2]

Siehe auch

Gilt für: