DateTimeOffset.ToString Método

Definição

Converte o valor do atual objeto DateTimeOffset na representação de cadeia de caracteres equivalente.Converts the value of the current DateTimeOffset object to its equivalent string representation.

Sobrecargas

ToString()

Converte o valor do atual objeto DateTimeOffset na representação de cadeia de caracteres equivalente.Converts the value of the current DateTimeOffset object to its equivalent string representation.

ToString(IFormatProvider)

Converte o valor do objeto DateTimeOffset atual em sua representação de cadeia de caracteres equivalente usando as informações de formatação específicas da cultura especificadas.Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified culture-specific formatting information.

ToString(String)

Converte o valor do objeto DateTimeOffset atual em sua representação de cadeia de caracteres equivalente usando o formato especificado.Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified format.

ToString(String, IFormatProvider)

Converte o valor do atual objeto DateTimeOffset na representação de cadeia de caracteres equivalente usando o formato especificado e as informações de formato específicas da cultura.Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified format and culture-specific format information.

ToString()

Converte o valor do atual objeto DateTimeOffset na representação de cadeia de caracteres 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

Retornos

Uma representação de cadeia de caracteres de um objeto DateTimeOffset que inclui o deslocamento acrescentado no final da cadeia de caracteres.A string representation of a DateTimeOffset object that includes the offset appended at the end of the string.

Exceções

A data e hora está fora do intervalo de datas suportadas pelo calendário usado pela cultura atual.The date and time is outside the range of dates supported by the calendar used by the current culture.

Exemplos

O exemplo a seguir ilustra as chamadas para o método ToString() e exibe sua saída em um sistema cuja cultura atual é 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

Comentários

O valor de retorno desse método é idêntico ao do método DateTime.ToString(), exceto pelo fato de que ele inclui um espaço seguido pelo deslocamento anexado ao final da cadeia de caracteres.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. Em outras palavras, ele formata a saída usando o padrão de data abreviada, o padrão de hora longa e a zzz cadeia de caracteres de formato personalizado, com cada elemento separado do elemento anterior por um espaço.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. Por exemplo, se DateTime.ToString() retornar um valor de 1/12/2008 6:15:50 PM, ToString() retornará um valor de 1/12/2008 6:15:50 PM-08:00 por um tempo que seja de oito horas atrás do tempo universal coordenado (UTC).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).

Este método usa informações de formatação derivadas da cultura atual.This method uses formatting information derived from the current culture. Para obter mais informações, consulte CurrentCulture.For more information, see CurrentCulture. Outras sobrecargas do método ToString permitem que você especifique a cultura cuja formatação deve ser usada e defina o padrão de saída do valor de DateTimeOffset.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.

Notas aos Chamadores

O método ToString() retorna a representação de cadeia de caracteres da data e hora no calendário usado pela cultura atual.The ToString() method returns the string representation of the date and time in the calendar used by the current culture. Caso o valor da instância DateTimeOffset atual seja anterior a MinSupportedDateTime ou posterior a MaxSupportedDateTime, o método lança um ArgumentOutOfRangeException.If the value of the current DateTimeOffset instance is earlier than MinSupportedDateTime or later than MaxSupportedDateTime, the method throws an ArgumentOutOfRangeException. O exemplo a seguir ilustra esse cenário.The following example provides an illustration. Ele tenta formatar uma data que está fora do intervalo da classe HijriCalendar quando a cultura atual é árabe (Síria).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)

Converte o valor do objeto DateTimeOffset atual em sua representação de cadeia de caracteres equivalente usando as informações de formatação específicas da cultura especificadas.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

Parâmetros

formatProvider
IFormatProvider

Um objeto que fornece informações de formatação específicas da cultura.An object that supplies culture-specific formatting information.

Retornos

Uma representação de cadeia de caracteres do valor do objeto DateTimeOffset atual, conforme especificado por formatProvider.A string representation of the value of the current DateTimeOffset object, as specified by formatProvider.

Exceções

A data e hora estão fora do intervalo de datas com suporte no calendário usado por formatProvider.The date and time is outside the range of dates supported by the calendar used by formatProvider.

Exemplos

O exemplo a seguir exibe um objeto DateTimeOffset usando CultureInfo objetos que representam a cultura invariável, bem como quatro outras culturas.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

Comentários

O valor de retorno desse método é idêntico ao de sua sobrecarga equivalente do método DateTime.ToString, exceto pelo fato de que ele inclui um espaço seguido pelo deslocamento anexado no final da cadeia de caracteres.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. Em outras palavras, ele formata a saída usando o padrão de data abreviada, o padrão de hora longa e a zzz cadeia de caracteres de formato personalizado, com cada elemento separado do elemento anterior por um espaço.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.

