Compartilhar via


Sequências de Caracteres de Formato Personalizado de Data e Hora

Uma sequência de formato personalizado de data e de hora definem a representação de texto de um valor DateTime ou de um valor DateTimeOffset que é produzido por uma operação de formatação.Sequências de caracteres de formato personalizado de data e hora consistem de um ou mais especificadores de formato personalizado de data e hora.Qualquer sequência que é não uma sequência de formato padrão de data e hora é interpretada como uma sequência de formato personalizado de data e hora.

Observação Sequências de formato padrão de data e hora podem ser usadas tanto com valores DateTime quanto com valores DateTimeOffset.

Especificadores de formato padrão de data e hora

A tabela a seguir descreve os especificadores de formato padrão de data e hora.A não ser que seja notado o contrário, um determinado especificador de formato padrão de data e hora produz uma representação de sequência de caracteres idêntica independente de ela ser usada com um valor DateTime ou um valor DateTimeOffset.

Especificador de Formato

Descrição

d

Representa o dia do mês sistema autônomo um número de 1 a 31.Um dia de dígito é formatado sem um zero entrelinhamento.Para obter mais informações sobre como usar um único especificador de formato personalizado, consulte Usando especificadores únicos de formato personalizado.

O exemplo a seguir inclui o especificador d de formato personalizado em várias sequências formato.

