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 kulturspezifischen 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 auf einem System, dessen aktuelle Kultur En-us.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 der DateTime.ToString() Methode, mit dem Unterschied, dass die It ein Leerzeichen enthält, gefolgt von dem am Ende der Zeichenfolge angefügten Offset.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, es formatiert die Ausgabe, die mit dem langen Datumsmuster, das kurze Datumsmuster und zzz benutzerdefinierte Formatzeichenfolge, wobei jedes Element aus dem vorherigen Element durch ein Leerzeichen getrennt.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. Z. B. wenn DateTime.ToString() gibt einen Wert von 1/12/2008 6:15:50 PM, ToString() gibt einen Wert von 1/12/2008 6:15:50 PM-08: 00 für eine Zeit, die acht Stunden hinter der Coordinated Universal Time (UTC) ist.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 die Formatierungsinformationen, die von der aktuellen Kultur abgeleitet.This method uses formatting information derived from the current culture. Weitere Informationen finden Sie unter CurrentCulture.For more information, see CurrentCulture. Andere Überladungen der ToString Methode können Sie die Kultur angeben, deren Formatierung verwendet, und klicken Sie zum Definieren der Ausgabe-Muster von den DateTimeOffset Wert.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 eine Zeichenfolgendarstellung von Datum und Uhrzeit zurück, in der von der aktuellen Kultur verwendeten Kalenders.The ToString() method returns the string representation of the date and time in the calendar used by the current culture. Wenn der Wert des aktuellen DateTimeOffset Instanz liegt vor MinSupportedDateTime oder später als MaxSupportedDateTime, löst die Methode eine ArgumentOutOfRangeException.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 versucht, ein Datum zu formatieren, die außerhalb des Bereichs von ist das HijriCalendar Klasse, 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 kulturspezifischen 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

Das folgende Beispiel zeigt eine DateTimeOffset -Objekt unter Verwendung der CultureInfo Objekte, die die invariante Kultur sowie vier anderen Kulturen darstellen.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 Überladung von der DateTime.ToString Methode, mit dem Unterschied, dass die It ein Leerzeichen enthält, gefolgt von dem am Ende der Zeichenfolge angefügten Offset.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, es formatiert die Ausgabe, die mit dem langen Datumsmuster, das kurze Datumsmuster und zzz benutzerdefinierte Formatzeichenfolge, wobei jedes Element aus dem vorherigen Element durch ein Leerzeichen getrennt.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 definiert, durch die formatProvider Parameter.The format of these three elements is defined by the formatProvider parameter. Die formatProvider Parameter kann eine der folgenden sein:The formatProvider parameter can be either of the following:

Wenn formatProvider ist null, DateTimeFormatInfo -Objekt der aktuellen Kultur zugeordnet werden (finden Sie unter CurrentCulture).If formatProvider is null, the DateTimeFormatInfo object associated with the current culture is used (see CurrentCulture).

Hinweise für Aufrufer

Die ToString(IFormatProvider) Methode gibt eine Zeichenfolgendarstellung von Datum und Uhrzeit im Kalender verwendet, die von der Kultur, dargestellt durch die formatProvider Parameter.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 definiert, indem die Calendar Eigenschaft.Its calendar is defined by the Calendar property. Wenn der Wert des aktuellen DateTimeOffset Instanz liegt vor MinSupportedDateTime oder später als MaxSupportedDateTime, löst die Methode eine ArgumentOutOfRangeException.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 versucht, ein Datum zu formatieren, die außerhalb des Bereichs von ist das JapaneseCalendar Klasse.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

Das folgende Beispiel zeigt eine DateTimeOffset Objekt in der Konsole unter Verwendung der Standardformatbezeichner für Datum und Uhrzeit.The following example displays a DateTimeOffset object to the console using each of the standard date and time format specifiers. Die Ausgabe so formatiert wird, mithilfe der En-us Kultur.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

Die format -Parameter sollte entweder einen einzelnen Formatbezeichner enthalten (finden Sie unter Standardformatzeichenfolgen für Datum und Uhrzeit-Formatzeichenfolgen) oder ein benutzerdefiniertes Formatmuster (finden Sie unter Custom Date and Time Format Strings ), definiert das Format der zurückgegebenen Zeichenfolge.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 ist null oder eine leere Zeichenfolge (""), wird die DateTimeOffset -Wert mithilfe des Standardformats ausgegeben.If format is a null or empty string (""), the DateTimeOffset value is output using the default format.

Die folgende Tabelle zeigt die genaue Operation von bestimmten Formatbezeichnern, die bei der Verwendung mit DateTimeOffset, unterscheidet sich ihr Verhalten bei der Verwendung mit DateTime.The following table shows the exact operation of certain format specifiers when used with DateTimeOffset, which differs from their behavior when used with DateTime.

