Cadeias de caracteres de formato de data e hora padrãoStandard Date and Time Format Strings

Uma cadeia de caracteres de formato de data e hora padrão usa um especificador de formato único para definir a representação do texto de um valor de data e hora.A standard date and time format string uses a single format specifier to define the text representation of a date and time value. Qualquer cadeia de caracteres de formato de data e hora que contém mais de um caractere, incluindo espaço em branco, é interpretada como uma cadeia de caracteres de formato de data e hora personalizado. Para obter mais informações, consulte Cadeias de caracteres de formato de data e hora personalizado.Any date and time format string that contains more than one character, including white space, is interpreted as a custom date and time format string; for more information, see Custom Date and Time Format Strings. Uma cadeia de caracteres de formato padrão ou personalizado pode ser usada de duas maneiras:A standard or custom format string can be used in two ways:

  • Para definir a cadeia de caracteres que resulta de uma operação de formatação.To define the string that results from a formatting operation.

  • Para definir a representação de texto de um valor de data e hora que possa ser convertido em valor de DateTime ou DateTimeOffset por uma operação de análise.To define the text representation of a date and time value that can be converted to a DateTime or DateTimeOffset value by a parsing operation.

Dica

Baixe o Utilitário de Formatação, um aplicativo do Windows Forms do .NET Core que permite aplicar cadeias de caracteres de formato a valores numéricos ou de data e hora e exibir a cadeia de caracteres de resultado.You can download the Formatting Utility, a .NET Core Windows Forms application that lets you apply format strings to either numeric or date and time values and displays the result string. O código-fonte está disponível para o C# e o Visual Basic.Source code is available for C# and Visual Basic.

Cadeias de caracteres de formato de data e hora padrão podem ser usadas tanto com valores DateTime quanto DateTimeOffset.Standard date and time format strings can be used with both DateTime and DateTimeOffset values.

Observação

Alguns dos exemplos de C# neste artigo são executados no executador de código embutido Try.NET e no playground.Some of the C# examples in this article run in the Try.NET inline code runner and playground. Clique no botão Executar para executar um exemplo em uma janela interativa.Select the Run button to run an example in an interactive window. Ao executar o código, é possível modificá-lo e executar o código modificado clicando em Executar novamente.Once you execute the code, you can modify it and run the modified code by selecting Run again. O código modificado será executado na janela interativa ou, se a compilação falhar, a janela interativa exibirá todos as mensagens de erro do compilador C#.The modified code either runs in the interactive window or, if compilation fails, the interactive window displays all C# compiler error messages.

O fuso horário local do executador de código embutido Try.NET e do playground é o Tempo Universal Coordenado ou UTC.The local time zone of the Try.NET inline code runner and playground is Coordinated Universal Time, or UTC. Isso pode afetar o comportamento e a saída dos exemplos que ilustram os tipos DateTime, DateTimeOffset e TimeZoneInfo e seus membros.This may affect the behavior and the output of examples that illustrate the DateTime, DateTimeOffset, and TimeZoneInfo types and their members.

A tabela a seguir descreve os especificadores de formato de data e hora padrão.The following table describes the standard date and time format specifiers. Salvo indicação em contrário, um determinado especificador de formato de data e hora padrão produz uma representação de cadeia de caracteres idêntica independente de ela ser usada com um valor DateTime ou DateTimeOffset.Unless otherwise noted, a particular standard date and time format specifier produces an identical string representation regardless of whether it is used with a DateTime or a DateTimeOffset value. Consulte a seção Observações para obter informações adicionais sobre como usar as cadeias de caracteres de formato de data e hora padrão.See the Notes section for additional information about using standard date and time format strings.

Especificador de formatoFormat specifier DescriçãoDescription ExemplosExamples
"d""d" Padrão de data abreviada.Short date pattern.

Para saber mais: especificador de formato abreviado de data ("d").More information:The Short Date ("d") Format Specifier.
2009-06-15T13:45:30 -> 6/15/2009 (en-US)2009-06-15T13:45:30 -> 6/15/2009 (en-US)

2009-06-15T13:45:30 -> 15/06/2009 (fr-FR)2009-06-15T13:45:30 -> 15/06/2009 (fr-FR)

2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D""D" Padrão de data completa.Long date pattern.

Para saber mais: especificador de formato de data completa ("D").More information:The Long Date ("D") Format Specifier.
2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US)2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US)

2009-06-15T13:45:30 -> 15 июня 2009 г.2009-06-15T13:45:30 -> 15 июня 2009 г. (ru-RU)(ru-RU)

2009-06-15T13:45:30 -> Montag, 15.2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)Juni 2009 (de-DE)
"f""f" Padrão de data/hora completa (hora abreviada).Full date/time pattern (short time).

Para saber mais: O especificador de formato de data completa e hora abreviada ("f").More information: The Full Date Short Time ("f") Format Specifier.
2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45 PM (en-US)2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45 PM (en-US)

2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE)2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE)

2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)
"F""F" Padrão de data/hora completa (hora completa).Full date/time pattern (long time).

Para saber mais: O especificador de formato de data completa e hora completa ("F").More information: The Full Date Long Time ("F") Format Specifier.
2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45:30 PM (en-US)2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45:30 PM (en-US)

2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE)2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE)

2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)
"g""g" Padrão geral de data/hora (hora abreviada).General date/time pattern (short time).

Para saber mais: O especificador de formato de data geral e hora abreviada ("g").More information: The General Date Short Time ("g") Format Specifier.
2009-06-15T13:45:30 -> 6/15/2009 1:45 PM (en-US)2009-06-15T13:45:30 -> 6/15/2009 1:45 PM (en-US)

2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES)2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES)

2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G""G" Padrão geral de data/hora (hora completa).General date/time pattern (long time).

Para saber mais: O especificador de formato de data geral e hora completa ("G").More information: The General Date Long Time ("G") Format Specifier.
2009-06-15T13:45:30 -> 6/15/2009 1:45:30 PM (en-US)2009-06-15T13:45:30 -> 6/15/2009 1:45:30 PM (en-US)

2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES)2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES)

2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)
"M", "m""M", "m" Padrão de mês/dia.Month/day pattern.

Para saber mais: O especificador de formato de mês ("M", "m").More information: The Month ("M", "m") Format Specifier.
2009-06-15T13:45:30 -> June 15 (en-US)2009-06-15T13:45:30 -> June 15 (en-US)

2009-06-15T13:45:30 -> 15.2009-06-15T13:45:30 -> 15. juni (da-DK)juni (da-DK)

2009-06-15T13:45:30 -> 15 Juni (id-ID)2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o""O", "o" Padrão de data/hora de ida e volta.Round-trip date/time pattern.

Para saber mais: O especificador de formato de viagem de ida e volta ("O", "o").More information: The Round-trip ("O", "o") Format Specifier.
Valores DateTime:DateTime values:

2009-06-15T13:45:30 (DateTimeKind.Local) --> 2009-06-15T13:45:30.0000000-07:002009-06-15T13:45:30 (DateTimeKind.Local) --> 2009-06-15T13:45:30.0000000-07:00

2009-06-15T13:45:30 (DateTimeKind.Utc) --> 2009-06-15T13:45:30.0000000Z2009-06-15T13:45:30 (DateTimeKind.Utc) --> 2009-06-15T13:45:30.0000000Z

2009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.00000002009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.0000000

Valores DateTimeOffset:DateTimeOffset values:

2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:002009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:00
"R", "r""R", "r" Padrão RFC1123.RFC1123 pattern.

Para saber mais: O especificador de formato RFC1123 ("R", "r").More information: The RFC1123 ("R", "r") Format Specifier.
2009-06-15T13:45:30 -> Mon, 15 Jun 2009 20:45:30 GMT2009-06-15T13:45:30 -> Mon, 15 Jun 2009 20:45:30 GMT
"s""s" Padrão de data/hora classificável.Sortable date/time pattern.

Para saber mais: O especificador de formato classificável ("s").More information: The Sortable ("s") Format Specifier.
2009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:302009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:30

2009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:302009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:30
"t""t" Padrão de hora abreviada.Short time pattern.

Para saber mais: O especificador de formato de hora abreviada ("t").More information: The Short Time ("t") Format Specifier.
2009-06-15T13:45:30 -> 1:45 PM (en-US)2009-06-15T13:45:30 -> 1:45 PM (en-US)