Dim date1 As Date = #08/29/2008 7:27:15PM#
Console.WriteLine(date1.ToString("d, M", _
CultureInfo.InvariantCulture))
' Displays 29, 8
Console.WriteLine(date1.ToString("d MMMM", _
CultureInfo.CreateSpecificCulture("en-US")))
' Displays 29 August
Console.WriteLine(date1.ToString("d MMMM", _
CultureInfo.CreateSpecificCulture("es-MX")))
' Displays 29 agosto
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15);
Console.WriteLine(date1.ToString("d, M",
CultureInfo.InvariantCulture));
// Displays 29, 8
Console.WriteLine(date1.ToString("d MMMM",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays 29 August
Console.WriteLine(date1.ToString("d MMMM",
CultureInfo.CreateSpecificCulture("es-MX")));
// Displays 29 agosto

dd

Representa o dia do mês sistema autônomo um número de 01 a 31.Um dia de dígito é formatado com um zero entrelinhamento.O exemplo a seguir inclui o especificador dd de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date = #1/2/2008 6:30:15AM#
Console.WriteLine(date1.ToString("dd, MM", _
CultureInfo.InvariantCulture))
' 02, 01
DateTime date1 = new DateTime(2008, 1, 2, 6, 30, 15);
Console.WriteLine(date1.ToString("dd, MM",
CultureInfo.InvariantCulture));
// 02, 01

ddd

Representa o nome abreviado do dia da semana, conforme definido na propriedade DateTimeFormatInfo.AbbreviatedDayNames atual.O exemplo a seguir inclui o especificador ddd de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date = #08/29/2008 7:27:15PM#
Console.WriteLine(date1.ToString("ddd d MMM", _
CultureInfo.CreateSpecificCulture("en-US")))
' Displays Fri 29 Aug
Console.WriteLine(date1.ToString("ddd d MMM", _
CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays ven. 29 aot
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15);
Console.WriteLine(date1.ToString("ddd d MMM",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays Fri 29 Aug
Console.WriteLine(date1.ToString("ddd d MMM",
CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays ven. 29 aot

dddd (mais qualquer número de especificadores d adicionais)

Representa o nome abreviado do dia da semana, conforme definido na propriedade DateTimeFormatInfo.DayNames atual.O exemplo a seguir inclui o especificador dddd de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date = #08/29/2008 7:27:15PM#
Console.WriteLine(date1.ToString("dddd dd MMMM", _
CultureInfo.CreateSpecificCulture("en-US")))
' Displays Friday 29 August
Console.WriteLine(date1.ToString("dddd dd MMMM", _
CultureInfo.CreateSpecificCulture("it-IT")))
' Displays venerd 29 agosto
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15);
Console.WriteLine(date1.ToString("dddd dd MMMM",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays Friday 29 August
Console.WriteLine(date1.ToString("dddd dd MMMM",
CultureInfo.CreateSpecificCulture("it-IT")));
// Displays venerd 29 agosto

-F-

Representa o dígito mais significativo da fração de segundos; ou seja, ele representa os décimos de segundo em um valor de data e tempo.

Se o especificador f de formato for usado sem outros especificadores de formato, ele é interpretado como o especificador padrão f de formato de data e hora.Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato único personalizado.

Quando usado como parte de uma sequência de formato fornecida para os métodos ParseExact, TryParseExact, ParseExact, ou TryParseExact, o número de especificadores f de formato usados indica o número de dígitos significativos da fração de segundos que deve estar presente para analisar a sequência de caracteres com sucesso.

O exemplo a seguir inclui o especificador f de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018

ff

Representa os dois dígitos mais significativos da fração de segundos; ou seja, ele representa os centésimos de segundo em um valor de data e tempo.O exemplo a seguir inclui o especificador ff de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018

fff

Representa os três dígitos mais significativos da fração de segundos; ou seja, ele representa os milissegundos em um valor de data e tempo.O exemplo a seguir inclui o especificador fff de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018

ffff

Representa os quatro dígitos mais significativos da fração de segundos; ou seja, ele representa as dezenas de milésimos de segundo em um valor de data e tempo.

Embora seja possível exibir as dezenas de milésimos de um componente de segundos de um valor de tempo, esse valor pode não ser significativo.A precisão dos valores de data e hora dependem da resolução em relação ao relógio do sistema.No Windows NT 3.5 e versões posteriores, e sistemas operacionais do Windows Vista, a resolução do relógio é de aproximadamente 10 a 15 milissegundos.

fffff

Representa os cinco dígitos mais significativos da fração de segundos; ou seja, ele representa as centenas de milésimos de segundo em um valor de data e tempo.

Embora seja possível exibir as centenas de milésimos de um componente de segundos de um valor de tempo, esse valor pode não ser significativo.A precisão dos valores de data e hora dependem da resolução em relação ao relógio do sistema.No Windows NT 3.5 e versões posteriores, e sistemas operacionais do Windows Vista, a resolução do relógio é de aproximadamente 10 a 15 milissegundos.

ffffff

Representa os seis dígitos mais significativos da fração de segundos; ou seja, ele representa os milionésimos de segundo em um valor de data e tempo.

Embora seja possível exibir os milionésimos de um componente de segundos de um valor de tempo, esse valor pode não ser significativo.A precisão dos valores de data e hora dependem da resolução em relação ao relógio do sistema.No Windows NT 3.5 e versões posteriores, e sistemas operacionais do Windows Vista, a resolução do relógio é de aproximadamente 10 a 15 milissegundos.

fffffff

Representa os sete dígitos mais significativos da fração de segundos; ou seja, ele representa as dezenas de milionésimos de segundo em um valor de data e tempo.

Embora seja possível exibir as dezenas milionésimos de um componente de segundos de um valor de tempo, esse valor pode não ser significativo.A precisão dos valores de data e hora dependem da resolução em relação ao relógio do sistema.No Windows NT 3.5 e versões posteriores, e sistemas operacionais do Windows Vista, a resolução do relógio é de aproximadamente 10 a 15 milissegundos.

F

Representa o dígito mais significativo da fração de segundos; ou seja, ele representa os décimos de segundo em um valor de data e tempo.Nada será exibido se o dígito for zero.

Se o especificador F de formato for usado sem outros especificadores de formato, ele é interpretado como o especificador F de formato padrão de data e hora.Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato único personalizado.

O número de especificadores F de formato usados com os métodos ParseExact, TryParseExact, ParseExact, ou o TryParseExact indica o número máximo de dígitos significativos da fração de segundos que podem estar presentes para que a análise da sequência de caracteres seja feita com êxito.

O exemplo a seguir inclui o especificador F de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018

FF

Representa os dois dígitos mais significativos da fração de segundos; ou seja, ele representa os centésimos de segundo em um valor de data e tempo.No entanto, zeros à direita ou dois dígitos de zero não são exibidos.O exemplo a seguir inclui o especificador FF de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018

FFF

Representa os três dígitos mais significativos da fração de segundos; ou seja, ele representa os milissegundos em um valor de data e tempo.No entanto, zeros à direita ou três dígitos de zero não são exibidos.O exemplo a seguir inclui o especificador FF de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018

FFFF

Representa os quatro dígitos mais significativos da fração de segundos; ou seja, ele representa as dezenas de milésimos de segundo em um valor de data e tempo.No entanto, zeros à direita ou quatro dígitos de zero não são exibidos.

Embora seja possível exibir as dezenas de milésimos de um componente de segundos de um valor de tempo, esse valor pode não ser significativo.A precisão dos valores de data e hora dependem da resolução em relação ao relógio do sistema.No Windows NT 3.5 e versões posteriores, e sistemas operacionais do Windows Vista, a resolução do relógio é de aproximadamente 10 a 15 milissegundos.

FFFFF

Representa os cinco dígitos mais significativos da fração de segundos; ou seja, ele representa as centenas de milésimos de segundo em um valor de data e tempo.No entanto, zeros à direita ou cinco dígitos de zero não são exibidos.

Embora seja possível exibir as centenas de milésimos de um componente de segundos de um valor de tempo, esse valor pode não ser significativo.A precisão dos valores de data e hora dependem da resolução em relação ao relógio do sistema.No Windows NT 3.5 e versões posteriores, e sistemas operacionais do Windows Vista, a resolução do relógio é de aproximadamente 10 a 15 milissegundos.

FFFFFF

Representa os seis dígitos mais significativos da fração de segundos; ou seja, ele representa os milionésimos de segundo em um valor de data e tempo.No entanto, zeros à direita ou seis dígitos de zero não são exibidos.

Embora seja possível exibir os milionésimos de um componente de segundos de um valor de tempo, esse valor pode não ser significativo.A precisão dos valores de data e hora dependem da resolução em relação ao relógio do sistema.No Windows NT 3.5 e versões posteriores, e sistemas operacionais do Windows Vista, a resolução do relógio é de aproximadamente 10 a 15 milissegundos.

FFFFFFF

Representa os sete dígitos mais significativos da fração de segundos; ou seja, ele representa as dezenas de milionésimos de segundo em um valor de data e tempo.No entanto, zeros à direita ou sete dígitos de zero não são exibidos.

Embora seja possível exibir as dezenas milionésimos de um componente de segundos de um valor de tempo, esse valor pode não ser significativo.A precisão dos valores de data e hora dependem da resolução em relação ao relógio do sistema.No Windows NT 3.5 e versões posteriores, e sistemas operacionais do Windows Vista, a resolução do relógio é de aproximadamente 10 a 15 milissegundos.

g, gg (mais qualquer número de especificadores g adicionais)

Representa o período ou era, por exemplo, d.c.Formatação ignora este especificador se a data a ser formatada não tem um período associado ou uma seqüência era.Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato único personalizado.

O exemplo a seguir inclui o especificador g de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date = #08/04/0070#
Console.WriteLine(date1.ToString("MM/dd/yyyy g", _
CultureInfo.InvariantCulture))
' Displays 08/04/0070 A.D.
Console.WriteLine(date1.ToString("MM/dd/yyyy g", _
CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays 08/04/0070 ap. J.-C.
DateTime date1 = new DateTime(70, 08, 04);
Console.WriteLine(date1.ToString("MM/dd/yyyy g",
CultureInfo.InvariantCulture));
// Displays 08/04/0070 A.D.
Console.WriteLine(date1.ToString("MM/dd/yyyy g",
CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays 08/04/0070 ap. J.-C.

h

Representa a hora como um número de 1 a 12, ou seja, a hora conforme é representada por um relógio de 12 horas que conta todas as horas a partir da meia-noite ou do meio-dia.Uma hora específica após a meia-noite é indistinguível da mesma hora depois do meio-dia.A hora não é arredondada, e uma hora de dígito único é formatada sem um zero à esquerda.Por exemplo, dado um tempo de 5:43, este especificador de formato personalizado exibe "5".Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato único personalizado.

O exemplo a seguir inclui o especificador h de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5

hh, hh (mais qualquer número de especificadores h adicionais)

Representa a hora como um número de 01 a 12, ou seja, a hora conforme é representada por um relógio de 12 horas que conta todas as horas a partir da meia-noite ou do meio-dia.Uma hora específica após a meia-noite é indistinguível da mesma hora depois do meio-dia.A hora não é arredondada, e uma hora de dígito único é formatada com um zero à esquerda.Por exemplo, dado um tempo de 5:43, este especificador de formato personalizado exibe "05".

O exemplo a seguir inclui o especificador hh de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.

H

Representa a hora como um número de 0 a 23, ou seja, a hora conforme é representada por um relógio de 24 horas que conta todas as horas a partir da meia-noite.Uma hora de dígito único é formatada sem um zero à esquerda.

Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato único personalizado.

O exemplo a seguir inclui o especificador H de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date = #6:09:01AM#
Console.WriteLine(date1.ToString("H:mm:ss", _
CultureInfo.InvariantCulture))
' Displays 6:09:01
DateTime date1 = new DateTime(2008, 1, 1, 6, 9, 1);
Console.WriteLine(date1.ToString("H:mm:ss",
CultureInfo.InvariantCulture));
// Displays 6:09:01

HH, HH (mais qualquer número de especificadores H adicionais)

Representa a hora como um número de 00 a 23, ou seja, a hora conforme é representada por um relógio de 24 horas que conta todas as horas a partir da meia-noite.Uma hora de dígito único é formatada sem um zero à esquerda.O exemplo a seguir inclui o especificador HH de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date = #6:09:01AM#
Console.WriteLine(date1.ToString("HH:mm:ss", _
CultureInfo.InvariantCulture))
' Displays 06:09:01
DateTime date1 = new DateTime(2008, 1, 1, 6, 9, 1);
Console.WriteLine(date1.ToString("HH:mm:ss",
CultureInfo.InvariantCulture));
// Displays 06:09:01

K

Representa as informações de zona de tempo de um valor de data e hora.Quando usado com valores DateTime, a sequência de resultado é definida pelo valor da propriedade DateTime.Kind.Para zona de tempo local (um valor da propriedade DateTime.Kind de DateTimeKind.Local), esse especificador é equivalente ao especificador zzz e produz uma sequência de resultado contendo o deslocamento local do Tempo Universal Coordenado (UTC); por exemplo, "-07: 00".Para uma hora do UTC (um valor da propriedade DateTime.Kind de DateTimeKind.Utc), a sequência de resultado inclui um caractere "Z" para representar uma data UTC.Para uma hora de uma zona de tempo não especificada (uma hora cuja propriedade DateTime.Kind é igual a DateTimeKind.Unspecified, o resultado é equivalente a String.Empty.Para valores DateTimeOffset, o especificador de formato K é equivalente ao especificador ZZ de formato, e produz uma sequência de resultado contendo o deslocamento do valor DateTimeOffset do UTC.

Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato único personalizado.

O exemplo a seguir exibe a seqüência resultante do usando o especificador de formato personalizado K com vários DateTime e DateTimeOffset valores em um sistema dos EUA Padrão do Pacífico time zona.

Console.WriteLine(Date.Now.ToString("%K"))
' Displays -07:00
Console.WriteLine(Date.UtcNow.ToString("%K"))
' Displays Z
Console.WriteLine("'{0}'", _
Date.SpecifyKind(Date.Now, _
DateTimeKind.Unspecified). _
ToString("%K"))
' Displays ''
Console.WriteLine(DateTimeOffset.Now.ToString("%K"))
' Displays -07:00
Console.WriteLine(DateTimeOffset.UtcNow.ToString("%K"))
' Displays +00:00
Console.WriteLine(New DateTimeOffset(2008, 5, 1, 6, 30, 0, _
New TimeSpan(5, 0, 0)). _
ToString("%K"))
' Displays +05:00
Console.WriteLine(DateTime.Now.ToString("%K"));
// Displays -07:00
Console.WriteLine(DateTime.UtcNow.ToString("%K"));
// Displays Z
Console.WriteLine("'{0}'",
DateTime.SpecifyKind(DateTime.Now,
DateTimeKind.Unspecified).ToString("%K"));
// Displays ''
Console.WriteLine(DateTimeOffset.Now.ToString("%K"));
// Displays -07:00
Console.WriteLine(DateTimeOffset.UtcNow.ToString("%K"));
// Displays +00:00
Console.WriteLine(new DateTimeOffset(2008, 5, 1, 6, 30, 0,
new TimeSpan(5, 0, 0)).ToString("%K"));
// Displays +05:00

m

Representa o minuto sistema autônomo um número de 0 a 59.O minuto representa todo minutos que se passaram desde a última hora.Uma hora de dígito único é formatada sem um zero à esquerda.Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato único personalizado.O exemplo a seguir inclui o especificador m de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5

mm, mm (mais qualquer número de especificadores adicionais m)

Representa o minuto sistema autônomo um número de 00 a 59.O minuto representa todo minutos que se passaram desde a última hora.Uma hora de dígito único é formatada com um zero à esquerda.O exemplo a seguir inclui o especificador mm de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.

M

Representa o mês sistema autônomo um número de 1 a 12.Um mês de dígito é formatado sem um zero entrelinhamento.Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato único personalizado.O exemplo a seguir inclui o especificador M de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date = #8/18/2008#
Console.WriteLine(date1.ToString("(M) MMM, MMMM", _
CultureInfo.CreateSpecificCulture("en-US")))
' Displays (8) Aug, August
Console.WriteLine(date1.ToString("(M) MMM, MMMM", _
CultureInfo.CreateSpecificCulture("nl-NL")))
' Displays (8) aug, augustus
Console.WriteLine(date1.ToString("(M) MMM, MMMM", _
CultureInfo.CreateSpecificCulture("lv-LV")))
' Displays (8) Aug, augusts
DateTime date1 = new DateTime(2008, 8, 18);
Console.WriteLine(date1.ToString("(M) MMM, MMMM",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays (8) Aug, August
Console.WriteLine(date1.ToString("(M) MMM, MMMM",
CultureInfo.CreateSpecificCulture("nl-NL")));
// Displays (8) aug, augustus
Console.WriteLine(date1.ToString("(M) MMM, MMMM",
CultureInfo.CreateSpecificCulture("lv-LV")));
// Displays (8) Aug, augusts

MM

Representa o mês sistema autônomo um número de 01 a 12.Um mês de dígito é formatado com um zero entrelinhamento.O exemplo a seguir inclui o especificador MM de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date = #1/2/2008 6:30:15AM#
Console.WriteLine(date1.ToString("dd, MM", _
CultureInfo.InvariantCulture))
' 02, 01
DateTime date1 = new DateTime(2008, 1, 2, 6, 30, 15);
Console.WriteLine(date1.ToString("dd, MM",
CultureInfo.InvariantCulture));
// 02, 01

MMM

Representa o nome abreviado do mês, conforme definido na propriedade DateTimeFormatInfo.AbbreviatedMonthNames atual.O exemplo a seguir inclui o especificador MMM de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date = #08/29/2008 7:27:15PM#
Console.WriteLine(date1.ToString("ddd d MMM", _
CultureInfo.CreateSpecificCulture("en-US")))
' Displays Fri 29 Aug
Console.WriteLine(date1.ToString("ddd d MMM", _
CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays ven. 29 aot
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15);
Console.WriteLine(date1.ToString("ddd d MMM",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays Fri 29 Aug
Console.WriteLine(date1.ToString("ddd d MMM",
CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays ven. 29 aot

MMMM

Representa o nome completo do mês, conforme definido na propriedade DateTimeFormatInfo.MonthNames atual.O exemplo a seguir inclui o especificador MMMM de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date = #08/29/2008 7:27:15PM#
Console.WriteLine(date1.ToString("dddd dd MMMM", _
CultureInfo.CreateSpecificCulture("en-US")))
' Displays Friday 29 August
Console.WriteLine(date1.ToString("dddd dd MMMM", _
CultureInfo.CreateSpecificCulture("it-IT")))
' Displays venerd 29 agosto
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15);
Console.WriteLine(date1.ToString("dddd dd MMMM",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays Friday 29 August
Console.WriteLine(date1.ToString("dddd dd MMMM",
CultureInfo.CreateSpecificCulture("it-IT")));
// Displays venerd 29 agosto

s

Representa sistema autônomo segundos sistema autônomo um número de 0 a 59.O resultado representa todo os segundos que se passaram desde o último minuto.Um segundo de dígito único é formatado sem um zero à esquerda.Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato único personalizado.O exemplo a seguir inclui o especificador de formato personalizado s em uma seqüência de caracteres de formato personalizado.

Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5

ss, ss (mais qualquer número de especificadores s adicionais)

Representa sistema autônomo segundos sistema autônomo um número de 00 a 59.O resultado representa todo os segundos que se passaram desde o último minuto.Um segundo de dígito único é formatado sem um zero à esquerda.O exemplo a seguir inclui o especificador ss de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.

t

Representa o primeiro caractere do designador AM/PM definido na atual propriedade DateTimeFormatInfo.AMDesignator ou DateTimeFormatInfo.PMDesignator.Designador AM é usado se a time no horário que está sendo formatado é menor que 12.Caso contrário, será usado o designador PM.Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato único personalizado.

O exemplo a seguir inclui o especificador t de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5

tt, tt (mais qualquer número de especificadores t adicionais)

Representa o designador AM/PM, conforme definido na atual propriedade DateTimeFormatInfo.AMDesignator ou DateTimeFormatInfo.PMDesignator.Designador AM é usado se a time no horário que está sendo formatado é menor que 12.Caso contrário, será usado o designador PM.

Seu aplicativo deve estar certo de usar o especificador tt em linguagens para as quais é necessário manter a distinção entre AM e PM.Um exemplo é Japonês, para o qual os designadores AM e PM diferem no segundo caractere, em vez do primeiro caractere.

O exemplo a seguir inclui o especificador tt de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.

y

Representa o ano como um número de um ou dois dígitos.Se o ano tem mais de dois dígitos, somente os dois dígitos de ordem baixa aparecerão no resultado.Se o primeiro dígito de um ano de dois dígitos começa com um zero (por exemplo, de 2008), o número será formatado sem um zero à esquerda.Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato único personalizado.

O exemplo a seguir inclui o especificador y de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date = #12/1/0001#
Dim date2 As Date = #1/1/2010#
Console.WriteLine(date1.ToString("%y"))
' Displays 1
Console.WriteLine(date1.ToString("yy"))
' Displays 01
Console.WriteLine(date1.ToString("yyy"))
' Displays 001
Console.WriteLine(date1.ToString("yyyy"))
' Displays 0001
Console.WriteLine(date1.ToString("yyyyy"))
' Displays 00001
Console.WriteLine(date2.ToString("%y"))
' Displays 10
Console.WriteLine(date2.ToString("yy"))
' Displays 10
Console.WriteLine(date2.ToString("yyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyyy"))
' Displays 02010
DateTime date1 = new DateTime(1, 12, 1);
DateTime date2 = new DateTime(2010, 1, 1);
Console.WriteLine(date1.ToString("%y"));
// Displays 1
Console.WriteLine(date1.ToString("yy"));
// Displays 01
Console.WriteLine(date1.ToString("yyy"));
// Displays 001
Console.WriteLine(date1.ToString("yyyy"));
// Displays 0001
Console.WriteLine(date1.ToString("yyyyy"));
// Displays 00001
Console.WriteLine(date2.ToString("%y"));
// Displays 10
Console.WriteLine(date2.ToString("yy"));
// Displays 10
Console.WriteLine(date2.ToString("yyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyyy"));
// Displays 02010

yy

Representa o ano como um número de um ou dois dígitos.Se o ano tem mais de dois dígitos, somente os dois dígitos de ordem baixa aparecerão no resultado.Se o ano de dois dígitos tiver menos de dois dígitos significativos, o número é preenchido com zeros à esquerda para atingir dois dígitos.

O exemplo a seguir inclui o especificador yy de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date = #12/1/0001#
Dim date2 As Date = #1/1/2010#
Console.WriteLine(date1.ToString("%y"))
' Displays 1
Console.WriteLine(date1.ToString("yy"))
' Displays 01
Console.WriteLine(date1.ToString("yyy"))
' Displays 001
Console.WriteLine(date1.ToString("yyyy"))
' Displays 0001
Console.WriteLine(date1.ToString("yyyyy"))
' Displays 00001
Console.WriteLine(date2.ToString("%y"))
' Displays 10
Console.WriteLine(date2.ToString("yy"))
' Displays 10
Console.WriteLine(date2.ToString("yyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyyy"))
' Displays 02010
DateTime date1 = new DateTime(1, 12, 1);
DateTime date2 = new DateTime(2010, 1, 1);
Console.WriteLine(date1.ToString("%y"));
// Displays 1
Console.WriteLine(date1.ToString("yy"));
// Displays 01
Console.WriteLine(date1.ToString("yyy"));
// Displays 001
Console.WriteLine(date1.ToString("yyyy"));
// Displays 0001
Console.WriteLine(date1.ToString("yyyyy"));
// Displays 00001
Console.WriteLine(date2.ToString("%y"));
// Displays 10
Console.WriteLine(date2.ToString("yy"));
// Displays 10
Console.WriteLine(date2.ToString("yyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyyy"));
// Displays 02010

yyy

Representa o ano com um mínimo de três dígitos.Se o ano tem mais de três dígitos significativos, eles serão incluídos na sequência de resultado.Se o ano tem menos de três dígitos, o número é preenchido com zeros à esquerda para atingir três dígitos.

Observe que para o calendário budista tailandês, que pode ter anos de cinco dígitos, este especificador de formato exibe todos os cinco dígitos.

O exemplo a seguir inclui o especificador yyy de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date = #12/1/0001#
Dim date2 As Date = #1/1/2010#
Console.WriteLine(date1.ToString("%y"))
' Displays 1
Console.WriteLine(date1.ToString("yy"))
' Displays 01
Console.WriteLine(date1.ToString("yyy"))
' Displays 001
Console.WriteLine(date1.ToString("yyyy"))
' Displays 0001
Console.WriteLine(date1.ToString("yyyyy"))
' Displays 00001
Console.WriteLine(date2.ToString("%y"))
' Displays 10
Console.WriteLine(date2.ToString("yy"))
' Displays 10
Console.WriteLine(date2.ToString("yyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyyy"))
' Displays 02010
DateTime date1 = new DateTime(1, 12, 1);
DateTime date2 = new DateTime(2010, 1, 1);
Console.WriteLine(date1.ToString("%y"));
// Displays 1
Console.WriteLine(date1.ToString("yy"));
// Displays 01
Console.WriteLine(date1.ToString("yyy"));
// Displays 001
Console.WriteLine(date1.ToString("yyyy"));
// Displays 0001
Console.WriteLine(date1.ToString("yyyyy"));
// Displays 00001
Console.WriteLine(date2.ToString("%y"));
// Displays 10
Console.WriteLine(date2.ToString("yy"));
// Displays 10
Console.WriteLine(date2.ToString("yyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyyy"));
// Displays 02010

yyyy

Representa o ano como um número de quatro dígitos.Se o ano tem mais de quatro dígitos, somente os quatro dígitos de ordem baixa aparecerão no resultado.Se o ano tem menos de quatro dígitos, o número é preenchido com zeros à esquerda para atingir quatro dígitos.

Observe que para o calendário budista tailandês, que pode ter anos de cinco dígitos, este especificador de formato exibe todos os cinco dígitos.

O exemplo a seguir inclui o especificador yyyy de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date = #12/1/0001#
Dim date2 As Date = #1/1/2010#
Console.WriteLine(date1.ToString("%y"))
' Displays 1
Console.WriteLine(date1.ToString("yy"))
' Displays 01
Console.WriteLine(date1.ToString("yyy"))
' Displays 001
Console.WriteLine(date1.ToString("yyyy"))
' Displays 0001
Console.WriteLine(date1.ToString("yyyyy"))
' Displays 00001
Console.WriteLine(date2.ToString("%y"))
' Displays 10
Console.WriteLine(date2.ToString("yy"))
' Displays 10
Console.WriteLine(date2.ToString("yyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyyy"))
' Displays 02010
DateTime date1 = new DateTime(1, 12, 1);
DateTime date2 = new DateTime(2010, 1, 1);
Console.WriteLine(date1.ToString("%y"));
// Displays 1
Console.WriteLine(date1.ToString("yy"));
// Displays 01
Console.WriteLine(date1.ToString("yyy"));
// Displays 001
Console.WriteLine(date1.ToString("yyyy"));
// Displays 0001
Console.WriteLine(date1.ToString("yyyyy"));
// Displays 00001
Console.WriteLine(date2.ToString("%y"));
// Displays 10
Console.WriteLine(date2.ToString("yy"));
// Displays 10
Console.WriteLine(date2.ToString("yyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyyy"));
// Displays 02010

yyyyy (mais qualquer número de especificadores y adicionais)

Representa o ano como um número de cinco dígitos.Se o ano tem mais de cinco dígitos, somente os cinco dígitos de ordem baixa aparecerão no resultado.Se o ano tem menos de cinco dígitos, o número é preenchido com zeros à esquerda para atingir cinco dígitos.

Se houver especificadores y adicionais, o número é preenchido com tantos zeros à esquerda conforme necessário para atingir o número de especificadores y.

O exemplo a seguir inclui o especificador yyyyy de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date = #12/1/0001#
Dim date2 As Date = #1/1/2010#
Console.WriteLine(date1.ToString("%y"))
' Displays 1
Console.WriteLine(date1.ToString("yy"))
' Displays 01
Console.WriteLine(date1.ToString("yyy"))
' Displays 001
Console.WriteLine(date1.ToString("yyyy"))
' Displays 0001
Console.WriteLine(date1.ToString("yyyyy"))
' Displays 00001
Console.WriteLine(date2.ToString("%y"))
' Displays 10
Console.WriteLine(date2.ToString("yy"))
' Displays 10
Console.WriteLine(date2.ToString("yyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyyy"))
' Displays 02010
DateTime date1 = new DateTime(1, 12, 1);
DateTime date2 = new DateTime(2010, 1, 1);
Console.WriteLine(date1.ToString("%y"));
// Displays 1
Console.WriteLine(date1.ToString("yy"));
// Displays 01
Console.WriteLine(date1.ToString("yyy"));
// Displays 001
Console.WriteLine(date1.ToString("yyyy"));
// Displays 0001
Console.WriteLine(date1.ToString("yyyyy"));
// Displays 00001
Console.WriteLine(date2.ToString("%y"));
// Displays 10
Console.WriteLine(date2.ToString("yy"));
// Displays 10
Console.WriteLine(date2.ToString("yyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyyy"));
// Displays 02010

z

Com valores DateTime, representa o deslocamento assinado da zona de tempo do sistema operacional local do Tempo Universal Coordenado (UTC), medido em horas.Ele não reflete o valor de uma instância da propriedade Kind.Por esse motivo, o especificador de formato z não é recomendado para uso com valores DateTime.

Com valores DateTimeOffset, representa o deslocamento do valor DateTimeOffset do UTC em horas.

O deslocamento é sempre exibido com um sinal à esquerda.Um sinal de adição (+) indica horas depois e um sinal de subtração (-) indica horas antes do UTC.O deslocamento varia de –12 a +13.Um deslocamento de dígito é formatado sem um zero entrelinhamento.Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato único personalizado.O exemplo a seguir inclui o especificador z de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date = Date.UtcNow
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date1))
' Displays -7, -07, -07:00
Dim date2 As New DateTimeOffset(2008, 8, 1, 0, 0, 0, _
New Timespan(6, 0, 0))
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date2))
' Displays +6, +06, +06:00
DateTime date1 = DateTime.UtcNow;
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date1));
// Displays -7, -07, -07:00
DateTimeOffset date2 = new DateTimeOffset(2008, 8, 1, 0, 0, 0,
new TimeSpan(6, 0, 0));
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date2));
// Displays +6, +06, +06:00

zz

Com valores DateTime, representa o deslocamento assinado da zona de tempo do sistema operacional local do Tempo Universal Coordenado (UTC), medido em horas.Ele não reflete o valor de uma instância da propriedade Kind.Por esse motivo, o especificador de formato zz não é recomendado para uso com valores DateTime.

Com valores DateTimeOffset, representa o deslocamento do valor DateTimeOffset do UTC em horas.

O deslocamento é sempre exibido com um sinal à esquerda.Um sinal de adição (+) indica horas depois e um sinal de subtração (-) indica horas antes do UTC.O deslocamento varia de –12 a +13.Um deslocamento de dígito é formatado com um zero entrelinhamento.O exemplo a seguir inclui o especificador zz de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date = Date.UtcNow
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date1))
' Displays -7, -07, -07:00
Dim date2 As New DateTimeOffset(2008, 8, 1, 0, 0, 0, _
New Timespan(6, 0, 0))
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date2))
' Displays +6, +06, +06:00
DateTime date1 = DateTime.UtcNow;
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date1));
// Displays -7, -07, -07:00
DateTimeOffset date2 = new DateTimeOffset(2008, 8, 1, 0, 0, 0,
new TimeSpan(6, 0, 0));
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date2));
// Displays +6, +06, +06:00

zzz, zzz (mais qualquer número de especificadores z adicionais)

Com valores DateTime, representa o deslocamento assinado da zona de tempo do sistema operacional local do Tempo Universal Coordenado (UTC), medido em horas.Ele não reflete o valor de uma instância da propriedade Kind.Por esse motivo, o especificador de formato zzz não é recomendado para uso com valores DateTime.

Com valores DateTimeOffset, representa o deslocamento do valor DateTimeOffset do UTC em horas.

O deslocamento é sempre exibido com um sinal à esquerda.Um sinal de adição (+) indica horas depois e um sinal de subtração (-) indica horas antes do UTC.O deslocamento varia de –12 a +13.Um deslocamento de dígito é formatado com um zero entrelinhamento.O exemplo a seguir inclui o especificador zzz de formato personalizado em uma sequência de caracteres de formato personalizado.

Dim date1 As Date = Date.UtcNow
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date1))
' Displays -7, -07, -07:00
Dim date2 As New DateTimeOffset(2008, 8, 1, 0, 0, 0, _
New Timespan(6, 0, 0))
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date2))
' Displays +6, +06, +06:00
DateTime date1 = DateTime.UtcNow;
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date1));
// Displays -7, -07, -07:00
DateTimeOffset date2 = new DateTimeOffset(2008, 8, 1, 0, 0, 0,
new TimeSpan(6, 0, 0));
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date2));
// Displays +6, +06, +06:00

