Cadeias de formato de data e hora padrão

Artigo
04/11/2023

Uma cadeia de formato de data e hora padrão utiliza um único caráter como o especificador de formato para definir a representação de texto de um DateTime ou de um DateTimeOffset valor. Qualquer cadeia de formato de data e hora que contenha mais do que um caráter, incluindo espaço em branco, é interpretada como uma cadeia de formato de data e hora personalizada. Uma cadeia de formato padrão ou personalizada pode ser utilizada de duas formas:

Para definir a cadeia 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 num DateTime valor ou DateTimeOffset por uma operação de análise.

Dica

Pode transferir o Utilitário de Formatação, uma aplicação .NET Windows Forms que lhe permite aplicar cadeias de formato a valores numéricos ou de data e hora e apresentar a cadeia de resultados. O código fonte está disponível para C# e Visual Basic.

Nota

Alguns dos exemplos de C# neste artigo são executados no Try.NET inline code runner e playground. Selecione o botão Executar para executar um exemplo numa janela interativa. Depois de executar o código, pode modificá-lo e executar o código modificado ao selecionar Executar novamente. O código modificado é executado na janela interativa ou, se a compilação falhar, a janela interativa apresenta todas as mensagens de erro do compilador C#.

O fuso horário local do Try.NET linha de código inline e playground é Hora Universal Coordenada ou UTC. Isto pode afetar o comportamento e a saída de exemplos que ilustram os DateTimetipos , DateTimeOffsete e TimeZoneInfo e os respetivos membros.

Especificadores de tabela de formato

A tabela seguinte 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 idêntica, independentemente de ser utilizado com um DateTime ou um DateTimeOffset valor. Veja Definições de Painel de Controlo e Propriedades DateTimeFormatInfo para obter informações adicionais sobre como utilizar cadeias de formato de data e hora padrão.

Especificador de formato	Descrição	Exemplos
"d"	Padrão de data abreviada. Mais informações: o especificador de formato de data abreviada ("d").	2009-06-15T13:45:30 -> 15/6/2009 (en-US) 2009-06-15T13:45:30 -> 06/15/2009 (fr-FR) 2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D"	Padrão de data longa. Mais informações: o especificador de formato de data longa ("D").	06-2009-15T13:45:30 -> Segunda-feira, 15 de Junho de 2009 (en-US) 2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (ru-RU) 2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)
"f"	Padrão de data/hora completa (hora abreviada). Mais informações: O especificador de formato de data curta ("f") completo.	06-2009-15T13:45:30 -> Segunda-feira, 15 de Junho de 2009 13:45 (en-US) 2009-06-15T13:45:30 -> den 15 juni 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). Mais informações: O especificador do formato de data completa de longa duração ("F").	06-2009-15T13:45:30 -> Segunda-feira, 15 de junho de 2009 13:45:30 (en-US) 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)
"g"	Padrão de data/hora geral (hora abreviada). Mais informações: o especificador do formato de data e hora ("g") geral.	2009-06-15T13:45:30 -> 15/06/2009 13:45 (en-US) 06-2009-15T13:45:30 -> 06/15/2009 13:45 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G"	Padrão de data/hora geral (tempo longo). Mais informações: o especificador de formato de data longa ("G") geral.	2009-06-15T13:45:30 -> 15/6/2009 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> 06/15/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. Mais informações: o especificador do formato month ("M", "m").	2009-06-15T13:45:30 -> 15 de junho (en-US) 06-2009-15T13:45:30 -> 15. juni (da-DK) 2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o"	padrão de data/hora de ida e volta. Mais informações: O especificador do 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.Specificed) --> 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"	Padrão RFC1123. 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 ordenável. Mais informações: o especificador de formato ("s") ordenável.	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. Mais informações: o especificador de formato de curto prazo ("t").	06-2009-15T13:45:30 -> 13:45 (en-US) 2009-06-15T13:45:30 -> 13:45 (hr-HR) 06-2009-15T13:45:30 -> 01:45 م (ar-EG)
"T"	Padrão de tempo longo. Mais informações: o especificador de formato de longo prazo ("T").	06-2009-15T13:45:30 -> 13:45:30 (en-US) 2009-06-15T13:45:30 -> 13:45:30 (hr-HR) 06-2009-15T13:45:30 -> 01:45:30 م (ar-EG)
"u"	Padrão de data/hora ordenável universal. Mais informações: O especificador de formato universal ordenável ("u").	Com um DateTime valor: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z Com um DateTimeOffset valor: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U"	Padrão de data/hora completa universal. Mais informações: O especificador de formato completo universal ("U").	06-2009-15T13:45:30 -> Segunda-feira, 15 de Junho de 2009 20:45:30 PM (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 de mês de ano. Mais informações: O especificador de formato do mês do ano ("Y").	06-2009-15T13:45:30 -> Junho de 2009 (en-US) 2009-06-15T13:45:30 -> juni 2009 (da-DK) 06-2009-15T13:45:30 -> Juni 2009 (id-ID)
Qualquer outro caráter individual	Especificador desconhecido.	Lança um run-time FormatException.