2009-06-15T13:45:30 -> 13:45 (hr-HR)2009-06-15T13:45:30 -> 13:45 (hr-HR)

2009-06-15T13:45:30 -> 01:45 م (ar-EG)2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T""T" Padrão de hora completa.Long time pattern.

Para saber mais: O especificador de formato de hora completa ("T").More information: The Long Time ("T") Format Specifier.
2009-06-15T13:45:30 -> 1:45:30 PM (en-US)2009-06-15T13:45:30 -> 1:45:30 PM (en-US)

2009-06-15T13:45:30 -> 13:45:30 (hr-HR)2009-06-15T13:45:30 -> 13:45:30 (hr-HR)

2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"u""u" Padrão classificável universal de data/hora.Universal sortable date/time pattern.

Para saber mais: O especificador de formato classificável universal ("u").More information: The Universal Sortable ("u") Format Specifier.
Com um valor DateTime: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30ZWith a DateTime value: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z

Com um valor DateTimeOffset: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30ZWith a DateTimeOffset value: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U""U" Padrão universal de data/hora completa.Universal full date/time pattern.

Para saber mais: O especificador de formato completo universal ("U").More information: The Universal Full ("U") Format Specifier.
2009-06-15T13:45:30 -> Monday, June 15, 2009 8:45:30 PM (en-US)2009-06-15T13:45:30 -> Monday, June 15, 2009 8:45:30 PM (en-US)

2009-06-15T13:45:30 -> den 15 juni 2009 20:45:30 (sv-SE)2009-06-15T13:45:30 -> den 15 juni 2009 20:45:30 (sv-SE)

2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 8:45:30 μμ (el-GR)2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 8:45:30 μμ (el-GR)
"Y", "y""Y", "y" Padrão ano mês.Year month pattern.

Para saber mais: O especificador de formato de ano mês ("Y").More information: The Year Month ("Y") Format Specifier.
2009-06-15T13:45:30 -> June, 2009 (en-US)2009-06-15T13:45:30 -> June, 2009 (en-US)

2009-06-15T13:45:30 -> juni 2009 (da-DK)2009-06-15T13:45:30 -> juni 2009 (da-DK)

2009-06-15T13:45:30 -> Juni 2009 (id-ID)2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Qualquer outro caractere únicoAny other single character Especificador desconhecido.Unknown specifier. Gera uma FormatException de tempo de execução.Throws a run-time FormatException.

Como funcionam as cadeias de caracteres de formato padrãoHow Standard Format Strings Work

Em uma operação de formatação, uma cadeia de formato padrão é simplesmente um alias para uma cadeia de caracteres de formato personalizado.In a formatting operation, a standard format string is simply an alias for a custom format string. A vantagem de usar um alias para se referir a uma cadeia de caracteres de formato personalizado é que, embora o alias permaneça invariável, a cadeia de caracteres de formato personalizado em si pode variar.The advantage of using an alias to refer to a custom format string is that, although the alias remains invariant, the custom format string itself can vary. Isso é importante porque as representações de cadeia de caracteres de valores de data e hora normalmente variam de acordo com a cultura.This is important because the string representations of date and time values typically vary by culture. Por exemplo, a cadeia de caracteres de formato padrão "d" indica que um valor de data e hora deve ser exibido usando um formato de data abreviada.For example, the "d" standard format string indicates that a date and time value is to be displayed using a short date pattern. Para a cultura invariável, esse padrão é "MM/dd/aaaa".For the invariant culture, this pattern is "MM/dd/yyyy". Para a cultura fr-FR, ele é " dd/MM/aaaa ".For the fr-FR culture, it is "dd/MM/yyyy". Para a cultura ja-JP, ele é " aaaa/MM/dd ".For the ja-JP culture, it is "yyyy/MM/dd".

Se uma cadeia de caracteres de formato padrão em uma operação de formatação aponta para uma cadeia de caracteres de formato personalizado de uma cultura, seu aplicativo pode definir a cultura específica cujas cadeias de caracteres de formato personalizado são usadas de uma dessas maneiras:If a standard format string in a formatting operation maps to a particular culture's custom format string, your application can define the specific culture whose custom format strings are used in one of these ways:

  • Você pode usar a cultura padrão (ou atual).You can use the default (or current) culture. O exemplo a seguir exibe uma data usando o formato de data abreviada da cultura atual.The following example displays a date using the current culture's short date format. Nesse caso, a cultura atual é en-US.In this case, the current culture is en-US.

    // Display using current (en-us) culture's short date format
    DateTime thisDate = new DateTime(2008, 3, 15);
    Console.WriteLine(thisDate.ToString("d"));           // Displays 3/15/2008
    
    ' Display using current (en-us) culture's short date format
    Dim thisDate As Date = #03/15/2008#
    Console.WriteLine(thisDate.ToString("d"))     ' Displays 3/15/2008
    
  • Você pode passar um objeto CultureInfo que representa a cultura cuja formatação deve ser usada para um método que possua um parâmetro IFormatProvider.You can pass a CultureInfo object representing the culture whose formatting is to be used to a method that has an IFormatProvider parameter. O exemplo a seguir exibe uma data usando o formato de data abreviada da cultura pt-BR.The following example displays a date using the short date format of the pt-BR culture.

    // Display using pt-BR culture's short date format
    DateTime thisDate = new DateTime(2008, 3, 15);
    CultureInfo culture = new CultureInfo("pt-BR");      
    Console.WriteLine(thisDate.ToString("d", culture));  // Displays 15/3/2008
    
    ' Display using pt-BR culture's short date format
    Dim thisDate As Date = #03/15/2008#
    Dim culture As New CultureInfo("pt-BR")      
    Console.WriteLine(thisDate.ToString("d", culture))   ' Displays 15/3/2008
    
  • Você pode passar um objeto DateTimeFormatInfo que fornece informações de formatação para um método que possua um parâmetro IFormatProvider.You can pass a DateTimeFormatInfo object that provides formatting information to a method that has an IFormatProvider parameter. O exemplo a seguir exibe uma data usando o formato de data abreviada de um objeto DateTimeFormatInfo para a cultura hr-HR.The following example displays a date using the short date format from a DateTimeFormatInfo object for the hr-HR culture.

    // Display using date format information from hr-HR culture
    DateTime thisDate = new DateTime(2008, 3, 15);
    DateTimeFormatInfo fmt = (new CultureInfo("hr-HR")).DateTimeFormat;
    Console.WriteLine(thisDate.ToString("d", fmt));      // Displays 15.3.2008
    
    ' Display using date format information from hr-HR culture
    Dim thisDate As Date = #03/15/2008#
    Dim fmt As DateTimeFormatInfo = (New CultureInfo("hr-HR")).DateTimeFormat
    Console.WriteLine(thisDate.ToString("d", fmt))   ' Displays 15.3.2008
    

Observação

Para obter informações sobre como personalizar os padrões ou as cadeias de caracteres usados na formatação de valores de data e hora, consulte o tópico da classe NumberFormatInfo.For information about customizing the patterns or strings used in formatting date and time values, see the NumberFormatInfo class topic.

Em alguns casos, a cadeia de caracteres de formato padrão funciona como uma abreviação conveniente de uma cadeia de caracteres de formato personalizado maior que é invariável.In some cases, the standard format string serves as a convenient abbreviation for a longer custom format string that is invariant. Quatro cadeias de caracteres de formato padrão se enquadram nesta categoria: "O" (ou "o"), "R" (ou "r"), "s" e "u".Four standard format strings fall into this category: "O" (or "o"), "R" (or "r"), "s", and "u". Estas cadeias de caracteres correspondem às cadeias de caracteres de formato personalizado definidas pela cultura invariável.These strings correspond to custom format strings defined by the invariant culture. Elas produzem representações de cadeias de caracteres de valores de data e hora que são feitos para ser idênticos entre culturas.They produce string representations of date and time values that are intended to be identical across cultures. A tabela a seguir fornece informações sobre essas quatro cadeias de caracteres de formato de data e hora padrão.The following table provides information on these four standard date and time format strings.