O formato desses três elementos é definido pelo parâmetro formatProvider.The format of these three elements is defined by the formatProvider parameter. O parâmetro formatProvider pode ser qualquer um dos seguintes:The formatProvider parameter can be either of the following:

Se formatProvider for null, o objeto DateTimeFormatInfo associado à cultura atual será usado (consulte CurrentCulture).If formatProvider is null, the DateTimeFormatInfo object associated with the current culture is used (see CurrentCulture).

Notas aos Chamadores

O método ToString(IFormatProvider) retorna a representação de cadeia de caracteres da data e hora no calendário usado pela cultura representada pelo parâmetro formatProvider.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. O calendário é definido pela propriedade Calendar.Its calendar is defined by the Calendar property. Caso o valor da instância DateTimeOffset atual seja anterior a MinSupportedDateTime ou posterior a MaxSupportedDateTime, o método lança um ArgumentOutOfRangeException.If the value of the current DateTimeOffset instance is earlier than MinSupportedDateTime or later than MaxSupportedDateTime, the method throws an ArgumentOutOfRangeException. O exemplo a seguir ilustra esse cenário.The following example provides an illustration. Ele tenta formatar uma data que está fora do intervalo da classe JapaneseCalendar.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)

Converte o valor do objeto DateTimeOffset atual em sua representação de cadeia de caracteres equivalente usando o formato especificado.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

Parâmetros

format
String

Uma cadeia de caracteres de formato.A format string.

Retornos

Uma representação de cadeia de caracteres do valor do objeto DateTimeOffset atual, conforme especificado por format.A string representation of the value of the current DateTimeOffset object, as specified by format.

Exceções

O tamanho de format é um, e ele não é um dos caracteres especificadores de formato padrão definidos para DateTimeFormatInfo.The length of format is one, and it is not one of the standard format specifier characters defined for DateTimeFormatInfo.

-ou--or- format não contém um padrão de formato personalizado válido.format does not contain a valid custom format pattern.

A data e hora está fora do intervalo de datas suportadas pelo calendário usado pela cultura atual.The date and time is outside the range of dates supported by the calendar used by the current culture.

Exemplos

O exemplo a seguir exibe um objeto DateTimeOffset para o console usando cada um dos especificadores de formato de data e hora padrão.The following example displays a DateTimeOffset object to the console using each of the standard date and time format specifiers. A saída é formatada usando a 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)) 

Comentários

O parâmetro format deve conter um único caractere de especificador de formato (consulte cadeias de caracteres de formato de data e hora padrão) ou um padrão de formato personalizado (consulte cadeias de caracteres de formato de data e hora personalizadas) que define o formato da cadeia retornada.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 for uma cadeia de caracteres nula ou vazia (""), o valor de DateTimeOffset será a saída usando o formato padrão.If format is a null or empty string (""), the DateTimeOffset value is output using the default format.

A tabela a seguir mostra a operação exata de determinados especificadores de formato quando usada com DateTimeOffset, que difere do comportamento quando usado com 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.

Especificador de formato existenteExisting format specifier Novo comportamentoNew behavior
"K""K" Projetado para fazer ida e volta uma data e hora.Designed to round-trip a date and time. Com DateTimeOffset, é mapeado para "ZZZ" (o deslocamento é sempre exibido com horas e minutos).With DateTimeOffset, maps to "zzz" (the offset is always displayed with hours and minutes). Observe que "K" é um especificador de formato personalizado; Ele não pode aparecer como o único caractere em format.Note that "K" is a custom format specifier; it cannot appear as the single character in format.
"U""U" Sem suporte.Not supported.
d"r" Converte o objeto DateTimeOffset em UTC (tempo Universal Coordenado) e o gera usando a cadeia de caracteres de formato personalizado 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" Converte o objeto DateTimeOffset em UTC e o gera usando o formato yyyy-MM-dd HH:mm:ssZ.Converts the DateTimeOffset object to UTC and outputs it using the format yyyy-MM-dd HH:mm:ssZ.

Os especificadores de formato de data e hora padrão restantes se comportam da mesma forma com o método ToString(String) como fazem com o método ToString.The remaining standard date and time format specifiers behave the same with the ToString(String) method as they do with the ToString method.

Este método usa informações de formatação derivadas da cultura atual.This method uses formatting information derived from the current culture. Para obter mais informações, consulte CurrentCulture.For more information, see CurrentCulture.

Notas aos Chamadores

O método ToString(String) retorna a representação de cadeia de caracteres da data e hora no calendário usado pela cultura atual.The ToString(String) method returns the string representation of the date and time in the calendar used by the current culture. Caso o valor da instância DateTimeOffset atual seja anterior a MinSupportedDateTime ou posterior a MaxSupportedDateTime, o método lança um ArgumentOutOfRangeException.If the value of the current DateTimeOffset instance is earlier than MinSupportedDateTime or later than MaxSupportedDateTime, the method throws an ArgumentOutOfRangeException. O exemplo a seguir ilustra esse cenário.The following example provides an illustration. Ele tenta formatar uma data que está fora do intervalo da classe HebrewCalendar quando a cultura atual é Hebraico (Israel).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]