Vorhandene FormatbezeichnerExisting format specifier Neues VerhaltenNew behavior
"K""K" Round-Trip soll ein Datums- und Uhrzeitwert.Designed to round-trip a date and time. Mit DateTimeOffset, ordnet "Zzz" (der Offset wird immer angezeigt, mit Stunden und Minuten).With DateTimeOffset, maps to "zzz" (the offset is always displayed with hours and minutes). Beachten Sie, dass "K" benutzerdefinierter Formatbezeichner; Es darf nicht als einzelne Zeichen im format.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 die DateTimeOffset Objekt in die koordinierte Weltzeit (UTC) und gibt diesen mit der benutzerdefinierten Formatzeichenfolge ddd, dd MMM yyyy HH:mm:ss GMT.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 die DateTimeOffset Objekt in die UTC und gibt diesen mit dem Format yyyy-MM-dd HH:mm:ssZ.Converts the DateTimeOffset object to UTC and outputs it using the format yyyy-MM-dd HH:mm:ssZ.

Verbleibende Standardformatbezeichner für Datum und Uhrzeit, Verhalten Sie sich bei der ToString(String) Methode wie bei der ToString 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 die Formatierungsinformationen, die von der aktuellen Kultur abgeleitet.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 eine Zeichenfolgendarstellung von Datum und Uhrzeit zurück, in der von der aktuellen Kultur verwendeten Kalenders.The ToString(String) method returns the string representation of the date and time in the calendar used by the current culture. Wenn der Wert des aktuellen DateTimeOffset Instanz liegt vor MinSupportedDateTime oder später als MaxSupportedDateTime, löst die Methode eine ArgumentOutOfRangeException.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 versucht, ein Datum zu formatieren, die außerhalb des Bereichs von ist das HebrewCalendar Klasse, 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 Formatzeichenfolge.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 zum Anzeigen einer DateTimeOffset -Objekt unter Verwendung einer benutzerdefinierten Formatzeichenfolge für verschiedene Kulturen.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

Die format -Parameter sollte entweder einen einzelnen Formatbezeichner enthalten (finden Sie unter Standardformatzeichenfolgen für Datum und Uhrzeit-Formatzeichenfolgen) oder ein benutzerdefiniertes Formatmuster (finden Sie unter Custom Date and Time Format Strings ).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 ist null oder eine leere Zeichenfolge (""), wird die DateTimeOffset -Objekt mithilfe des Standardformats ausgegeben.If format is a null or empty string (""), the DateTimeOffset object is output using the default format.

Die folgende Tabelle zeigt die genaue Operation von bestimmten Formatbezeichnern, die bei der Verwendung mit DateTimeOffset, unterscheidet sich ihr Verhalten bei der Verwendung mit DateTime.The following table shows the exact operation of certain format specifiers when used with DateTimeOffset, which differs from their behavior when used with DateTime.

Vorhandene FormatbezeichnerExisting format specifier Neues VerhaltenNew behavior
"K""K" Round-Trip soll ein Datums- und Uhrzeitwert.Designed to round-trip a date and time. Mit DateTimeOffset, ordnet "Zzz" (der Offset wird immer angezeigt, mit Stunden und Minuten).With DateTimeOffset, maps to "zzz" (the offset is always displayed with hours and minutes). Beachten Sie, dass "K" benutzerdefinierter Formatbezeichner; Es darf nicht als einzelne Zeichen im format.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 die DateTimeOffset Objekt in die koordinierte Weltzeit (UTC) und gibt diesen mit der benutzerdefinierten Formatzeichenfolge ddd, dd MMM yyyy HH:mm:ss GMT.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 die DateTimeOffset Wert in UTC und gibt diesen mit dem Format yyyy-MM-dd HH:mm:ssZ.Converts the DateTimeOffset value to UTC and outputs it using the format yyyy-MM-dd HH:mm:ssZ.

Verbleibende Standardformatbezeichner für Datum und Uhrzeit, Verhalten Sie sich bei der ToString(String) Methode wie bei der ToString 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 Standardformatbezeichner, als auch die Symbole und die Namen der Datums- und Zeitkomponenten, entspricht, wird definiert, durch die formatProvider Parameter.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. Die formatProvider Parameter kann eine der folgenden sein:The formatProvider parameter can be either of the following:

Wenn formatProvider ist null, DateTimeFormatInfo -Objekt der aktuellen Kultur zugeordnet werden (finden Sie unter CurrentCulture).If 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 eine Zeichenfolgendarstellung von Datum und Uhrzeit im Kalender ein, die die formatProvider Parameter.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 definiert, indem die Calendar Eigenschaft.Its calendar is defined by the Calendar property. Wenn der Wert des aktuellen DateTimeOffset Instanz liegt vor MinSupportedDateTime oder später als MaxSupportedDateTime, löst die Methode eine ArgumentOutOfRangeException.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 versucht, ein Datum zu formatieren, die außerhalb des Bereichs von ist das UmAlQuraCalendar Klasse.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: