DateTimeOffset.ToString DateTimeOffset.ToString DateTimeOffset.ToString DateTimeOffset.ToString Method

Definition

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

Überlädt

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

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

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

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

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

Konvertiert den Wert des aktuellen DateTimeOffset-Objekts unter Verwendung des angegebenen Formats in die entsprechende Zeichenfolgendarstellung.Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified format.

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

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

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

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

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

Gibt zurück

Eine Zeichenfolgendarstellung eines DateTimeOffset-Objekts, die den am Ende der Zeichenfolge angefügten Offset einschließt.A string representation of a DateTimeOffset object that includes the offset appended at the end of the string.

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

Das folgende Beispiel veranschaulicht Aufrufe der ToString() -Methode und zeigt die Ausgabe in einem System an, dessen aktuelle Kultur en-US ist.The following example illustrates calls to the ToString() method and displays its output on a system whose current culture is en-us.

DateTimeOffset thisDate;

// Show output for UTC time
thisDate = DateTimeOffset.UtcNow;
Console.WriteLine(thisDate.ToString());  // Displays 3/28/2007 7:13:50 PM +00:00

// Show output for local time 
thisDate = DateTimeOffset.Now;
Console.WriteLine(thisDate.ToString());  // Displays 3/28/2007 12:13:50 PM -07:00

// Show output for arbitrary time offset
thisDate = thisDate.ToOffset(new TimeSpan(-5, 0, 0));
Console.WriteLine(thisDate.ToString());  // Displays 3/28/2007 2:13:50 PM -05:00
Dim thisDate As DateTimeOffset

' Show output for UTC time
thisDate = DateTimeOffset.UtcNow
Console.WriteLine(thisDate.ToString())  ' Displays 3/28/2007 7:13:50 PM +00:00

' Show output for local time 
thisDate = DateTimeOffset.Now
Console.WriteLine(thisDate.ToString())  ' Displays 3/28/2007 12:13:50 PM -07:00

' Show output for arbitrary time offset
thisDate = thisDate.ToOffset(new TimeSpan(-5, 0, 0))
Console.WriteLine(thisDate.ToString())  ' Displays 3/28/2007 2:13:50 PM -05:00

Hinweise

Der Rückgabewert dieser Methode ist identisch mit DateTime.ToString() der der-Methode, mit dem Unterschied, dass Sie ein Leerzeichen gefolgt von dem am Ende der Zeichenfolge angefügten Offset enthält.The return value of this method is identical to that of the DateTime.ToString() method, except that it includes a space followed by the offset appended at the end of the string. Das heißt, die Ausgabe wird mit dem kurzen Datums Muster, dem langen Zeitmuster und der zzz benutzerdefinierten Format Zeichenfolge formatiert, wobei jedes Element durch ein Leerzeichen vom vorherigen Element getrennt ist.In other words, it formats output using the short date pattern, the long time pattern, and the zzz custom format string, with each element separated from the previous element by a space. Wenn DateTime.ToString() beispielsweise den Wert 1/12/2008 6:15:50 pm zurückgibt, ToString() gibt den Wert 1/12/2008 6:15:50 pm-08:00 für eine Zeit zurück, die acht Stunden hinter der koordinierten Weltzeit (UTC) liegt.For example, if DateTime.ToString() returns a value of 1/12/2008 6:15:50 PM, ToString() returns a value of 1/12/2008 6:15:50 PM -08:00 for a time that is eight hours behind Coordinated Universal Time (UTC).

Diese Methode verwendet Formatierungsinformationen, die von der aktuellen Kultur abgeleitet werden.This method uses formatting information derived from the current culture. Weitere Informationen finden Sie unter CurrentCulture.For more information, see CurrentCulture. Mit anderen über Ladungen der ToString -Methode können Sie die Kultur angeben, deren Formatierung verwendet werden soll, sowie das Ausgabemuster DateTimeOffset 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 DateTimeOffset 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 DateTimeOffset 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 DateTimeOffset 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. DateTimeOffset. ToString. ArgumentOutOfRangeException # 2] [! Code-vbSystem. DateTimeOffset. ToString. ArgumentOutOfRangeException # 2][!code-csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#2] [!code-vbSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#2]

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

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

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