:

Representa o separador de hora definido na propriedade DateTimeFormatInfo.TimeSeparator atual.Esse separador é usado para diferenciar horas, minutos e segundos.

/

Representa o separador de hora definido na propriedade DateTimeFormatInfo.DateSeparator atual.Esse separador é usado para diferenciar anos, meses e dias.

"

Representa uma sequência de caracteres entre aspas.Exibe o valor literal de qualquer sequência de caracteres entre as duas aspas (").O aplicativo deve preceder cada aspas com um caractere de escape (\).

'

Representa uma sequência de caracteres entre aspas (apóstrofe).Exibe o valor literal de qualquer sequência de caracteres entre dois caracteres de apóstrofe (').

%c

Representa o resultado associado com um especificador c de formato personalizado, quando a sequência de formato personalizado de data e hora consiste exclusivamente daquele especificador de formato personalizado.Ou seja, para usar a d, f, F, h, m, s, t, y, z, H ou personalizado M Formatar especificador por si só, o aplicativo deve especificar % d, % f, F %, % h, % m, % s, % t, % y, z %, % H ou % M.Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato único personalizado.

\c

Representa o caractere de escape e exibe o caractere " c " como um literal quando esse caractere é precedido pelo caractere de escape (\).Para inserir o próprio caractere de barra invertida na sequência de resultado, o aplicativo deve usar dois caracteres de escape ("\\").

Qualquer outro caractere

Copia qualquer outro caractere para o sequência de resultado, sem afetar a formatação.

Configurações do Painel de controle

As configurações de opção regionais e de idioma no Painel de controle influenciam a sequência de resultado produzida por uma operação de formatação que inclui muitos dos especificadores de formato personalizado de data e hora.Essas configurações são usadas para inicializar o objeto DateTimeFormatInfo associado a cultura de segmento atual, que fornece os valores que determinam a formatação.Computadores com configurações diferentes geram diferentes sequências de caracteres como resultado.

Além disso, se o construtor 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.O método CreateSpecificCulture pode ser usado para criar um objeto CultureInfo que não reflita personalizações de um sistema.

Propriedades DateTimeFormatInfo

A formatação é influenciada pelas propriedades do objeto DateTimeFormatInfo atual, que é fornecido implicitamente pela cultura de segmento atual ou explicitamente pelo parâmetro IFormatProvider do método que invoca a formatação.O aplicativo deve especificar para o parâmetro IFormatProvider um objeto CultureInfo, que representa uma cultura, ou um objeto DateTimeFormatInfo.

A sequência de resultado produzido por muitos dos especificadores de formato personalizado de data e hora dependem das propriedades do objeto DateTimeFormatInfo atual.O aplicativo pode alterar o resultado produzido por alguns especificadores de formato personalizado de data e hora alterando a propriedade DateTimeFormatInfo correspondente.Por exemplo, o especificador de formato ddd adiciona um nome abreviado do dia da semana na matriz de sequência de caracteres AbbreviatedDayNames para a sequência de resultado.Da mesma forma, o especificador de formato MMMM adiciona um nome completo do mês na matriz de sequências de caracteres MonthNames para a sequência de resultado.

Usando especificadores de formato único personalizado

Uma sequência de formato personalizado de data e hora consiste de dois ou mais caracteres.Por exemplo, se a sequência de caracteres de formato consiste somente do especificador h, a sequência de caracteres de formato é interpretada como um especificador de formato padrão de data e hora.No entanto, nesse caso específico, uma exceção é lançada porque não há nenhum h data padrão e o time especificador de formato.

Para usar um especificador de formato único personalizado de data e hora, inclua um espaço antes ou após do especificador de data e hora, ou inclua uma especificador de formato de percentagem (%) antes do especificador de formato único personalizado de data e hora.Por exemplo, as sequências de caracteres de formato "h " e "%h" são interpretadas como sequências de caracteres de formato personalizado de data e hora que exibe a hora representada pelo valor atual de data e hora.Observe que, se for usado um espaço, ele aparece como um caractere literal na sequência de resultado.

Consulte também

Conceitos

Sequências de caracteres de formato padrão de data e hora

Referência

System.DateTime

System.IFormatProvider

Outros recursos

Tipos de Formatação