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

Definizione

Converte il valore dell'oggetto DateTimeOffset corrente nella rappresentazione di stringa equivalente.Converts the value of the current DateTimeOffset object to its equivalent string representation.

Overload

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

Converte il valore dell'oggetto DateTimeOffset corrente nella rappresentazione di stringa equivalente.Converts the value of the current DateTimeOffset object to its equivalent string representation.

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

Converte il valore dell'oggetto DateTimeOffset corrente nella rappresentazione di stringa equivalente, usando le informazioni di formattazione specifiche delle impostazioni cultura definite.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)

Converte il valore dell'oggetto DateTimeOffset corrente nella rappresentazione di stringa equivalente, usando il formato specificato.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)

Converte il valore dell'oggetto DateTimeOffset corrente nella rappresentazione di stringa equivalente, usando il formato specificato e le informazioni sul formato specifiche delle impostazioni cultura indicate.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()

Converte il valore dell'oggetto DateTimeOffset corrente nella rappresentazione di stringa equivalente.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

Restituisce

Rappresentazione di stringa di un oggetto DateTimeOffset che include l'offset aggiunto alla fine della stringa.A string representation of a DateTimeOffset object that includes the offset appended at the end of the string.

Eccezioni

La data e l'ora non sono comprese nell'intervallo di date supportato dal calendario usato dalle impostazioni cultura correnti.The date and time is outside the range of dates supported by the calendar used by the current culture.

Esempi

Nell'esempio seguente vengono illustrate le chiamate ToString() al metodo e ne viene visualizzato l'output in un sistema le cui impostazioni cultura correnti sono 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

Commenti

Il valore restituito di questo metodo è identico a quello del DateTime.ToString() metodo, ad eccezione del fatto che include uno spazio seguito dall'offset aggiunto alla fine della stringa.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. In altre parole, formatta l'output usando il modello di data breve, il modello di ora estesa e zzz la stringa di formato personalizzata, con ogni elemento separato dall'elemento precedente per uno spazio.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. Se DateTime.ToString() , ad esempio, restituisce il valore 1/12/2008 6:15:50 PM, ToString() restituisce il valore 1/12/2008 6:15:50 pm-08:00 per un'ora che corrisponde a otto ore rispetto all'ora UTC (Coordinated Universal Time).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).

Questo metodo usa le informazioni di formattazione derivate dalle impostazioni cultura correnti.This method uses formatting information derived from the current culture. Per ulteriori informazioni, vedere CurrentCulture.For more information, see CurrentCulture. Altri overload del ToString metodo consentono di specificare le impostazioni cultura di cui usare la formattazione e di definire il modello DateTimeOffset di output del valore.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.

Note per i chiamanti

Il ToString() metodo restituisce la rappresentazione di stringa della data e dell'ora nel calendario utilizzato dalle impostazioni cultura correnti.The ToString() method returns the string representation of the date and time in the calendar used by the current culture. Se il valore dell'istanza corrente DateTimeOffset è MinSupportedDateTime precedente a o successivo MaxSupportedDateTimea, il metodo genera un' ArgumentOutOfRangeExceptioneccezione.If the value of the current DateTimeOffset instance is earlier than MinSupportedDateTime or later than MaxSupportedDateTime, the method throws an ArgumentOutOfRangeException. Nell'esempio seguente viene illustrato questo concetto.The following example provides an illustration. Tenta di formattare una data non compresa nell'intervallo della HijriCalendar classe quando le impostazioni cultura correnti sono arabe (Siria).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)

Converte il valore dell'oggetto DateTimeOffset corrente nella rappresentazione di stringa equivalente, usando le informazioni di formattazione specifiche delle impostazioni cultura definite.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

Parametri

formatProvider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura.An object that supplies culture-specific formatting information.

Restituisce

Rappresentazione di stringa del valore dell'oggetto DateTimeOffset corrente, come specificato da formatProvider.A string representation of the value of the current DateTimeOffset object, as specified by formatProvider.

Eccezioni

La data e l'ora non sono comprese nell'intervallo di date supportato dal calendario usato da formatProvider.The date and time is outside the range of dates supported by the calendar used by formatProvider.

Esempi

Nell'esempio seguente viene visualizzato DateTimeOffset un oggetto CultureInfo utilizzando oggetti che rappresentano le impostazioni cultura invarianti, nonché altre quattro impostazioni cultura.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

Commenti

Il valore restituito di questo metodo è identico a quello dell'overload equivalente del DateTime.ToString metodo, ad eccezione del fatto che include uno spazio seguito dall'offset aggiunto alla fine della stringa.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. In altre parole, formatta l'output usando il modello di data breve, il modello di ora estesa e zzz la stringa di formato personalizzata, con ogni elemento separato dall'elemento precedente per uno spazio.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.

Il formato di questi tre elementi è definito dal formatProvider parametro.The format of these three elements is defined by the formatProvider parameter. Il formatProvider parametro può essere uno dei seguenti:The formatProvider parameter can be either of the following:

Se formatProvider DateTimeFormatInfo CurrentCultureè null, viene utilizzato l'oggetto associato alle impostazioni cultura correnti (vedere).If formatProvider is null, the DateTimeFormatInfo object associated with the current culture is used (see CurrentCulture).

Note per i chiamanti

Il ToString(IFormatProvider) metodo restituisce la rappresentazione di stringa della data e dell'ora nel calendario utilizzate dalle impostazioni cultura rappresentate formatProvider dal parametro.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. Il Calendar calendario è definito dalla proprietà.Its calendar is defined by the Calendar property. Se il valore dell'istanza corrente DateTimeOffset è MinSupportedDateTime precedente a o successivo MaxSupportedDateTimea, il metodo genera un' ArgumentOutOfRangeExceptioneccezione.If the value of the current DateTimeOffset instance is earlier than MinSupportedDateTime or later than MaxSupportedDateTime, the method throws an ArgumentOutOfRangeException. Nell'esempio seguente viene illustrato questo concetto.The following example provides an illustration. Tenta di formattare una data non compresa nell'intervallo della JapaneseCalendar classe.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)

Converte il valore dell'oggetto DateTimeOffset corrente nella rappresentazione di stringa equivalente, usando il formato specificato.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

Parametri

format
String String String String

Stringa di formato.A format string.

Restituisce

Rappresentazione di stringa del valore dell'oggetto DateTimeOffset corrente, come specificato da format.A string representation of the value of the current DateTimeOffset object, as specified by format.

Eccezioni

La lunghezza di format è 1 e non è uno dei caratteri identificatori di formato standard definiti per DateTimeFormatInfo.The length of format is one, and it is not one of the standard format specifier characters defined for DateTimeFormatInfo.

In alternativa-or- format non contiene un modello di formato personalizzato valido.format does not contain a valid custom format pattern.

La data e l'ora non sono comprese nell'intervallo di date supportato dal calendario usato dalle impostazioni cultura correnti.The date and time is outside the range of dates supported by the calendar used by the current culture.

Esempi

Nell'esempio seguente un DateTimeOffset oggetto viene visualizzato nella console utilizzando ciascuno degli identificatori di formato di data e ora standard.The following example displays a DateTimeOffset object to the console using each of the standard date and time format specifiers. L'output viene formattato utilizzando le impostazioni cultura en-US.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)) 

Commenti

Il format parametro deve contenere un singolo carattere identificatore di formato (vedere stringhe di formato di data e ora standard) o un modello di formato personalizzato (vedere stringhe di formato di data e ora personalizzato) che definisce il formato dell'oggetto restituito. stringa.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. Se format è una stringa vuota o null (""), il DateTimeOffset valore viene restituito utilizzando il formato predefinito.If format is a null or empty string (""), the DateTimeOffset value is output using the default format.

Nella tabella seguente viene illustrata l'esatta operazione di determinati identificatori di formato DateTimeOffsetse utilizzata con, che differisce dal comportamento quando DateTimeviene utilizzato con.The following table shows the exact operation of certain format specifiers when used with DateTimeOffset, which differs from their behavior when used with DateTime.

Identificatore di formato esistenteExisting format specifier Nuovo comportamentoNew behavior
"K""K" Progettato per eseguire il round trip di una data e ora.Designed to round-trip a date and time. Con DateTimeOffsetviene eseguito il mapping a "zzz" (l'offset viene sempre visualizzato con ore e minuti).With DateTimeOffset, maps to "zzz" (the offset is always displayed with hours and minutes). Si noti che "K" è un identificatore di formato personalizzato; non può essere visualizzato come carattere singolo in format.Note that "K" is a custom format specifier; it cannot appear as the single character in format.
"U""U" Non supportato.Not supported.
r"r" Converte l' DateTimeOffset oggetto nell'ora UTC (Coordinated Universal Time) e lo restituisce usando la stringa ddd, dd MMM yyyy HH:mm:ss GMTdi formato personalizzata.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" Converte l' DateTimeOffset oggetto in formato UTC e lo restituisce utilizzando il yyyy-MM-dd HH:mm:ssZformato.Converts the DateTimeOffset object to UTC and outputs it using the format yyyy-MM-dd HH:mm:ssZ.

Gli identificatori di formato di data e ora standard rimanenti si comportano allo stesso modo ToString(String) con ToString il metodo, come avviene con il metodo.The remaining standard date and time format specifiers behave the same with the ToString(String) method as they do with the ToString method.

Questo metodo usa le informazioni di formattazione derivate dalle impostazioni cultura correnti.This method uses formatting information derived from the current culture. Per ulteriori informazioni, vedere CurrentCulture.For more information, see CurrentCulture.

Note per i chiamanti

Il ToString(String) metodo restituisce la rappresentazione di stringa della data e dell'ora nel calendario utilizzato dalle impostazioni cultura correnti.The ToString(String) method returns the string representation of the date and time in the calendar used by the current culture. Se il valore dell'istanza corrente DateTimeOffset è MinSupportedDateTime precedente a o successivo MaxSupportedDateTimea, il metodo genera un' ArgumentOutOfRangeExceptioneccezione.If the value of the current DateTimeOffset instance is earlier than MinSupportedDateTime or later than MaxSupportedDateTime, the method throws an ArgumentOutOfRangeException. Nell'esempio seguente viene illustrato questo concetto.The following example provides an illustration. Tenta di formattare una data non compresa nell'intervallo della HebrewCalendar classe quando le impostazioni cultura correnti sono ebraiche (Israele).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]

Vedi anche

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

Converte il valore dell'oggetto DateTimeOffset corrente nella rappresentazione di stringa equivalente, usando il formato specificato e le informazioni sul formato specifiche delle impostazioni cultura indicate.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

Parametri

format
String String String String

Stringa di formato.A format string.

formatProvider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura.An object that supplies culture-specific formatting information.

Restituisce

Rappresentazione di stringa del valore dell'oggetto DateTimeOffset corrente, come specificato da format e provider.A string representation of the value of the current DateTimeOffset object, as specified by format and provider.

Implementazioni

Eccezioni

La lunghezza di format è 1 e non è uno dei caratteri identificatori di formato standard definiti per DateTimeFormatInfo.The length of format is one, and it is not one of the standard format specifier characters defined for DateTimeFormatInfo.

In alternativa-or- format non contiene un modello di formato personalizzato valido.format does not contain a valid custom format pattern.

La data e l'ora non sono comprese nell'intervallo di date supportato dal calendario usato da formatProvider.The date and time is outside the range of dates supported by the calendar used by formatProvider.

Esempi

Nell'esempio seguente viene utilizzato ToString(String, IFormatProvider) il metodo per visualizzare DateTimeOffset un oggetto utilizzando una stringa di formato personalizzata per le diverse impostazioni cultura.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

Commenti

Il format parametro deve contenere un singolo carattere identificatore di formato (vedere stringhe di formato di data e ora standard) o un modello di formato personalizzato (vedere stringhe di formato di data e ora personalizzate).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). Se format è una stringa vuota o null (""), l' DateTimeOffset oggetto viene restituito utilizzando il formato predefinito.If format is a null or empty string (""), the DateTimeOffset object is output using the default format.