Parameter

formatProvider
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 DateTimeOffset-Objekts entsprechend den Angaben in formatProvider.A string representation of the value of the current DateTimeOffset object, as specified by formatProvider.

Ausnahmen

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

Beispiele

Im folgenden Beispiel wird ein DateTimeOffset -Objekt CultureInfo mit-Objekten angezeigt, die die invariante Kultur darstellen, sowie vier weitere Kulturen.The following example displays a DateTimeOffset object using CultureInfo objects that represent the invariant culture, as well as four other cultures.

CultureInfo[] cultures = new CultureInfo[] {CultureInfo.InvariantCulture, 
                                           new CultureInfo("en-us"), 
                                           new CultureInfo("fr-fr"), 
                                           new CultureInfo("de-DE"), 
                                           new CultureInfo("es-ES")};

DateTimeOffset thisDate = new DateTimeOffset(2007, 5, 1, 9, 0, 0, 
                                             TimeSpan.Zero);                                            

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/2007 09:00:00 +00:00
//    In en-US, 5/1/2007 9:00:00 AM +00:00
//    In fr-FR, 01/05/2007 09:00:00 +00:00
//    In de-DE, 01.05.2007 09:00:00 +00:00
//    In es-ES, 01/05/2007 9:00:00 +00:00
Dim cultures() As CultureInfo = {CultureInfo.InvariantCulture, _
                                 New CultureInfo("en-us"), _
                                 New CultureInfo("fr-fr"), _
                                 New CultureInfo("de-DE"), _
                                 New CultureInfo("es-ES")}

Dim thisDate As New DateTimeOffset(#5/1/2007 9:00AM#, TimeSpan.Zero)                                            

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                                            
' The example produces the following output:
'    In Invariant Language (Invariant Country), 05/01/2007 09:00:00 +00:00
'    In en-US, 5/1/2007 9:00:00 AM +00:00
'    In fr-FR, 01/05/2007 09:00:00 +00:00
'    In de-DE, 01.05.2007 09:00:00 +00:00
'    In es-ES, 01/05/2007 9:00:00 +00:00

Hinweise

Der Rückgabewert dieser Methode ist identisch mit der entsprechenden DateTime.ToString Überladung der-Methode, mit dem Unterschied, dass Sie ein Leerzeichen gefolgt von dem am Ende der Zeichenfolge angefügten Offset enthält.The return value of this method is identical to that of its equivalent overload of the DateTime.ToString method, except that it includes a space followed by the offset appended at the end of the string. Das heißt, die Ausgabe wird mit dem kurzen Datums Muster, dem langen Zeitmuster und der zzz benutzerdefinierten Format Zeichenfolge formatiert, wobei jedes Element durch ein Leerzeichen vom vorherigen Element getrennt ist.In other words, it formats output using the short date pattern, the long time pattern, and the zzz custom format string, with each element separated from the previous element by a space.

Das Format dieser drei Elemente wird durch den formatProvider -Parameter definiert.The format of these three elements is defined by the formatProvider parameter. Der formatProvider Parameter kann eine der folgenden sein:The formatProvider parameter can be either of the following:

formatProvider DateTimeFormatInfo Wenn den Wert CurrentCulturehat, wird das-Objekt verwendet, das der aktuellen Kultur zugeordnet ist (siehe). nullIf formatProvider is null, the DateTimeFormatInfo object associated with the current culture is used (see 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 formatProvider 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 formatProvider parameter. Der Kalender wird durch die Calendar -Eigenschaft definiert.Its calendar is defined by the Calendar property. Wenn DateTimeOffset 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 DateTimeOffset 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. DateTimeOffset. ToString. ArgumentOutOfRangeException # 1] [! Code-vbSystem. DateTimeOffset. ToString. ArgumentOutOfRangeException # 1][!code-csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#1] [!code-vbSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#1]

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

Konvertiert den Wert des aktuellen DateTimeOffset-Objekts unter Verwendung des angegebenen Formats in die entsprechende Zeichenfolgendarstellung.Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified format.

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 Formatzeichenfolge.A format string.

Gibt zurück

Die Zeichenfolgendarstellung des Werts des aktuellen DateTimeOffset-Objekts entsprechend den Angaben in format.A string representation of the value of the current DateTimeOffset object, as specified by format.

Ausnahmen

Die Länge des format ist 1, und es ist keines der standardmäßigen Formatbezeichnerzeichen, die für DateTimeFormatInfo definiert sind.The length of format is one, and it is not one of the standard 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 ein DateTimeOffset -Objekt für die Konsole mit jedem der Standardformat Bearbeiter für Datum und Uhrzeit angezeigt.The following example displays a DateTimeOffset object to the console using each of the standard date and time format specifiers. Die Ausgabe wird mit der Kultur "en-US" formatiert.The output is formatted by using the en-us culture.

DateTimeOffset outputDate = new DateTimeOffset(2007, 10, 31, 21, 0, 0, 
                                     new TimeSpan(-8, 0, 0));
string specifier; 
      
// Output date using each standard date/time format specifier
specifier = "d";
// Displays   d: 10/31/2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

specifier = "D";
// Displays   D: Wednesday, October 31, 2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

specifier = "t";
// Displays   t: 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

specifier = "T";
// Displays   T: 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

specifier = "f";
// Displays   f: Wednesday, October 31, 2007 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

specifier = "F";
// Displays   F: Wednesday, October 31, 2007 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

specifier = "g";
// Displays   g: 10/31/2007 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

specifier = "G";
// Displays   G: 10/31/2007 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

specifier = "M";           // 'm' is identical
// Displays   M: October 31
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

specifier = "R";           // 'r' is identical
// Displays   R: Thu, 01 Nov 2007 05:00:00 GMT
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

specifier = "s";
// Displays   s: 2007-10-31T21:00:00
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

specifier = "u";
// Displays   u: 2007-11-01 05:00:00Z
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

// Specifier is not supported
specifier = "U";
try
{
   Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));
}    
catch (FormatException)
{
   Console.WriteLine("{0}: Not supported.", specifier);   
}

