Este artigo é parte integrante do Curso Online de C#, disponibilizado neste link:
O exemplos abaixo mostram as opções de formatação do tipo DateTime do C# utilizando o método String.Format. Estas opções também podem ser aplicadas através do método DateTime.ToString().
Formatos Customizados
São disponibilizados os seguintes formatos: y (ano), M (mês), d (dia), h (hora 12), H (hora 24), m (minuto), s (segundo), f (fração de segundo), F (fração de segundo com zeros omitidos), t (P.M ou A.M) e z (fuso horário).
O exemplos abaixo mostram o resultado de datas formatadas utilizando as opções acima:
// cria um objeto DateTime com o valor 2008-03-09 16:05:07.123 DateTime dt = new DateTime(2008, 3, 9, 16, 5, 7, 123); String.Format("{0:y yy yyy yyyy}", dt); // "8 08 008 2008" ano String.Format("{0:M MM MMM MMMM}", dt); // "3 03 Mar March" mês String.Format("{0:d dd ddd dddd}", dt); // "9 09 Sun Sunday" dia String.Format("{0:h hh H HH}", dt); // "4 04 16 16" hora 12/24 String.Format("{0:m mm}", dt); // "5 05" minuto String.Format("{0:s ss}", dt); // "7 07" segundo String.Format("{0:f ff fff ffff}", dt); // "1 12 123 1230" fração de segundo String.Format("{0:F FF FFF FFFF}", dt); // "1 12 123 123" com os zeros omitidos String.Format("{0:t tt}", dt); // "P PM" A.M. ou P.M. String.Format("{0:z zz zzz}", dt); // "-6 -06 -06:00" fuso horário |
Também é possível utilizar os separadores de data (/) e hora (:) na string. O padrão sugerido é o inglês, mas estes serão substituídos para o caracterer específico da cultura/idioma configurado no sistema operacional em execução. Estes podem ser obtidos diretamente através das propriedades DateTimeFormatInfo.DateSeparator e DateTimeFormatInfo.TimeSeparator, sob o namespace System.Globalization.
Exemplos:
// separador de data na cultura alemã é o "." // (ou seja, este será colocado no lugar no "/") String.Format("{0:d/M/yyyy HH:mm:ss}", dt); // "9/3/2008 16:05:07" - Inglês (en-US) String.Format("{0:d/M/yyyy HH:mm:ss}", dt); // "9.3.2008 16:05:07" - Alemão (de-DE) |
Outros exemplos de formatos customizados:
// dia/mês sem e com zeros String.Format("{0:d/M/yyyy}", dt); // "9/3/2009" String.Format("{0:dd/MM/yyyy}", dt); // "09/03/2009" // nomes de dia e mês String.Format("{0:ddd, MMM d, yyyy}", dt); // "Dom, Mar 9, 2009" String.Format("{0:dddd, d de MMMM de yyyy}", dt); // "Domingo, 9 de Março de 2009" // ano com 2 e 4 dígitos String.Format("{0:dd/MM/yy}", dt); // "09/03/09" String.Format("{0:dd/MM/yyyy}", dt); // "09/03/2009" |
Formatos Padrozinados para o DateTime
O DateTimeFormatInfo define formatos padrão para cada região/país. Por exemplo , a propriedade ShortTimePattern representa uma string que contém o valor h:mm tt para a cultura en-US culture, enquanto para a cultura de-DE o valor é HH:mm.
A tabela abaixo demonstra o padrões definidos para o tipo DateTimeFormatInfo e seus valores para a cultura en-US, que é a padrão do .NET Framework. A primeira coluna contém os “especificadores” para o método String.Format.
| Especificado | Propriededade do DateTimeFormatInfo | Valor padrão (en-US) |
|---|---|---|
t |
ShortTimePattern | h:mm tt |
d |
ShortDatePattern | M/d/yyyy |
T |
LongTimePattern | h:mm:ss tt |
D |
LongDatePattern | dddd, MMMM dd, yyyy |
f |
(combinação entre D e t) |
dddd, MMMM dd, yyyy h:mm tt |
F |
FullDateTimePattern | dddd, MMMM dd, yyyy h:mm:ss tt |
g |
(combinação de d e t) |
M/d/yyyy h:mm tt |
G |
(combinação de d e T) |
M/d/yyyy h:mm:ss tt |
m, M |
MonthDayPattern | MMMM dd |
y, Y |
YearMonthPattern | MMMM, yyyy |
r, 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' (*) |
| (*) = independe da cultura |
Os exemplos abaixo utilizam os especificadores padrão de formatação através do método String.Format e seus resultados, neste caso, para a cultura en-US. Lembrando que os mesmos especificadores podem ser utilizados com o método ToString().
String.Format("{0:t}", dt); // "4:05 PM" ShortTime String.Format("{0:d}", dt); // "3/9/2008" ShortDate String.Format("{0:T}", dt); // "4:05:07 PM" LongTime String.Format("{0:D}", dt); // "Sunday, March 09, 2008" LongDate String.Format("{0:f}", dt); // "Sunday, March 09, 2008 4:05 PM" LongDate+ShortTime String.Format("{0:F}", dt); // "Sunday, March 09, 2008 4:05:07 PM" FullDateTime String.Format("{0:g}", dt); // "3/9/2008 4:05 PM" ShortDate+ShortTime String.Format("{0:G}", dt); // "3/9/2008 4:05:07 PM" ShortDate+LongTime String.Format("{0:m}", dt); // "March 09" MonthDay String.Format("{0:y}", dt); // "March, 2008" YearMonth String.Format("{0:r}", dt); // "Sun, 09 Mar 2008 16:05:07 GMT" RFC1123 String.Format("{0:s}", dt); // "2008-03-09T16:05:07" SortableDateTime String.Format("{0:u}", dt); // "2008-03-09 16:05:07Z" UniversalSortableDateTime |
Efetuar os testes acima na cultura brasileira (pt-BR), o resultado será:
String.Format("{0:t}", dt); // "16:05" ShortTime String.Format("{0:d}", dt); // "9/3/2008" ShortDate String.Format("{0:T}", dt); // "16:05:07" LongTime String.Format("{0:D}", dt); // "domingo, 9 de março de 2008" LongDate String.Format("{0:f}", dt); // "domingo, 9 de março de 2008 16:05" LongDate+ShortTime String.Format("{0:F}", dt); // "domingo, 9 de março de 2008 16:05:07" FullDateTime String.Format("{0:g}", dt); // "9/3/2008 16:05" ShortDate+ShortTime String.Format("{0:G}", dt); // "9/3/2008 16:05:07" ShortDate+LongTime String.Format("{0:m}", dt); // "09 de março" MonthDay String.Format("{0:y}", dt); // "março de 2008" YearMonth String.Format("{0:r}", dt); // "Sun, 09 Mar 2008 16:05:07 GMT" RFC1123 String.Format("{0:s}", dt); // "2008-03-09T16:05:07" SortableDateTime String.Format("{0:u}", dt); // "2008-03-09 16:05:07Z" UniversalSortableDateTime |