Nella tabella seguente viene illustrata l'esatta operazione di determinati identificatori di formato DateTimeOffsetse utilizzata con, che differisce dal comportamento quando DateTimeviene utilizzato con.The following table shows the exact operation of certain format specifiers when used with DateTimeOffset, which differs from their behavior when used with DateTime.

Identificatore di formato esistenteExisting format specifier Nuovo comportamentoNew behavior
"K""K" Progettato per eseguire il round trip di una data e ora.Designed to round-trip a date and time. Con DateTimeOffsetviene eseguito il mapping a "zzz" (l'offset viene sempre visualizzato con ore e minuti).With DateTimeOffset, maps to "zzz" (the offset is always displayed with hours and minutes). Si noti che "K" è un identificatore di formato personalizzato; non può essere visualizzato come carattere singolo in format.Note that "K" is a custom format specifier; it cannot appear as the single character in format.
"U""U" Non supportato.Not supported.
r"r" Converte l' DateTimeOffset oggetto nell'ora UTC (Coordinated Universal Time) e lo restituisce usando la stringa ddd, dd MMM yyyy HH:mm:ss GMTdi formato personalizzata.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" Converte il DateTimeOffset valore in formato UTC e lo restituisce usando il yyyy-MM-dd HH:mm:ssZformato.Converts the DateTimeOffset value to UTC and outputs it using the format yyyy-MM-dd HH:mm:ssZ.

Gli identificatori di formato di data e ora standard rimanenti si comportano allo stesso modo ToString(String) con ToString il metodo, come avviene con il metodo.The remaining standard date and time format specifiers behave the same with the ToString(String) method as they do with the ToString method.

Il modello che corrisponde agli identificatori di formato standard, nonché i simboli e i nomi dei componenti di data e ora, viene definito dal formatProvider parametro.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. Il formatProvider parametro può essere uno dei seguenti:The formatProvider parameter can be either of the following:

Se formatProvider DateTimeFormatInfo CurrentCultureè null, viene utilizzato l'oggetto associato alle impostazioni cultura correnti (vedere).If formatProvider is null, the DateTimeFormatInfo object associated with the current culture is used (see CurrentCulture).

Note per i chiamanti

Il ToString(String, IFormatProvider) metodo restituisce la rappresentazione di stringa della data e dell'ora nel calendario utilizzato formatProvider dal parametro.The ToString(String, IFormatProvider) method returns the string representation of the date and time in the calendar used by the formatProvider parameter. Il Calendar calendario è definito dalla proprietà.Its calendar is defined by the Calendar property. Se il valore dell'istanza corrente DateTimeOffset è MinSupportedDateTime precedente a o successivo MaxSupportedDateTimea, il metodo genera un' ArgumentOutOfRangeExceptioneccezione.If the value of the current DateTimeOffset instance is earlier than MinSupportedDateTime or later than MaxSupportedDateTime, the method throws an ArgumentOutOfRangeException. Nell'esempio seguente viene illustrato questo concetto.The following example provides an illustration. Tenta di formattare una data non compresa nell'intervallo della UmAlQuraCalendar classe.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]

Vedi anche

Si applica a