specifier = "Y";         // 'y' is identical
// Displays   Y: October, 2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 
Dim outputDate As New DateTimeOffset(#10/31/2007 9:00PM#, _
                                     New TimeSpan(-8, 0, 0))
Dim specifier As String 
      
' Output date using each standard date/time format specifier
specifier = "d"
' Displays   d: 10/31/2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "D"
' Displays   D: Wednesday, October 31, 2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "t"
' Displays   t: 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "T"
' Displays   T: 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "f"
' Displays   f: Wednesday, October 31, 2007 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "F"
' Displays   F: Wednesday, October 31, 2007 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "g"
' Displays   g: 10/31/2007 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "G"
' Displays   G: 10/31/2007 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "M"           ' 'm' is identical
' Displays   M: October 31
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "R"           ' 'r' is identical
' Displays   R: Thu, 01 Nov 2007 05:00:00 GMT
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "s"
' Displays   s: 2007-10-31T21:00:00
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "u"
' Displays   u: 2007-11-01 05:00:00Z
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

' Specifier is not supported
specifier = "U"
Try
   Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 
Catch e As FormatException
   Console.WriteLine("{0}: Not supported.", specifier)   
End Try

specifier = "Y"         ' 'y' is identical
' Displays   Y: October, 2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

Hinweise

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 eine NULL-Zeichenfolge oder eine leere Zeichenfolge (" DateTimeOffset ") ist, wird der Wert mit dem Standardformat ausgegeben.If format is a null or empty string (""), the DateTimeOffset value is output using the default format.

In der folgenden Tabelle wird die genaue Ausführung bestimmter Format Bearbeiter bei der Verwendung DateTimeOffsetmit veranschaulicht. Dies unterscheidet sich von Ihrem DateTimeVerhalten bei der Verwendung mit.The following table shows the exact operation of certain format specifiers when used with DateTimeOffset, which differs from their behavior when used with DateTime.