Como funcionam as cadeias de formato padrão

Numa operação de formatação, uma cadeia de formato padrão é simplesmente um alias para uma cadeia de formato personalizado. A vantagem de utilizar um alias para fazer referência a uma cadeia de formato personalizado é que, embora o alias permaneça invariável, a cadeia de formato personalizado em si pode variar. Isto é importante porque as representações de cadeia de carateres dos valores de data e hora normalmente variam consoante a cultura. Por exemplo, a cadeia de formato padrão "d" indica que um valor de data e hora deve ser apresentado através de um padrão de data abreviada. Para a cultura invariante, este padrão é "MM/dd/aaaa". Para a cultura fr-FR, é "dd/MM/aaaa". Para a cultura ja-JP, é "aaaa/MM/dd".

Se uma cadeia de formato padrão numa operação de formatação mapeia para uma cadeia de formato personalizada de uma determinada cultura, a sua aplicação pode definir a cultura específica cujas cadeias de formato personalizado são utilizadas de uma destas formas:

Pode utilizar a cultura predefinida (ou atual). O exemplo seguinte apresenta uma data com 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

Pode transmitir um CultureInfo objeto que representa a cultura cuja formatação deve ser utilizada para um método que tenha um IFormatProvider parâmetro. O exemplo seguinte apresenta uma data com 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

Pode transmitir um DateTimeFormatInfo objeto que fornece informações de formatação a um método que tem um IFormatProvider parâmetro. O exemplo seguinte apresenta uma data com o formato de data abreviada de um DateTimeFormatInfo objeto 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

Nota

Para obter informações sobre como personalizar os padrões ou cadeias utilizados na formatação de valores de data e hora, consulte o tópico de NumberFormatInfo classe.

Em alguns casos, a cadeia de formato padrão serve como uma abreviatura conveniente para uma cadeia de formato personalizada mais longa que é invariável. Quatro cadeias de formato padrão enquadram-se nesta categoria: "O" (ou "o"), "R" (ou "r"), "s" e "u". Estas cadeias correspondem a cadeias de formato personalizadas definidas pela cultura invariante. Produzem representações de cadeia de carateres de valores de data e hora que se destinam a ser idênticos entre culturas. A tabela seguinte fornece informações sobre estas quatro cadeias de formato de data e hora padrão.

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

As cadeias de formato padrão também podem ser utilizadas em operações de análise com os DateTime.ParseExact métodos ou DateTimeOffset.ParseExact , que requerem uma cadeia 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 formato padrão mapeiam para múltiplas cadeias de formato personalizado, pelo que um valor de data e hora pode ser representado numa variedade de formatos e a operação de análise continuará a ser bem-sucedida. Pode determinar a cadeia de formato personalizado ou cadeias que correspondem a uma cadeia de formato padrão ao chamar o DateTimeFormatInfo.GetAllDateTimePatterns(Char) método . O exemplo seguinte apresenta as cadeias de formato personalizado que mapeiam para a cadeia de formato padrão "d" (padrão de data abreviada).

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 secções seguintes descrevem os especificadores de formato padrão para DateTime os valores e DateTimeOffset .

Formatos de data

Este grupo inclui os seguintes formatos:

O especificador do formato de data abreviada ("d")
O especificador de formato de data longa ("D")

O especificador do formato de data abreviada ("d")

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

A tabela seguinte lista as propriedades do DateTimeFormatInfo objeto que controlam a formatação da cadeia devolvida.

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

O exemplo seguinte utiliza o especificador de formato "d" para apresentar 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 resultados.
DayNames	Define os nomes de dia localizados que podem aparecer na cadeia de resultados.
MonthNames	Define os nomes dos meses localizados que podem aparecer na cadeia de resultados.

Propriedade	Descrição
LongDatePattern	Define o formato do componente de data da cadeia de resultados.
ShortTimePattern	Define o formato do componente de tempo da cadeia de resultados.
DayNames	Define os nomes dos dias localizados que podem aparecer na cadeia de resultados.
MonthNames	Define os nomes de mês localizados que podem aparecer na cadeia de resultados.
TimeSeparator	Define a cadeia que separa os componentes de hora, minuto e segundo de uma hora.
AMDesignator	Define a cadeia que indica as horas da meia-noite até ao meio-dia num relógio de 12 horas.
PMDesignator	Define a cadeia que indica as horas do meio-dia à meia-noite num relógio de 12 horas.

Propriedade	Descrição
FullDateTimePattern	Define o formato geral da cadeia de resultados.
DayNames	Define os nomes dos dias localizados que podem aparecer na cadeia de resultados.
MonthNames	Define os nomes de mês localizados que podem aparecer na cadeia de resultados.
TimeSeparator	Define a cadeia que separa os componentes de hora, minuto e segundo de uma hora.
AMDesignator	Define a cadeia que indica as horas da meia-noite até ao meio-dia num relógio de 12 horas.
PMDesignator	Define a cadeia que indica as horas do meio-dia à meia-noite num relógio de 12 horas.

Propriedade	Descrição
ShortDatePattern	Define o formato do componente de data da cadeia de resultados.
LongTimePattern	Define o formato do componente de tempo da cadeia de resultados.
DateSeparator	Define a cadeia que separa os componentes ano, mês e dia de uma data.
TimeSeparator	Define a cadeia que separa os componentes de hora, minuto e segundo de uma hora.
AMDesignator	Define a cadeia que indica as horas da meia-noite até ao meio-dia num relógio de 12 horas.
PMDesignator	Define a cadeia que indica as horas do meio-dia à meia-noite num relógio de 12 horas.

Propriedade	Descrição
RFC1123Pattern	Define o formato da cadeia de resultados.
AbbreviatedDayNames	Define os nomes abreviados dos dias que podem aparecer na cadeia de resultados.
AbbreviatedMonthNames	Define os nomes abreviados do mês que podem aparecer na cadeia de resultados.

Propriedade	Descrição
MonthDayPattern	Define o formato geral da cadeia de resultados.
MonthNames	Define os nomes de mês localizados que podem aparecer na cadeia de resultados.

Propriedade	Descrição
YearMonthPattern	Define o formato geral da cadeia de resultados.
MonthNames	Define os nomes de mês localizados que podem aparecer na cadeia de resultados.

Cadeias de formato de data e hora padrão

Especificadores de tabela de formato

Como funcionam as cadeias de formato padrão

Formatos de data

O especificador do formato de data abreviada ("d")

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

Date and time formats (Formatos de data e hora)

O especificador de formato de data curta ("f") completo

O especificador de formato de longa duração da data completa ("F")

O especificador de formato de data curta ("g") geral

O especificador de formato de longa duração da data geral ("G")

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

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

O especificador de formato sortable ("s")

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

O especificador de formato completo universal ("U")

Formatos de tempo

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

O especificador de formato de longo tempo ("T")

Formatos de data parciais

O especificador do formato month ("M", "m")

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

definições de Painel de Controlo

Propriedades DateTimeFormatInfo

Ver também

Comentários

Recursos adicionais