Cadeias de caracteres de formato padrãoStandard format string Definidas pela propriedade DateTimeFormatInfo.InvariantInfoDefined by DateTimeFormatInfo.InvariantInfo property Cadeia de caracteres de formato personalizadoCustom format string
"O" ou "o""O" or "o" NenhumNone yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzzyyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzz
"R" ou "r""R" or "r" RFC1123Pattern ddd, dd MMM yyyy HH':'mm':'ss 'GMT'ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
"s""s" SortableDateTimePattern yyyy'-'MM'-'dd'T'HH':'mm':'ssyyyy'-'MM'-'dd'T'HH':'mm':'ss
"u""u" UniversalSortableDateTimePattern yyyy'-'MM'-'dd HH':'mm':'ss'Z'yyyy'-'MM'-'dd HH':'mm':'ss'Z'

As cadeias de caracteres de formato padrão também podem ser usadas em operações de análise com os métodos DateTime.ParseExact ou DateTimeOffset.ParseExact, o que exige que uma cadeia de caracteres de entrada atenda com exatidão a um padrão específico para que a operação de análise seja bem-sucedida.Standard format strings can also be used in parsing operations with the DateTime.ParseExact or DateTimeOffset.ParseExact methods, which require an input string to exactly conform to a particular pattern for the parse operation to succeed. Muitas cadeias de caracteres de formato padrão são mapeadas em muitas cadeias de caracteres de formato personalizado. Assim, um valor de data e hora poderá ser representado em vários formatos e a operação de análise ainda terá êxito.Many standard format strings map to multiple custom format strings, so a date and time value can be represented in a variety of formats and the parse operation will still succeed. Você pode determinar a cadeia ou as cadeias de caracteres de formato que correspondem a uma cadeia de formato padrão ao chamar o método DateTimeFormatInfo.GetAllDateTimePatterns(Char).You can determine the custom format string or strings that correspond to a standard format string by calling the DateTimeFormatInfo.GetAllDateTimePatterns(Char) method. O exemplo a seguir exibe as cadeias de caracteres de formato personalizado que são mapeados para a cadeia de caracteres de formato padrão “d” (padrão de data abreviada).The following example displays the custom format strings that map to the "d" (short date pattern) standard format string.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      Console.WriteLine("'d' standard format string:");
      foreach (var customString in DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns('d'))
          Console.WriteLine("   {0}", customString);
   }
}
// The example displays the following output:
//       'd' standard format string:
//          M/d/yyyy
//          M/d/yy
//          MM/dd/yy
//          MM/dd/yyyy
//          yy/MM/dd
//          yyyy-MM-dd
//          dd-MMM-yy
Imports System.Globalization

Module Example
   Public Sub Main()
      Console.WriteLine("'d' standard format string:")
      For Each customString In DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns("d"c)
          Console.WriteLine("   {0}", customString)
      Next                                  
   End Sub
End Module
' The example displays the following output:
'    'd' standard format string:
'       M/d/yyyy
'       M/d/yy
'       MM/dd/yy
'       MM/dd/yyyy
'       yy/MM/dd
'       yyyy-MM-dd
'       dd-MMM-yy

As seções a seguir descrevem os especificadores de formato padrão para valores DateTime e DateTimeOffset.The following sections describe the standard format specifiers for DateTime and DateTimeOffset values.

Especificador de formato de data abreviada ("d")The Short Date ("d") Format Specifier

O especificador de formato padrão “d” representa uma cadeia de caracteres de formato de data e hora personalizado que é definida pela propriedade DateTimeFormatInfo.ShortDatePattern de uma cultura específica.The "d" standard format specifier represents a custom date and time format string that is defined by a specific culture's DateTimeFormatInfo.ShortDatePattern property. Por exemplo, a cadeia de caracteres de formato personalizado retornada pela propriedade ShortDatePattern da cultura invariável é " MM/dd/aaaa ".For example, the custom format string that is returned by the ShortDatePattern property of the invariant culture is "MM/dd/yyyy".

A tabela a seguir lista as propriedades do objeto DateTimeFormatInfo que controlam a formatação da cadeia de caracteres retornada.The following table lists the DateTimeFormatInfo object properties that control the formatting of the returned string.

PropriedadeProperty DESCRIÇÃODescription
ShortDatePattern Define o formato geral da cadeia de caracteres de resultado.Defines the overall format of the result string.
DateSeparator Define a cadeia de caracteres que separa o ano, o mês e os componentes de dia de uma data.Defines the string that separates the year, month, and day components of a date.