Vorhandener Format BezeichnerExisting format specifier Neues VerhaltenNew behavior
"K""K" Dient zum Roundtrip für ein Datum und eine Uhrzeit.Designed to round-trip a date and time. Mit DateTimeOffsetwird "zzz" zugeordnet (der Offset wird immer mit Stunden und Minuten angezeigt).With DateTimeOffset, maps to "zzz" (the offset is always displayed with hours and minutes). Beachten Sie, dass "K" ein benutzerdefinierter Format Bezeichner ist. Er darf nicht als einzelnes Zeichen in formaterscheinen.Note that "K" is a custom format specifier; it cannot appear as the single character in format.
"U""U" Wird nicht unterstützt.Not supported.
"r""r" Konvertiert das DateTimeOffset Objekt in eine koordinierte Weltzeit (UTC) und gibt es mithilfe der benutzerdefinierten ddd, dd MMM yyyy HH:mm:ss GMTFormat Zeichenfolge aus.Converts the DateTimeOffset object to Coordinated Universal Time (UTC) and outputs it using the custom format string ddd, dd MMM yyyy HH:mm:ss GMT.
"u""u" Konvertiert das DateTimeOffset -Objekt in UTC und gibt es mit dem yyyy-MM-dd HH:mm:ssZ-Format aus.Converts the DateTimeOffset object to UTC and outputs it using the format yyyy-MM-dd HH:mm:ssZ.

Die verbleibenden Standardformat Bearbeiter für ToString(String) ToString Datum und Uhrzeit Verhalten sich mit der-Methode identisch mit der-Methode.The remaining standard date and time format specifiers behave the same with the ToString(String) method as they do with the ToString method.

Diese Methode verwendet Formatierungsinformationen, die von der aktuellen Kultur abgeleitet werden.This method uses formatting information derived from the current culture. Weitere Informationen finden Sie unter CurrentCulture.For more information, see CurrentCulture.

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 DateTimeOffset 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 DateTimeOffset 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. DateTimeOffset. ToString. ArgumentOutOfRangeException # 3] [! Code-vbSystem. DateTimeOffset. ToString. ArgumentOutOfRangeException # 3][!code-csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#3] [!code-vbSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#3]

Siehe auch

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

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

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

Parameter

format
String String String String

Eine Formatierungszeichenfolge.A format string.

formatProvider
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 DateTimeOffset-Objekts wie von format und provider angegeben.A string representation of the value of the current DateTimeOffset object, as specified by format and provider.

Implementiert

Ausnahmen

Die Länge des format ist 1, und es ist keines der standardmäßigen Formatbezeichnerzeichen, die für DateTimeFormatInfo definiert sind.The length of format is one, and it is not one of the standard 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 formatProvider verwendet wird.The date and time is outside the range of dates supported by the calendar used by formatProvider.

Beispiele

Im folgenden Beispiel wird die ToString(String, IFormatProvider) -Methode verwendet, DateTimeOffset um ein-Objekt mit einer benutzerdefinierten Format Zeichenfolge für verschiedene Kulturen anzuzeigen.The following example uses the ToString(String, IFormatProvider) method to display a DateTimeOffset object using a custom format string for several different cultures.

DateTimeOffset outputDate = new DateTimeOffset(2007, 11, 1, 9, 0, 0, 
                                     new TimeSpan(-7, 0, 0)); 
string format = "dddd, MMM dd yyyy HH:mm:ss zzz";

// Output date and time using custom format specification
Console.WriteLine(outputDate.ToString(format, null as DateTimeFormatInfo));
Console.WriteLine(outputDate.ToString(format, CultureInfo.InvariantCulture));
Console.WriteLine(outputDate.ToString(format, 
                                      new CultureInfo("fr-FR")));
Console.WriteLine(outputDate.ToString(format, 
                                      new CultureInfo("es-ES")));
// The example displays the following output to the console:
//    Thursday, Nov 01 2007 09:00:00 -07:00
//    Thursday, Nov 01 2007 09:00:00 -07:00
//    jeudi, nov. 01 2007 09:00:00 -07:00
//    jueves, nov 01 2007 09:00:00 -07:00
Dim outputDate As New DateTimeOffset(#11/1/2007 9:00AM#, _
                                     New TimeSpan(-7, 0, 0)) 
Dim format As String = "dddd, MMM dd yyyy HH:mm:ss zzz"

' Output date and time using custom format specification
Console.WriteLine(outputDate.ToString(format, Nothing))
Console.WriteLine(outputDate.ToString(format, CultureInfo.InvariantCulture))
Console.WriteLine(outputDate.ToString(format, _
                                      New CultureInfo("fr-FR")))
Console.WriteLine(outputDate.ToString(format, _
                                      New CultureInfo("es-ES")))
' The example displays the following output to the console:
'    Thursday, Nov 01 2007 09:00:00 -07:00
'    Thursday, Nov 01 2007 09:00:00 -07:00
'    jeudi, nov. 01 2007 09:00:00 -07:00
'    jueves, nov 01 2007 09:00:00 -07:00

Hinweise

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.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). Wenn format eine NULL-Zeichenfolge oder eine leere Zeichenfolge (" DateTimeOffset ") ist, wird das Objekt mit dem Standardformat ausgegeben.If format is a null or empty string (""), the DateTimeOffset object is output using the default format.

In der folgenden Tabelle wird die genaue Ausführung bestimmter Format Bearbeiter bei der Verwendung DateTimeOffsetmit veranschaulicht. Dies unterscheidet sich von Ihrem DateTimeVerhalten bei der Verwendung mit.The following table shows the exact operation of certain format specifiers when used with DateTimeOffset, which differs from their behavior when used with DateTime.

Vorhandener Format BezeichnerExisting format specifier Neues VerhaltenNew behavior
"K""K" Dient zum Roundtrip für ein Datum und eine Uhrzeit.Designed to round-trip a date and time. Mit DateTimeOffsetwird "zzz" zugeordnet (der Offset wird immer mit Stunden und Minuten angezeigt).With DateTimeOffset, maps to "zzz" (the offset is always displayed with hours and minutes). Beachten Sie, dass "K" ein benutzerdefinierter Format Bezeichner ist. Er darf nicht als einzelnes Zeichen in formaterscheinen.Note that "K" is a custom format specifier; it cannot appear as the single character in format.
"U""U" Wird nicht unterstützt.Not supported.
"r""r" Konvertiert das DateTimeOffset Objekt in eine koordinierte Weltzeit (UTC) und gibt es mithilfe der benutzerdefinierten ddd, dd MMM yyyy HH:mm:ss GMTFormat Zeichenfolge aus.Converts the DateTimeOffset object to Coordinated Universal Time (UTC) and outputs it using the custom format string ddd, dd MMM yyyy HH:mm:ss GMT.
"u""u" Konvertiert den DateTimeOffset Wert in UTC und gibt ihn mit dem- yyyy-MM-dd HH:mm:ssZFormat aus.Converts the DateTimeOffset value to UTC and outputs it using the format yyyy-MM-dd HH:mm:ssZ.

Die verbleibenden Standardformat Bearbeiter für ToString(String) ToString Datum und Uhrzeit Verhalten sich mit der-Methode identisch mit der-Methode.The remaining standard date and time format specifiers behave the same with the ToString(String) method as they do with the ToString method.

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

formatProvider DateTimeFormatInfo Wenn den Wert CurrentCulturehat, wird das-Objekt verwendet, das der aktuellen Kultur zugeordnet ist (siehe). nullIf formatProvider is null, the DateTimeFormatInfo object associated with the current culture is used (see CurrentCulture).

Hinweise für Aufrufer

Die ToString(String, IFormatProvider) -Methode gibt die Zeichen folgen Darstellung des Datums und der Uhrzeit im Kalender zurück, formatProvider 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 formatProvider parameter. Der Kalender wird durch die Calendar -Eigenschaft definiert.Its calendar is defined by the Calendar property. Wenn DateTimeOffset 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 DateTimeOffset 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. DateTimeOffset. ToString. ArgumentOutOfRangeException # 4] [! Code-vbSystem. DateTimeOffset. ToString. ArgumentOutOfRangeException # 4][!code-csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#4] [!code-vbSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#4]

Siehe auch

Gilt für: