Cadeias de caracteres de formato de data e hora padrão

Artigo
2025-03-22

Uma cadeia de caracteres de formato de data e hora padrão usa um único caractere como especificador de formato para definir a representação de texto de um DateTime ou um valor de DateTimeOffset. Qualquer cadeia de caracteres de formato de data e hora que contenha mais de um caractere, incluindo espaço em branco, é interpretada como uma cadeia de caracteres de formato de data e hora personalizada. Uma cadeia de caracteres de formato padrão ou personalizado pode ser usada de duas maneiras:

Para definir a cadeia de caracteres que resulta de uma operação de formatação.
Para definir a representação de texto de um valor de data e hora que pode ser convertido em um valor DateTime ou DateTimeOffset por uma operação de análise.

Tip

Você pode baixar o Formatting Utility, um aplicativo .NET Windows Forms 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. O código-fonte está disponível para C# e Visual Basic.

Observação

Alguns dos exemplos de C# neste artigo são executados no Try.NET corredor de código embutido e playground. Selecione o botão Executar para executar um exemplo em uma janela interativa. Depois de executar o código, você pode modificá-lo e executar o código modificado selecionando Executar novamente. O código modificado é executado na janela interativa ou, se a compilação falhar, a janela interativa exibe todas as mensagens de erro do compilador C#.

O de fuso horário local do Try.NET corredor de código embutido e playground é Tempo Universal Coordenado ou UTC. Isso pode afetar o comportamento e a saída de exemplos que ilustram os tipos DateTime, DateTimeOffsete TimeZoneInfo e seus membros.

Tabela de especificadores de formato

A tabela a seguir descreve os especificadores de formato de data e hora padrão. Salvo indicação em contrário, um especificador de formato de data e hora padrão específico produz uma representação de cadeia de caracteres idêntica, independentemente de ser usada com um valor DateTime ou DateTimeOffset. Consulte Configurações do Painel de Controle e Propriedades DateTimeFormatInfo para obter informações adicionais sobre como usar cadeias de caracteres de formato de data e hora padrão.

Especificador de formato	Descrição	Exemplos
"d"	Padrão de data curto. Para obter mais informações:O especificador de formato de data abreviada ("d").	2009-06-15T13:45:30 -> 6/15/2009 (pt-BR) 2009-06-15T13:45:30 -> 15/06/2009 (fr-FR) 2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D"	Padrão de data longa. Para obter mais informações:O especificador de formato de data longa ("D").	2009-06-15T13:45:30 -> segunda-feira, 15 de junho de 2009 (pt-BR) 2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (ru-RU) 2009-06-15T13:45:30 -> Montag, 15. Junho 2009 (de-DE)
"f"	Padrão de data/hora completa (tempo curto). Para obter mais informações: O especificador de formato de data completa (f).	2009-06-15T13:45:30 -> segunda-feira, 15 de junho de 2009 13:45 (pt-BR) 2009-06-15T13:45:30 -> den 15 junho 2009 13:45 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)
"F"	Padrão de data/hora completa (tempo longo). Para obter mais informações: O especificador de formato de data longa ("F") completo.	2009-06-15T13:45:30 -> segunda-feira, 15 de junho de 2009 13:45:30 (pt-BR) 2009-06-15T13:45:30 -> den 15 junho 2009 13:45:30 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)
"g"	Padrão geral de data/hora (tempo curto). Para obter mais informações: O especificador de formato de data abreviada (g) geral.	2009-06-15T13:45:30 -> 6/15/2009 13:45 (pt-BR) 2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES) 2009/06/15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G"	Padrão geral de data/hora (tempo longo). Para obter mais informações: O especificador de formato de data longa ("G") geral.	2009-06-15T13:45:30 -> 6/15/2009 13:45:30 (pt-BR) 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)
"M", "m"	Padrão mês/dia. Para obter mais informações: O especificador de formato de mês ("M", "m").	2009-06-15T13:45:30 -> 15 de junho (pt-BR) 2009-06-15T13:45:30 -> 15. juni (da-DK) 2009-06-15T13:45:30 -> 15 junho (ID-ID)
"O", "o"	padrão de data/hora de ida e volta. Mais informações: O especificador de formato de ida e volta ("O", "o").	DateTime valores: 2009-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.0000000Z 2009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.0000000 DateTimeOffset valores: 2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:00
"R", "r"	RFC1123 padrão. Para obter mais informações: O especificador de formato RFC1123 ("R", "r").	DateTimeOffset entrada: 2009-06-15T13:45:30 -> Mon, 15 jun 2009 20:45:30 GMT DateTime entrada: 2009-06-15T13:45:30 -> Mon, 15 jun 2009 13:45:30 GMT
"s"	Padrão de data/hora classificável. Para obter mais informações: O especificador de formato classificável ("s").	2009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:30 2009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:30
"t"	Padrão de tempo curto. Para obter mais informações: O especificador de formato de tempo curto ("t").	2009-06-15T13:45:30 -> 13:45 (pt-BR) 2009-06-15T13:45:30 -> 13:45 (hr-HR) 2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T"	Padrão de tempo longo. Para obter mais informações: O especificador de formato de longo tempo ("T").	2009-06-15T13:45:30 -> 13:45:30 (pt-BR) 2009-06-15T13:45:30 -> 13:45:30 (hr-HR) 2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"U"	Padrão universal de data/hora classificável. Para obter mais informações: O especificador de formato universal classificável ("u").	Com um valor de DateTime: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z Com um valor de DateTimeOffset: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U"	Padrão universal de data/hora completa. Para obter mais informações: O especificador de formato completo universal ("U").	2009-06-15T13:45:30 -> segunda-feira, 15 de junho de 2009 20:45:30 (en-US) 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)
"Y", "y"	Padrão do mês do ano. Para obter mais informações: O especificador de formato do mês do ano ("Y").	2009-06-15T13:45:30 -> junho 2009 (pt-BR) 2009-06-15T13:45:30 -> juni 2009 (da-DK) 2009-06-15T13:45:30 -> junho 2009 (id-ID)
Qualquer outro caractere único	Especificador desconhecido.	Lança uma FormatExceptionde tempo de execução .