Veja também

ToString(String, IFormatProvider)

Converte o valor do atual objeto DateTimeOffset na representação de cadeia de caracteres equivalente usando o formato especificado e as informações de formato específicas da cultura.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

Parâmetros

format
String

Uma cadeia de caracteres de formato.A format string.

formatProvider
IFormatProvider

Um objeto que fornece informações de formatação específicas da cultura.An object that supplies culture-specific formatting information.

Retornos

Uma representação de cadeia de caracteres do valor do atual objeto DateTimeOffset, conforme especificado por format e provider.A string representation of the value of the current DateTimeOffset object, as specified by format and provider.

Implementações

Exceções

O tamanho de format é um, e ele não é um dos caracteres especificadores de formato padrão definidos para DateTimeFormatInfo.The length of format is one, and it is not one of the standard format specifier characters defined for DateTimeFormatInfo.

-ou--or- format não contém um padrão de formato personalizado válido.format does not contain a valid custom format pattern.

A data e hora estão fora do intervalo de datas com suporte no calendário usado por formatProvider.The date and time is outside the range of dates supported by the calendar used by formatProvider.

Exemplos

O exemplo a seguir usa o método ToString(String, IFormatProvider) para exibir um objeto DateTimeOffset usando uma cadeia de caracteres de formato personalizado para várias culturas diferentes.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

Comentários

O parâmetro format deve conter um único caractere especificador de formato (consulte cadeias de caracteres de formato de data e hora padrão) ou um padrão de formato personalizado (consulte cadeias de caracteres de formato de data e hora personalizadas).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 for uma cadeia de caracteres nula ou vazia (""), o objeto DateTimeOffset será apresentado usando o formato padrão.If format is a null or empty string (""), the DateTimeOffset object is output using the default format.

A tabela a seguir mostra a operação exata de determinados especificadores de formato quando usada com DateTimeOffset, que difere do comportamento quando usado com 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.

Especificador de formato existenteExisting format specifier Novo comportamentoNew behavior
"K""K" Projetado para fazer ida e volta uma data e hora.Designed to round-trip a date and time. Com DateTimeOffset, é mapeado para "ZZZ" (o deslocamento é sempre exibido com horas e minutos).With DateTimeOffset, maps to "zzz" (the offset is always displayed with hours and minutes). Observe que "K" é um especificador de formato personalizado; Ele não pode aparecer como o único caractere em format.Note that "K" is a custom format specifier; it cannot appear as the single character in format.
"U""U" Sem suporte.Not supported.
d"r" Converte o objeto DateTimeOffset em UTC (tempo Universal Coordenado) e o gera usando a cadeia de caracteres de formato personalizado 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" Converte o valor de DateTimeOffset em UTC e o gera usando o formato yyyy-MM-dd HH:mm:ssZ.Converts the DateTimeOffset value to UTC and outputs it using the format yyyy-MM-dd HH:mm:ssZ.

Os especificadores de formato de data e hora padrão restantes se comportam da mesma forma com o método ToString(String) como fazem com o método ToString.The remaining standard date and time format specifiers behave the same with the ToString(String) method as they do with the ToString method.

O padrão que corresponde aos especificadores de formato padrão, bem como os símbolos e nomes de componentes de data e hora, é definido pelo parâmetro formatProvider.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. O parâmetro formatProvider pode ser qualquer um dos seguintes:The formatProvider parameter can be either of the following:

Se formatProvider for null, o objeto DateTimeFormatInfo associado à cultura atual será usado (consulte CurrentCulture).If formatProvider is null, the DateTimeFormatInfo object associated with the current culture is used (see CurrentCulture).

Notas aos Chamadores

O método ToString(String, IFormatProvider) retorna a representação de cadeia de caracteres da data e hora no calendário usado pelo parâmetro formatProvider.The ToString(String, IFormatProvider) method returns the string representation of the date and time in the calendar used by the formatProvider parameter. O calendário é definido pela propriedade Calendar.Its calendar is defined by the Calendar property. Caso o valor da instância DateTimeOffset atual seja anterior a MinSupportedDateTime ou posterior a MaxSupportedDateTime, o método lança um ArgumentOutOfRangeException.If the value of the current DateTimeOffset instance is earlier than MinSupportedDateTime or later than MaxSupportedDateTime, the method throws an ArgumentOutOfRangeException. O exemplo a seguir ilustra esse cenário.The following example provides an illustration. Ele tenta formatar uma data que está fora do intervalo da classe UmAlQuraCalendar.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]

Veja também

Aplica-se a