O exemplo a seguir utiliza o especificador de formato "d" para exibir um valor de data e hora.The following example uses the "d" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008,4, 10);
Console.WriteLine(date1.ToString("d", DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008
Console.WriteLine(date1.ToString("d", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays 4/10/2008                       
Console.WriteLine(date1.ToString("d", 
                  CultureInfo.CreateSpecificCulture("en-NZ")));
// Displays 10/04/2008                       
Console.WriteLine(date1.ToString("d", 
                  CultureInfo.CreateSpecificCulture("de-DE")));
// Displays 10.04.2008                       
Dim date1 As Date = #4/10/2008#
Console.WriteLine(date1.ToString("d", DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays 4/10/2008                       
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("en-NZ")))
' Displays 10/04/2008                       
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("de-DE")))
' Displays 10.04.2008                       

Voltar à tabelaBack to table

Especificador de formato de data completa ("D")The Long Date ("D") Format Specifier

O especificador de formato padrão “D” representa uma cadeia de caracteres de formato de data e hora personalizado que é definida pela propriedade DateTimeFormatInfo.LongDatePattern atual.The "D" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.LongDatePattern property. Por exemplo, a cadeia de caracteres de formato personalizado para a cultura invariável é "dddd, dd MMMM aaaa".For example, the custom format string for the invariant culture is "dddd, dd MMMM yyyy".

A tabela a seguir lista as propriedades do objeto DateTimeFormatInfo que controlam a formatação da cadeia de caracteres retornada.The following table lists the properties of the DateTimeFormatInfo object that control the formatting of the returned string.

PropriedadeProperty DESCRIÇÃODescription
LongDatePattern Define o formato geral da cadeia de caracteres de resultado.Defines the overall format of the result string.
DayNames Define os nomes de dias localizados que podem aparecer na cadeia de caracteres de resultado.Defines the localized day names that can appear in the result string.
MonthNames Define os nomes dos meses localizados que podem aparecer na cadeia de caracteres de resultado.Defines the localized month names that can appear in the result string.

O exemplo a seguir utiliza o especificador de formato "D" para exibir um valor de data e hora.The following example uses the "D" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10);
Console.WriteLine(date1.ToString("D", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008                        
Console.WriteLine(date1.ToString("D", 
                  CultureInfo.CreateSpecificCulture("pt-BR")));
// Displays quinta-feira, 10 de abril de 2008                        
Console.WriteLine(date1.ToString("D", 
                  CultureInfo.CreateSpecificCulture("es-MX")));
// Displays jueves, 10 de abril de 2008                        
Dim date1 As Date = #4/10/2008#
Console.WriteLine(date1.ToString("D", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008                        
Console.WriteLine(date1.ToString("D", _
                  CultureInfo.CreateSpecificCulture("pt-BR")))
' Displays quinta-feira, 10 de abril de 2008                        
Console.WriteLine(date1.ToString("D", _
                  CultureInfo.CreateSpecificCulture("es-MX")))
' Displays jueves, 10 de abril de 2008                        

Voltar à tabelaBack to table

Especificador de formato de data completa e hora abreviada (“f”)The Full Date Short Time ("f") Format Specifier

O especificador de formato padrão "f" representa uma combinação dos padrões de data completa ("D") e hora abreviada ("t"), separados por um espaço.The "f" standard format specifier represents a combination of the long date ("D") and short time ("t") patterns, separated by a space.

A cadeia de caracteres do resultado é afetada pelas informações de formatação de um objeto DateTimeFormatInfo específico.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. A tabela a seguir lista as propriedades do objeto DateTimeFormatInfo que podem controlar a formatação da cadeia de caracteres retornada.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. O especificador personalizado de formato retornado pelas propriedades DateTimeFormatInfo.LongDatePattern e DateTimeFormatInfo.ShortTimePattern de algumas culturas não pode usar todas as propriedades.The custom format specifier returned by the DateTimeFormatInfo.LongDatePattern and DateTimeFormatInfo.ShortTimePattern properties of some cultures may not make use of all properties.

PropriedadeProperty DESCRIÇÃODescription
LongDatePattern Define o formato do componente de data da cadeia de caracteres de resultado.Defines the format of the date component of the result string.
ShortTimePattern Define o formato do componente de hora da cadeia de caracteres de resultado.Defines the format of the time component of the result string.
DayNames Define os nomes de dias localizados que podem aparecer na cadeia de caracteres de resultado.Defines the localized day names that can appear in the result string.
MonthNames Define os nomes dos meses localizados que podem aparecer na cadeia de caracteres de resultado.Defines the localized month names that can appear in the result string.
TimeSeparator Define a cadeia de caracteres que separa os componentes de hora, minuto e segundo de uma hora.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Define a cadeia de caracteres que indica as horas da meia-noite até antes do meio-dia em um relógio de 12 horas.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Define a cadeia de caracteres que indica as horas do meio-dia até antes da meia-noite em um relógio de 12 horas.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

O exemplo a seguir utiliza o especificador de formato "f" para exibir um valor de data e hora.The following example uses the "f" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("f", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008 6:30 AM                        
Console.WriteLine(date1.ToString("f", 
                  CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays jeudi 10 avril 2008 06:30                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("f", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008 6:30 AM                        
Console.WriteLine(date1.ToString("f", _
                  CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays jeudi 10 avril 2008 06:30                       

Voltar à tabelaBack to table

Especificador de formato de data completa e hora completa (“F”)The Full Date Long Time ("F") Format Specifier

O especificador de formato padrão “F” representa uma cadeia de caracteres de formato de data e hora personalizado que é definida pela propriedade DateTimeFormatInfo.FullDateTimePattern atual.The "F" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.FullDateTimePattern property. Por exemplo, a cadeia de caracteres de formato personalizado para a cultura invariável é "dddd, dd MMMM aaaa HH:mm:ss".For example, the custom format string for the invariant culture is "dddd, dd MMMM yyyy HH:mm:ss".

A tabela a seguir lista as propriedades do objeto DateTimeFormatInfo que podem controlar a formatação da cadeia de caracteres retornada.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. O especificador de formato personalizado que é retornado pela propriedade FullDateTimePattern de algumas culturas não pode usar todas as propriedades.The custom format specifier that is returned by the FullDateTimePattern property of some cultures may not make use of all properties.

PropriedadeProperty DESCRIÇÃODescription
FullDateTimePattern Define o formato geral da cadeia de caracteres de resultado.Defines the overall format of the result string.
DayNames Define os nomes de dias localizados que podem aparecer na cadeia de caracteres de resultado.Defines the localized day names that can appear in the result string.
MonthNames Define os nomes dos meses localizados que podem aparecer na cadeia de caracteres de resultado.Defines the localized month names that can appear in the result string.
TimeSeparator Define a cadeia de caracteres que separa os componentes de hora, minuto e segundo de uma hora.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Define a cadeia de caracteres que indica as horas da meia-noite até antes do meio-dia em um relógio de 12 horas.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Define a cadeia de caracteres que indica as horas do meio-dia até antes da meia-noite em um relógio de 12 horas.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

O exemplo a seguir utiliza o especificador de formato "F" para exibir um valor de data e hora.The following example uses the "F" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("F", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008 6:30:00 AM                        
Console.WriteLine(date1.ToString("F", 
                  CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays jeudi 10 avril 2008 06:30:00                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("F", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008 6:30:00 AM                        
Console.WriteLine(date1.ToString("F", _
                  CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays jeudi 10 avril 2008 06:30:00                       

Voltar à tabelaBack to table

Especificador de formato de data geral e hora abreviada (“g”)The General Date Short Time ("g") Format Specifier

O especificador de formato padrão "g" representa uma combinação dos padrões de data abreviada ("d") e hora abreviada ("t"), separados por um espaço.The "g" standard format specifier represents a combination of the short date ("d") and short time ("t") patterns, separated by a space.

A cadeia de caracteres do resultado é afetada pelas informações de formatação de um objeto DateTimeFormatInfo específico.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. A tabela a seguir lista as propriedades do objeto DateTimeFormatInfo que podem controlar a formatação da cadeia de caracteres retornada.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. O especificador personalizado de formato que é retornado pelas propriedades DateTimeFormatInfo.ShortDatePattern e DateTimeFormatInfo.ShortTimePattern de algumas culturas não pode usar todas as propriedades.The custom format specifier that is returned by the DateTimeFormatInfo.ShortDatePattern and DateTimeFormatInfo.ShortTimePattern properties of some cultures may not make use of all properties.

PropriedadeProperty DESCRIÇÃODescription
ShortDatePattern Define o formato do componente de data da cadeia de caracteres de resultado.Defines the format of the date component of the result string.
ShortTimePattern Define o formato do componente de hora da cadeia de caracteres de resultado.Defines the format of the time component of the result string.
DateSeparator Define a cadeia de caracteres que separa o ano, o mês e os componentes de dia de uma data.Defines the string that separates the year, month, and day components of a date.
TimeSeparator Define a cadeia de caracteres que separa os componentes de hora, minuto e segundo de uma hora.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Define a cadeia de caracteres que indica as horas da meia-noite até antes do meio-dia em um relógio de 12 horas.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Define a cadeia de caracteres que indica as horas do meio-dia até antes da meia-noite em um relógio de 12 horas.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

O exemplo a seguir utiliza o especificador de formato "g" para exibir um valor de data e hora.The following example uses the "g" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("g", 
                  DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008 06:30                      
Console.WriteLine(date1.ToString("g", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays 4/10/2008 6:30 AM                       
Console.WriteLine(date1.ToString("g", 
                  CultureInfo.CreateSpecificCulture("fr-BE")));
// Displays 10/04/2008 6:30                        
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("g", _
                  DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008 06:30                      
Console.WriteLine(date1.ToString("g", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays 4/10/2008 6:30 AM                       
Console.WriteLine(date1.ToString("g", _
                  CultureInfo.CreateSpecificCulture("fr-BE")))
' Displays 10/04/2008 6:30                        

Voltar à tabelaBack to table

Especificador de formato de data geral e hora completa (“G”)The General Date Long Time ("G") Format Specifier

O especificador de formato padrão "G" representa uma combinação dos padrões de data abreviada ("d") e hora completa ("T"), separados por um espaço.The "G" standard format specifier represents a combination of the short date ("d") and long time ("T") patterns, separated by a space.

A cadeia de caracteres do resultado é afetada pelas informações de formatação de um objeto DateTimeFormatInfo específico.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. A tabela a seguir lista as propriedades do objeto DateTimeFormatInfo que podem controlar a formatação da cadeia de caracteres retornada.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. O especificador personalizado de formato que é retornado pelas propriedades DateTimeFormatInfo.ShortDatePattern e DateTimeFormatInfo.LongTimePattern de algumas culturas não pode usar todas as propriedades.The custom format specifier that is returned by the DateTimeFormatInfo.ShortDatePattern and DateTimeFormatInfo.LongTimePattern properties of some cultures may not make use of all properties.

PropriedadeProperty DESCRIÇÃODescription
ShortDatePattern Define o formato do componente de data da cadeia de caracteres de resultado.Defines the format of the date component of the result string.
LongTimePattern Define o formato do componente de hora da cadeia de caracteres de resultado.Defines the format of the time component of the result string.
DateSeparator Define a cadeia de caracteres que separa o ano, o mês e os componentes de dia de uma data.Defines the string that separates the year, month, and day components of a date.
TimeSeparator Define a cadeia de caracteres que separa os componentes de hora, minuto e segundo de uma hora.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Define a cadeia de caracteres que indica as horas da meia-noite até antes do meio-dia em um relógio de 12 horas.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Define a cadeia de caracteres que indica as horas do meio-dia até antes da meia-noite em um relógio de 12 horas.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

O exemplo a seguir utiliza o especificador de formato "G" para exibir um valor de data e hora.The following example uses the "G" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("G", 
                  DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008 06:30:00
Console.WriteLine(date1.ToString("G", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays 4/10/2008 6:30:00 AM                        
Console.WriteLine(date1.ToString("G", 
                  CultureInfo.CreateSpecificCulture("nl-BE")));
// Displays 10/04/2008 6:30:00                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("G", _
                  DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008 06:30:00
Console.WriteLine(date1.ToString("G", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays 4/10/2008 6:30:00 AM                        
Console.WriteLine(date1.ToString("G", _
                  CultureInfo.CreateSpecificCulture("nl-BE")))
' Displays 10/04/2008 6:30:00                       

Voltar à tabelaBack to table

Especificador de formato de mês ("M", "m")The Month ("M", "m") Format Specifier

O especificador de formato padrão “M” ou "m" representa uma cadeia de caracteres de formato de data e hora personalizado que é definida pela propriedade DateTimeFormatInfo.MonthDayPattern atual.The "M" or "m" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.MonthDayPattern property. Por exemplo, a cadeia de caracteres de formato personalizado para o cultura invariável é "MMMM dd".For example, the custom format string for the invariant culture is "MMMM dd".

A tabela a seguir lista as propriedades do objeto DateTimeFormatInfo que controlam a formatação da cadeia de caracteres retornada.The following table lists the DateTimeFormatInfo object properties that control the formatting of the returned string.

PropriedadeProperty DESCRIÇÃODescription
MonthDayPattern Define o formato geral da cadeia de caracteres de resultado.Defines the overall format of the result string.
MonthNames Define os nomes dos meses localizados que podem aparecer na cadeia de caracteres de resultado.Defines the localized month names that can appear in the result string.

O exemplo a seguir utiliza o especificador de formato "m" para exibir um valor de data e hora.The following example uses the "m" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("m", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays April 10                        
Console.WriteLine(date1.ToString("m", 
                  CultureInfo.CreateSpecificCulture("ms-MY")));
// Displays 10 April                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("m", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays April 10                        
Console.WriteLine(date1.ToString("m", _
                  CultureInfo.CreateSpecificCulture("ms-MY")))
' Displays 10 April                       

Voltar à tabelaBack to table

Especificador de formato da viagem de ida e volta ("O", "o")The Round-trip ("O", "o") Format Specifier

O especificador de formato padrão "O" ou "o" representa uma cadeia de caracteres de data e hora personalizada usando um padrão que preserva as informações de fuso horário e emite uma cadeia de caracteres de resultado compilada com ISO 8601.The "O" or "o" standard format specifier represents a custom date and time format string using a pattern that preserves time zone information and emits a result string that complies with ISO 8601. Para valores DateTime, este especificador de formato foi projetado para manter valores de data e hora junto à propriedade DateTime.Kind no texto.For DateTime values, this format specifier is designed to preserve date and time values along with the DateTime.Kind property in text. A cadeia de caracteres formatada pode ser analisada de volta usando o método DateTime.Parse(String, IFormatProvider, DateTimeStyles) ou DateTime.ParseExact quando o parâmetro styles está definido como DateTimeStyles.RoundtripKind.The formatted string can be parsed back by using the DateTime.Parse(String, IFormatProvider, DateTimeStyles) or DateTime.ParseExact method if the styles parameter is set to DateTimeStyles.RoundtripKind.

O especificador de formato padrão “O” ou “o” corresponde à cadeia de caracteres de formato personalizado "aaaa'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK" para valores DateTime e à cadeia de caracteres de formato personalizado "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzzz" para valores DateTimeOffset.The "O" or "o" standard format specifier corresponds to the "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK" custom format string for DateTime values and to the "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzzz" custom format string for DateTimeOffset values. Nesta cadeia de caracteres, os pares de aspas simples que delimitam caracteres individuais, como hifens, dois-pontos e a letra "T", indicam que o caractere individual é literal e não pode ser alterado.In this string, the pairs of single quotation marks that delimit individual characters, such as the hyphens, the colons, and the letter "T", indicate that the individual character is a literal that cannot be changed. As aspas simples em si não aparecem na cadeia de caracteres de saída.The apostrophes do not appear in the output string.

O especificador de formato "O" ou "o" padrão (e a cadeia de caracteres de formato personalizado "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK") aproveita as três maneiras do ISO 8601 representar as informações de fuso horário para preservar a propriedade Kind dos valores DateTime:The "O" or "o" standard format specifier (and the "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK" custom format string) takes advantage of the three ways that ISO 8601 represents time zone information to preserve the Kind property of DateTime values:

  • O componente de fuso horário dos valores de data e hora DateTimeKind.Local é um deslocamento em relação ao UTC (por exemplo, +01:00, -07:00).The time zone component of DateTimeKind.Local date and time values is an offset from UTC (for example, +01:00, -07:00). Todos os valores DateTimeOffset também estão representados nesse formato.All DateTimeOffset values are also represented in this format.

  • O componente de fuso horário dos valores de data e hora DateTimeKind.Utc usa "Z" (que significa deslocamento zero) para representar o UTC.The time zone component of DateTimeKind.Utc date and time values uses "Z" (which stands for zero offset) to represent UTC.

  • Os valores de data e hora DateTimeKind.Unspecified não têm informações de fuso horário.DateTimeKind.Unspecified date and time values have no time zone information.

Como o especificador de formato padrão "O" ou "o" está de acordo com um padrão internacional, a operação de formatação ou análise que usa o especificador sempre usa a cultura invariável e o calendário gregoriano.Because the "O" or "o" standard format specifier conforms to an international standard, the formatting or parsing operation that uses the specifier always uses the invariant culture and the Gregorian calendar.

As cadeias de caracteres passadas para os métodos Parse, TryParse, ParseExact e TryParseExact de DateTime e DateTimeOffset podem ser analisadas usando o especificador de formato "O" ou "o", caso estejam em um desses formatos.Strings that are passed to the Parse, TryParse, ParseExact, and TryParseExact methods of DateTime and DateTimeOffset can be parsed by using the "O" or "o" format specifier if they are in one of these formats. No caso de objetos DateTime, a sobrecarga de análise chamada também inclui um parâmetro styles com um valor de DateTimeStyles.RoundtripKind.In the case of DateTime objects, the parsing overload that you call should also include a styles parameter with a value of DateTimeStyles.RoundtripKind. Se chamar um método de análise com a cadeia de caracteres de formato personalizado correspondente ao especificador de formato "O" ou "o", você não terá os mesmos resultados de "O" ou "o".Note that if you call a parsing method with the custom format string that corresponds to the "O" or "o" format specifier, you won't get the same results as "O" or "o". Isso porque os métodos de análise que usam uma cadeia de caracteres de formato personalizado não podem analisar a representação da cadeia de caracteres de valores de data e hora que não tenham um componente de fuso horário ou usem "Z" para indicar o UTC.This is because parsing methods that use a custom format string can't parse the string representation of date and time values that lack a time zone component or use "Z" to indicate UTC.

O exemplo a seguir usa o especificador de formato "o" para exibir uma série de valores DateTime e um valor DateTimeOffset em um sistema nos EUA. Fuso horário do Pacífico.The following example uses the "o" format specifier to display a series of DateTime values and a DateTimeOffset value on a system in the U.S. Pacific Time zone.

using System;

public class Example
{
   public static void Main()
   {
       DateTime dat = new DateTime(2009, 6, 15, 13, 45, 30, 
                                   DateTimeKind.Unspecified);
       Console.WriteLine("{0} ({1}) --> {0:O}", dat, dat.Kind); 
   
       DateTime uDat = new DateTime(2009, 6, 15, 13, 45, 30, 
                                    DateTimeKind.Utc);
       Console.WriteLine("{0} ({1}) --> {0:O}", uDat, uDat.Kind);
       
       DateTime lDat = new DateTime(2009, 6, 15, 13, 45, 30, 
                                    DateTimeKind.Local);
       Console.WriteLine("{0} ({1}) --> {0:O}\n", lDat, lDat.Kind);
       
       DateTimeOffset dto = new DateTimeOffset(lDat);
       Console.WriteLine("{0} --> {0:O}", dto);
   }
}
// The example displays the following output:
//    6/15/2009 1:45:30 PM (Unspecified) --> 2009-06-15T13:45:30.0000000
//    6/15/2009 1:45:30 PM (Utc) --> 2009-06-15T13:45:30.0000000Z
//    6/15/2009 1:45:30 PM (Local) --> 2009-06-15T13:45:30.0000000-07:00
//    
//    6/15/2009 1:45:30 PM -07:00 --> 2009-06-15T13:45:30.0000000-07:00
Module Example
   Public Sub Main()
       Dim dat As New Date(2009, 6, 15, 13, 45, 30, 
                           DateTimeKind.Unspecified)
       Console.WriteLine("{0} ({1}) --> {0:O}", dat, dat.Kind) 
   
       Dim uDat As New Date(2009, 6, 15, 13, 45, 30, DateTimeKind.Utc)
       Console.WriteLine("{0} ({1}) --> {0:O}", uDat, uDat.Kind)
       
       Dim lDat As New Date(2009, 6, 15, 13, 45, 30, DateTimeKind.Local)
       Console.WriteLine("{0} ({1}) --> {0:O}", lDat, lDat.Kind)
       Console.WriteLine()
       
       Dim dto As New DateTimeOffset(lDat)
       Console.WriteLine("{0} --> {0:O}", dto)
   End Sub
End Module
' The example displays the following output:
'    6/15/2009 1:45:30 PM (Unspecified) --> 2009-06-15T13:45:30.0000000
'    6/15/2009 1:45:30 PM (Utc) --> 2009-06-15T13:45:30.0000000Z
'    6/15/2009 1:45:30 PM (Local) --> 2009-06-15T13:45:30.0000000-07:00
'    
'    6/15/2009 1:45:30 PM -07:00 --> 2009-06-15T13:45:30.0000000-07:00

O exemplo a seguir usa o especificador do formato “o” para criar uma cadeia de caracteres formatada e, em seguida, restaurar o valor de data e hora original ao chamar um método Parse de data e hora.The following example uses the "o" format specifier to create a formatted string, and then restores the original date and time value by calling a date and time Parse method.

// Round-trip DateTime values.
DateTime originalDate, newDate;
string dateString;
// Round-trip a local time.
originalDate = DateTime.SpecifyKind(new DateTime(2008, 4, 10, 6, 30, 0), DateTimeKind.Local);
dateString = originalDate.ToString("o");
newDate = DateTime.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, 
                  newDate, newDate.Kind);
// Round-trip a UTC time.
originalDate = DateTime.SpecifyKind(new DateTime(2008, 4, 12, 9, 30, 0), DateTimeKind.Utc);                  
dateString = originalDate.ToString("o");
newDate = DateTime.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, 
                  newDate, newDate.Kind);
// Round-trip time in an unspecified time zone.
originalDate = DateTime.SpecifyKind(new DateTime(2008, 4, 13, 12, 30, 0), DateTimeKind.Unspecified);                  
dateString = originalDate.ToString("o");
newDate = DateTime.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, 
                  newDate, newDate.Kind);

// Round-trip a DateTimeOffset value.
DateTimeOffset originalDTO = new DateTimeOffset(2008, 4, 12, 9, 30, 0, new TimeSpan(-8, 0, 0));
dateString = originalDTO.ToString("o");
DateTimeOffset newDTO = DateTimeOffset.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine("Round-tripped {0} to {1}.", originalDTO, newDTO);
// The example displays the following output:
//    Round-tripped 4/10/2008 6:30:00 AM Local to 4/10/2008 6:30:00 AM Local.
//    Round-tripped 4/12/2008 9:30:00 AM Utc to 4/12/2008 9:30:00 AM Utc.
//    Round-tripped 4/13/2008 12:30:00 PM Unspecified to 4/13/2008 12:30:00 PM Unspecified.
//    Round-tripped 4/12/2008 9:30:00 AM -08:00 to 4/12/2008 9:30:00 AM -08:00.
' Round-trip DateTime values.
Dim originalDate, newDate As Date
Dim dateString As String
' Round-trip a local time.
originalDate = Date.SpecifyKind(#4/10/2008 6:30AM#, DateTimeKind.Local)
dateString = originalDate.ToString("o")
newDate = Date.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, _
                  newDate, newDate.Kind)
' Round-trip a UTC time.
originalDate = Date.SpecifyKind(#4/12/2008 9:30AM#, DateTimeKind.Utc)                  
dateString = originalDate.ToString("o")
newDate = Date.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, _
                  newDate, newDate.Kind)
' Round-trip time in an unspecified time zone.
originalDate = Date.SpecifyKind(#4/13/2008 12:30PM#, DateTimeKind.Unspecified)                  
dateString = originalDate.ToString("o")
newDate = Date.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, _
                  newDate, newDate.Kind)

' Round-trip a DateTimeOffset value.
Dim originalDTO As New DateTimeOffset(#4/12/2008 9:30AM#, New TimeSpan(-8, 0, 0))
dateString = originalDTO.ToString("o")
Dim newDTO As DateTimeOffset = DateTimeOffset.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} to {1}.", originalDTO, newDTO)
' The example displays the following output:
'    Round-tripped 4/10/2008 6:30:00 AM Local to 4/10/2008 6:30:00 AM Local.
'    Round-tripped 4/12/2008 9:30:00 AM Utc to 4/12/2008 9:30:00 AM Utc.
'    Round-tripped 4/13/2008 12:30:00 PM Unspecified to 4/13/2008 12:30:00 PM Unspecified.
'    Round-tripped 4/12/2008 9:30:00 AM -08:00 to 4/12/2008 9:30:00 AM -08:00.

Voltar à tabelaBack to table

Especificador de formato RFC1123 ("R", "r")The RFC1123 ("R", "r") Format Specifier

O especificador de formato padrão “R” ou "r" representa uma cadeia de caracteres de formato de data e hora personalizado que é definida pela propriedade DateTimeFormatInfo.RFC1123Pattern.The "R" or "r" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.RFC1123Pattern property. O padrão reflete um padrão definido e a propriedade é somente leitura.The pattern reflects a defined standard, and the property is read-only. Portanto, ele é sempre o mesmo, independentemente da cultura usada ou do provedor de formato fornecido.Therefore, it is always the same, regardless of the culture used or the format provider supplied. A cadeia de caracteres de formato personalizado é "ddd, dd MMM aaaa HH':'mm':'ss 'GMT' ".The custom format string is "ddd, dd MMM yyyy HH':'mm':'ss 'GMT'". Quando esse especificador de formato padrão é usado, a operação de formatação ou análise sempre usa a cultura invariável.When this standard format specifier is used, the formatting or parsing operation always uses the invariant culture.

A cadeia de caracteres de resultado é afetada pelas seguintes propriedades do objeto DateTimeFormatInfo retornado pela propriedade DateTimeFormatInfo.InvariantInfo que representa a cultura invariável.The result string is affected by the following properties of the DateTimeFormatInfo object returned by the DateTimeFormatInfo.InvariantInfo property that represents the invariant culture.

PropriedadeProperty DESCRIÇÃODescription
RFC1123Pattern Define o formato da cadeia de caracteres de resultado.Defines the format of the result string.
AbbreviatedDayNames Define os nomes de dias abreviados que podem aparecer na cadeia de caracteres de resultado.Defines the abbreviated day names that can appear in the result string.
AbbreviatedMonthNames Define os nomes dos meses abreviados que podem aparecer na cadeia de caracteres de resultado.Defines the abbreviated month names that can appear in the result string.

Embora o padrão RFC 1123 expresse a hora no formato UTC (Hora Universal Coordenada), a operação de formatação não altera o valor do objeto DateTime que está sendo formatado.Although the RFC 1123 standard expresses a time as Coordinated Universal Time (UTC), the formatting operation does not modify the value of the DateTime object that is being formatted. Assim, você deve converter o valor de DateTime em UTC ao chamar o método DateTime.ToUniversalTime antes de executar a operação de formatação.Therefore, you must convert the DateTime value to UTC by calling the DateTime.ToUniversalTime method before you perform the formatting operation. Em contraste, os valores de DateTimeOffset executam essa conversão automaticamente; não há necessidade de chamar o método DateTimeOffset.ToUniversalTime antes da operação de formatação.In contrast, DateTimeOffset values perform this conversion automatically; there is no need to call the DateTimeOffset.ToUniversalTime method before the formatting operation.

O exemplo a seguir usa o especificador de formato "r" para exibir um valor DateTime e DateTimeOffset em um sistema nos EUA. Fuso horário do Pacífico.The following example uses the "r" format specifier to display a DateTime and a DateTimeOffset value on a system in the U.S. Pacific Time zone.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
DateTimeOffset dateOffset = new DateTimeOffset(date1, 
                            TimeZoneInfo.Local.GetUtcOffset(date1));
Console.WriteLine(date1.ToUniversalTime().ToString("r"));
// Displays Thu, 10 Apr 2008 13:30:00 GMT                       
Console.WriteLine(dateOffset.ToUniversalTime().ToString("r"));
// Displays Thu, 10 Apr 2008 13:30:00 GMT                        
Dim date1 As Date = #4/10/2008 6:30AM#
Dim dateOffset As New DateTimeOffset(date1, TimeZoneInfo.Local.GetUtcOFfset(date1))
Console.WriteLine(date1.ToUniversalTime.ToString("r"))
' Displays Thu, 10 Apr 2008 13:30:00 GMT                       
Console.WriteLine(dateOffset.ToUniversalTime.ToString("r"))
' Displays Thu, 10 Apr 2008 13:30:00 GMT                        

Voltar à tabelaBack to table

Especificador de formato classificável ("s")The Sortable ("s") Format Specifier

O especificador de formato padrão “s" representa uma cadeia de caracteres de formato de data e hora personalizado que é definida pela propriedade DateTimeFormatInfo.SortableDateTimePattern.The "s" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.SortableDateTimePattern property. O padrão reflete um padrão definido (ISO 8601) e a propriedade é somente leitura.The pattern reflects a defined standard (ISO 8601), and the property is read-only. Portanto, ele é sempre o mesmo, independentemente da cultura usada ou do provedor de formato fornecido.Therefore, it is always the same, regardless of the culture used or the format provider supplied. A cadeia de caracteres de formato personalizado é "aaaa'-'MM'-'dd'T'HH':'mm':'ss".The custom format string is "yyyy'-'MM'-'dd'T'HH':'mm':'ss".

A finalidade do especificador de formato "s" é produzir cadeias de caracteres de resultado que classificam consistentemente em ordem crescente ou decrescente com base nos valores de data e hora.The purpose of the "s" format specifier is to produce result strings that sort consistently in ascending or descending order based on date and time values. Como resultado, embora o especificador de formato padrão "s" represente um valor de data e hora em um formato consistente, a operação de formatação não modifica o valor do objeto de data e hora que está sendo formatado para refletir sua propriedade DateTime.Kind ou seu valor DateTimeOffset.Offset.As a result, although the "s" standard format specifier represents a date and time value in a consistent format, the formatting operation does not modify the value of the date and time object that is being formatted to reflect its DateTime.Kind property or its DateTimeOffset.Offset value. Por exemplo, as cadeias de caracteres de resultado produzidas pela formatação de valores de data e hora 2014-11-15T18:32:17+00:00 e 2014-11-15T18:32:17+08:00 são idênticas.For example, the result strings produced by formatting the date and time values 2014-11-15T18:32:17+00:00 and 2014-11-15T18:32:17+08:00 are identical.

Quando esse especificador de formato padrão é usado, a operação de formatação ou análise sempre usa a cultura invariável.When this standard format specifier is used, the formatting or parsing operation always uses the invariant culture.

O exemplo a seguir usa o especificador de formato "s" para exibir um valor DateTime e DateTimeOffset em um sistema nos EUA. Fuso horário do Pacífico.The following example uses the "s" format specifier to display a DateTime and a DateTimeOffset value on a system in the U.S. Pacific Time zone.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("s"));
// Displays 2008-04-10T06:30:00                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("s"))
' Displays 2008-04-10T06:30:00                       

Voltar à tabelaBack to table

Especificador de formato de hora abreviada ("t")The Short Time ("t") Format Specifier

O especificador de formato padrão “t” representa uma cadeia de caracteres de formato de data e hora personalizado que é definida pela propriedade DateTimeFormatInfo.ShortTimePattern atual.The "t" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.ShortTimePattern property. Por exemplo, a cadeia de caracteres de formato personalizado para a cultura invariável é "HH:mm".For example, the custom format string for the invariant culture is "HH:mm".

A cadeia de caracteres do resultado é afetada pelas informações de formatação de um objeto DateTimeFormatInfo específico.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. A tabela a seguir lista as propriedades do objeto DateTimeFormatInfo que podem controlar a formatação da cadeia de caracteres retornada.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. O especificador de formato personalizado que é retornado pela propriedade DateTimeFormatInfo.ShortTimePattern de algumas culturas não pode usar todas as propriedades.The custom format specifier that is returned by the DateTimeFormatInfo.ShortTimePattern property of some cultures may not make use of all properties.

PropriedadeProperty DESCRIÇÃODescription
ShortTimePattern Define o formato do componente de hora da cadeia de caracteres de resultado.Defines the format of the time component of the result string.
TimeSeparator Define a cadeia de caracteres que separa os componentes de hora, minuto e segundo de uma hora.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Define a cadeia de caracteres que indica as horas da meia-noite até antes do meio-dia em um relógio de 12 horas.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Define a cadeia de caracteres que indica as horas do meio-dia até antes da meia-noite em um relógio de 12 horas.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

O exemplo a seguir utiliza o especificador de formato "t" para exibir um valor de data e hora.The following example uses the "t" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("t", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays 6:30 AM                        
Console.WriteLine(date1.ToString("t", 
                  CultureInfo.CreateSpecificCulture("es-ES")));
// Displays 6:30                      
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("t", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays 6:30 AM                        
Console.WriteLine(date1.ToString("t", _
                  CultureInfo.CreateSpecificCulture("es-ES")))
' Displays 6:30                      

Voltar à tabelaBack to table

Especificador de formato de hora completa ("T")The Long Time ("T") Format Specifier

O especificador de formato padrão “T” representa uma cadeia de caracteres de formato de data e hora personalizado que é definida pela propriedade DateTimeFormatInfo.LongTimePattern de uma cultura específica.The "T" standard format specifier represents a custom date and time format string that is defined by a specific culture's DateTimeFormatInfo.LongTimePattern property. Por exemplo, a cadeia de caracteres de formato personalizado para a cultura invariável é "HH:mm:ss".For example, the custom format string for the invariant culture is "HH:mm:ss".

A tabela a seguir lista as propriedades do objeto DateTimeFormatInfo que podem controlar a formatação da cadeia de caracteres retornada.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. O especificador de formato personalizado que é retornado pela propriedade DateTimeFormatInfo.LongTimePattern de algumas culturas não pode usar todas as propriedades.The custom format specifier that is returned by the DateTimeFormatInfo.LongTimePattern property of some cultures may not make use of all properties.

PropriedadeProperty DESCRIÇÃODescription
LongTimePattern Define o formato do componente de hora da cadeia de caracteres de resultado.Defines the format of the time component of the result string.
TimeSeparator Define a cadeia de caracteres que separa os componentes de hora, minuto e segundo de uma hora.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Define a cadeia de caracteres que indica as horas da meia-noite até antes do meio-dia em um relógio de 12 horas.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Define a cadeia de caracteres que indica as horas do meio-dia até antes da meia-noite em um relógio de 12 horas.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

O exemplo a seguir utiliza o especificador de formato "T" para exibir um valor de data e hora.The following example uses the "T" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("T", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays 6:30:00 AM                       
Console.WriteLine(date1.ToString("T", 
                  CultureInfo.CreateSpecificCulture("es-ES")));
// Displays 6:30:00                      
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("T", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays 6:30:00 AM                       
Console.WriteLine(date1.ToString("T", _
                  CultureInfo.CreateSpecificCulture("es-ES")))
' Displays 6:30:00                      

Voltar à tabelaBack to table

Especificador de formato classificável universal ("u").The Universal Sortable ("u") Format Specifier

O especificador de formato padrão “u" representa uma cadeia de caracteres de formato de data e hora personalizado que é definida pela propriedade DateTimeFormatInfo.UniversalSortableDateTimePattern.The "u" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.UniversalSortableDateTimePattern property. O padrão reflete um padrão definido e a propriedade é somente leitura.The pattern reflects a defined standard, and the property is read-only. Portanto, ele é sempre o mesmo, independentemente da cultura usada ou do provedor de formato fornecido.Therefore, it is always the same, regardless of the culture used or the format provider supplied. A cadeia de caracteres de formato personalizado é "aaaa'-'MM'-'dd HH':'mm':'ss'Z'".The custom format string is "yyyy'-'MM'-'dd HH':'mm':'ss'Z'". Quando esse especificador de formato padrão é usado, a operação de formatação ou análise sempre usa a cultura invariável.When this standard format specifier is used, the formatting or parsing operation always uses the invariant culture.

Embora a cadeia de caracteres de resultado deva expressar a hora no formato UTC, nenhuma conversão do valor de DateTime original é executada durante a operação de formatação.Although the result string should express a time as Coordinated Universal Time (UTC), no conversion of the original DateTime value is performed during the formatting operation. Assim, você deve converter um valor de DateTime em UTC ao chamar o método DateTime.ToUniversalTime antes de formatá-lo.Therefore, you must convert a DateTime value to UTC by calling the DateTime.ToUniversalTime method before formatting it. Em contraste, os valores de DateTimeOffset executam essa conversão automaticamente; não há necessidade de chamar o método DateTimeOffset.ToUniversalTime antes da operação de formatação.In contrast, DateTimeOffset values perform this conversion automatically; there is no need to call the DateTimeOffset.ToUniversalTime method before the formatting operation.

O exemplo a seguir utiliza o especificador de formato "u" para exibir um valor de data e hora.The following example uses the "u" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToUniversalTime().ToString("u"));
// Displays 2008-04-10 13:30:00Z                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToUniversalTime.ToString("u"))
' Displays 2008-04-10 13:30:00Z                       

Voltar à tabelaBack to table

Especificador de formato completo universal ("U").The Universal Full ("U") Format Specifier

O especificador de formato padrão “U” representa uma cadeia de caracteres de formato de data e hora personalizado que é definida pela propriedade DateTimeFormatInfo.FullDateTimePattern de uma cultura específica.The "U" standard format specifier represents a custom date and time format string that is defined by a specified culture's DateTimeFormatInfo.FullDateTimePattern property. O padrão é o mesmo que o padrão "F".The pattern is the same as the "F" pattern. Entretanto, o valor de DateTime é automaticamente convertido em UTC antes de ser formatado.However, the DateTime value is automatically converted to UTC before it is formatted.

A tabela a seguir lista as propriedades do objeto DateTimeFormatInfo que podem controlar a formatação da cadeia de caracteres retornada.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. O especificador de formato personalizado que é retornado pela propriedade FullDateTimePattern de algumas culturas não pode usar todas as propriedades.The custom format specifier that is returned by the FullDateTimePattern property of some cultures may not make use of all properties.

PropriedadeProperty DESCRIÇÃODescription
FullDateTimePattern Define o formato geral da cadeia de caracteres de resultado.Defines the overall format of the result string.
DayNames Define os nomes de dias localizados que podem aparecer na cadeia de caracteres de resultado.Defines the localized day names that can appear in the result string.
MonthNames Define os nomes dos meses localizados que podem aparecer na cadeia de caracteres de resultado.Defines the localized month names that can appear in the result string.
TimeSeparator Define a cadeia de caracteres que separa os componentes de hora, minuto e segundo de uma hora.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Define a cadeia de caracteres que indica as horas da meia-noite até antes do meio-dia em um relógio de 12 horas.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Define a cadeia de caracteres que indica as horas do meio-dia até antes da meia-noite em um relógio de 12 horas.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

O especificador de formato "U" não é suportado pelo tipo DateTimeOffset e gera uma FormatException ao ser usado para formatar um valor DateTimeOffset.The "U" format specifier is not supported by the DateTimeOffset type and throws a FormatException if it is used to format a DateTimeOffset value.

O exemplo a seguir utiliza o especificador de formato "U" para exibir um valor de data e hora.The following example uses the "U" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("U", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008 1:30:00 PM                       
Console.WriteLine(date1.ToString("U", 
                  CultureInfo.CreateSpecificCulture("sv-FI")));
// Displays den 10 april 2008 13:30:00                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("U", CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008 1:30:00 PM                       
Console.WriteLine(date1.ToString("U", CultureInfo.CreateSpecificCulture("sv-FI")))
' Displays den 10 april 2008 13:30:00                       

Voltar à tabelaBack to table

Especificador de formato de ano mês ("Y", "y")The Year Month ("Y", "y") Format Specifier

O especificador de formato padrão “Y” ou "y" representa uma cadeia de caracteres de formato de data e hora personalizado que é definida pela propriedade DateTimeFormatInfo.YearMonthPattern de uma cultura específica.The "Y" or "y" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.YearMonthPattern property of a specified culture. Por exemplo, a cadeia de caracteres de formato personalizado para o cultura invariável é "aaaa MMMM".For example, the custom format string for the invariant culture is "yyyy MMMM".

A tabela a seguir lista as propriedades do objeto DateTimeFormatInfo que controlam a formatação da cadeia de caracteres retornada.The following table lists the DateTimeFormatInfo object properties that control the formatting of the returned string.

PropriedadeProperty DESCRIÇÃODescription
YearMonthPattern Define o formato geral da cadeia de caracteres de resultado.Defines the overall format of the result string.
MonthNames Define os nomes dos meses localizados que podem aparecer na cadeia de caracteres de resultado.Defines the localized month names that can appear in the result string.

O exemplo a seguir utiliza o especificador de formato "y" para exibir um valor de data e hora.The following example uses the "y" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("Y", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays April, 2008                       
Console.WriteLine(date1.ToString("y", 
                  CultureInfo.CreateSpecificCulture("af-ZA")));
// Displays April 2008                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("Y", CultureInfo.CreateSpecificCulture("en-US")))
' Displays April, 2008                       
Console.WriteLine(date1.ToString("y", CultureInfo.CreateSpecificCulture("af-ZA")))
' Displays April 2008                       

Voltar à tabelaBack to table

ObservaçõesNotes

Configurações do Painel de ControleControl Panel Settings

As configurações no item Opções Regionais e de Idioma do Painel de Controle influenciam a cadeia de caracteres de resultado produzida por uma operação de formatação.The settings in the Regional and Language Options item in Control Panel influence the result string produced by a formatting operation. Essas configurações são usadas para inicializar o objeto DateTimeFormatInfo associado à cultura de thread atual, a qual fornece os valores usados para determinar a formatação.These settings are used to initialize the DateTimeFormatInfo object associated with the current thread culture, which provides values used to govern formatting. Computadores que usam configurações diferentes geram cadeias de caracteres de resultado diferentes.Computers that use different settings generate different result strings.

Além disso, se o constructo CultureInfo.CultureInfo(String) for usado para criar uma instância de um novo objeto CultureInfo que representa a mesma cultura que a cultura atual do sistema, quaisquer personalizações estabelecidas pelo item Opções Regionais e de Idioma no Painel de Controle serão aplicadas ao novo objeto CultureInfo.In addition, if you use the CultureInfo.CultureInfo(String) constructor to instantiate a new CultureInfo object that represents the same culture as the current system culture, any customizations established by the Regional and Language Options item in Control Panel will be applied to the new CultureInfo object. Você pode usar o construtor CultureInfo.CultureInfo(String, Boolean) para criar um objeto CultureInfo que não reflita as personalizações de um sistema.You can use the CultureInfo.CultureInfo(String, Boolean) constructor to create a CultureInfo object that does not reflect a system's customizations.

Propriedades DateTimeFormatInfoDateTimeFormatInfo Properties

A formatação é influenciada pelas propriedades do objeto DateTimeFormatInfo atual, que é fornecido implicitamente pela cultura de thread atual ou explicitamente pelo parâmetro IFormatProvider do método que invoca a formatação.Formatting is influenced by properties of the current DateTimeFormatInfo object, which is provided implicitly by the current thread culture or explicitly by the IFormatProvider parameter of the method that invokes formatting. Para o parâmetro IFormatProvider, seu aplicativo deve especificar um objeto CultureInfo, que representa uma cultura, ou um objeto DateTimeFormatInfo, que representa as convenções de formatação de data e hora de uma determinada cultura.For the IFormatProvider parameter, your application should specify a CultureInfo object, which represents a culture, or a DateTimeFormatInfo object, which represents a particular culture's date and time formatting conventions. Muitos dos especificadores de formato padrão de data e hora são aliases para padrões de formatação definidos pelas propriedades do objeto DateTimeFormatInfo atual.Many of the standard date and time format specifiers are aliases for formatting patterns defined by properties of the current DateTimeFormatInfo object. Seu aplicativo pode alterar o resultado produzido por alguns especificadores de formato padrão de data e hora alterando os padrões de formatação de data e hora correspondentes da propriedade DateTimeFormatInfo.Your application can change the result produced by some standard date and time format specifiers by changing the corresponding date and time format patterns of the corresponding DateTimeFormatInfo property.

Consulte tambémSee also