Como funcionam as cadeias de caracteres de formato padrão

Em uma operação de formatação, uma cadeia de caracteres de formato padrão é simplesmente um alias para uma cadeia de caracteres de formato personalizado. A vantagem de usar um alias para se referir a uma cadeia de caracteres de formato personalizado é que, embora o alias permaneça invariante, a própria cadeia de caracteres de formato personalizado pode variar. Isso é importante porque as representações de cadeia de caracteres de valores de data e hora normalmente variam de acordo com a cultura. Por exemplo, a cadeia de caracteres de formato padrão "d" indica que um valor de data e hora deve ser exibido usando um padrão de data curto. Para a cultura invariante, este padrão é "MM/dd/aaaa". Para a cultura fr-FR, é "dd/MM/aaaa". Para a cultura ja-JP, é "yyyy/MM/dd".

Se uma cadeia de caracteres de formato padrão em uma operação de formatação for mapeada para a cadeia de caracteres de formato personalizado de uma cultura específica, seu aplicativo poderá definir a cultura específica cujas cadeias de caracteres de formato personalizado serão usadas de uma destas maneiras:

Você pode usar a cultura padrão (ou atual). O exemplo a seguir exibe uma data usando o formato de data abreviada da cultura atual. Neste caso, a cultura atual é 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 tenha um parâmetro IFormatProvider. O exemplo a seguir exibe uma data usando o formato de data abreviada da cultura pt-BR.

// 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 tenha um parâmetro IFormatProvider. O exemplo a seguir exibe uma data usando o formato de data abreviada de um objeto DateTimeFormatInfo para a cultura hr-HR.

// 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 cadeias de caracteres usados na formatação de valores de data e hora, consulte o tópico NumberFormatInfo classe.

Em alguns casos, a cadeia de caracteres de formato padrão serve como uma abreviação conveniente para uma cadeia de caracteres de formato personalizado mais longa que é invariante. Quatro cadeias de caracteres de formato padrão se enquadram nesta categoria: "O" (ou "o"), "R" (ou "r"), "s" e "u". Essas cadeias de caracteres correspondem a cadeias de caracteres de formato personalizado definidas pela cultura invariante. Eles produzem representações de cadeia de caracteres de valores de data e hora que se destinam a ser idênticos entre culturas. A tabela a seguir fornece informações sobre essas quatro cadeias de caracteres de formato de data e hora padrão.

Cadeia de caracteres de formato padrão	Definido pela propriedade DateTimeFormatInfo.InvariantInfo	Cadeia de caracteres de formato personalizado
"O" ou "o"	Nenhum	aaaa'-'MM'-'dd'T'HH':'mm':'ss'.' fffffffK
"R" ou "r"	RFC1123Pattern	ddd, dd MMM aaaa HH':'mm':'ss 'GMT'
"s"	SortableDateTimePattern	aaaa'-'MM'-'dd'T'HH':'mm':'ss
"U"	UniversalSortableDateTimePattern	aaaa'-'MM'-'dd HH':'mm':'ss'Z'

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, que exigem uma cadeia de caracteres de entrada para estar exatamente em conformidade com um padrão específico para que a operação de análise seja bem-sucedida. Muitas cadeias de caracteres de formato padrão são mapeadas para várias cadeias de caracteres de formato personalizado, de modo que um valor de data e hora pode ser representado em uma variedade de formatos e a operação de análise ainda terá êxito. Você pode determinar a cadeia de caracteres de formato personalizado ou cadeias de caracteres que correspondem a uma cadeia de caracteres de formato padrão chamando o método DateTimeFormatInfo.GetAllDateTimePatterns(Char). O exemplo a seguir exibe as cadeias de caracteres de formato personalizado que mapeiam para a cadeia de caracteres de formato padrão "d" (padrão de data curta).

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($"   {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.

Formatos de data

Este grupo inclui os seguintes formatos:

O especificador de formato de data curta ("d")
O especificador de formato de data longa ("D")

O especificador de formato de data curta ("d")

O especificador de formato padrão "d" representa uma cadeia de caracteres de formato de data e hora personalizada que é definida pela propriedade DateTimeFormatInfo.ShortDatePattern de uma cultura específica. Por exemplo, a cadeia de caracteres de formato personalizado que é retornada pela propriedade ShortDatePattern da cultura invariante é "MM/dd/aa".

A tabela a seguir lista as propriedades do objeto DateTimeFormatInfo que controlam a formatação da cadeia de caracteres retornada.

Propriedade	Descrição
ShortDatePattern	Define o formato geral da cadeia de caracteres de resultado.
DateSeparator	Define a cadeia de caracteres que separa os componentes ano, mês e dia de uma data.

O exemplo a seguir usa o especificador de formato "d" para exibir um valor de data e hora.

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

Propriedade	Descrição
LongDatePattern	Define o formato geral da cadeia de caracteres de resultado.
DayNames	Define os nomes de dias localizados que podem aparecer na cadeia de caracteres de resultados.
MonthNames	Define os nomes de meses localizados que podem aparecer na cadeia de caracteres de resultados.

Propriedade	Descrição
LongDatePattern	Define o formato do componente de data da cadeia de caracteres de resultado.
ShortTimePattern	Define o formato do componente de tempo da cadeia de caracteres de resultado.
DayNames	Define os nomes de dias localizados que podem aparecer na cadeia de caracteres de resultados.
MonthNames	Define os nomes de meses localizados que podem aparecer na cadeia de caracteres de resultados.
TimeSeparator	Define a cadeia de caracteres que separa os componentes hora, minuto e segundo de um tempo.
AMDesignator	Define a cadeia de caracteres que indica os horários da meia-noite até antes do meio-dia em um relógio de 12 horas.
PMDesignator	Define a cadeia de caracteres que indica os horários do meio-dia até antes da meia-noite em um relógio de 12 horas.

Propriedade	Descrição
FullDateTimePattern	Define o formato geral da cadeia de caracteres de resultado.
DayNames	Define os nomes de dias localizados que podem aparecer na cadeia de caracteres de resultados.
MonthNames	Define os nomes de meses localizados que podem aparecer na cadeia de caracteres de resultados.
TimeSeparator	Define a cadeia de caracteres que separa os componentes hora, minuto e segundo de um tempo.
AMDesignator	Define a cadeia de caracteres que indica os horários da meia-noite até antes do meio-dia em um relógio de 12 horas.
PMDesignator	Define a cadeia de caracteres que indica os horários do meio-dia até antes da meia-noite em um relógio de 12 horas.

Propriedade	Descrição
ShortDatePattern	Define o formato do componente de data da cadeia de caracteres de resultado.
LongTimePattern	Define o formato do componente de tempo da cadeia de caracteres de resultado.
DateSeparator	Define a cadeia de caracteres que separa os componentes ano, mês e dia de uma data.
TimeSeparator	Define a cadeia de caracteres que separa os componentes hora, minuto e segundo de um tempo.
AMDesignator	Define a cadeia de caracteres que indica os horários da meia-noite até antes do meio-dia em um relógio de 12 horas.
PMDesignator	Define a cadeia de caracteres que indica os horários do meio-dia até antes da meia-noite em um relógio de 12 horas.

Propriedade	Descrição
RFC1123Pattern	Define o formato da cadeia de caracteres de resultado.
AbbreviatedDayNames	Define os nomes de dias abreviados que podem aparecer na cadeia de caracteres de resultados.
AbbreviatedMonthNames	Define os nomes de meses abreviados que podem aparecer na cadeia de caracteres de resultados.

Propriedade	Descrição
MonthDayPattern	Define o formato geral da cadeia de caracteres de resultado.
MonthNames	Define os nomes de meses localizados que podem aparecer na cadeia de caracteres de resultados.

Propriedade	Descrição
YearMonthPattern	Define o formato geral da cadeia de caracteres de resultado.
MonthNames	Define os nomes de meses localizados que podem aparecer na cadeia de caracteres de resultados.

Partilhar via

Cadeias de caracteres de formato de data e hora padrão

Tabela de especificadores de formato

Como funcionam as cadeias de caracteres de formato padrão

Formatos de data

O especificador de formato de data curta ("d")

O especificador de formato de data longa ("D")

Formatos de data e hora

O especificador de formato de data completa e hora curta ("f")

O especificador de formato de data longa ("F") completo

O especificador de formato de data abreviada (g) geral

O especificador de formato de data longa ("G") geral

O especificador de formato de ida e volta ("O", "o")

O especificador de formato RFC1123 ("R", "r")

O especificador de formato classificável ("s")

O especificador de formato universal classificável ("u")

O especificador de formato completo universal ("U")

Formatos de hora

O especificador de formato de tempo curto ("t")

O especificador de formato de longa duração ("T")

Formatos parciais de data

O especificador de formato do mês ("M", "m")

O especificador de formato do mês do ano ("Y", "y")

Configurações do Painel de Controle

DateTimeFormatInfo propriedades

Ver também

Recursos adicionais