Sequências de Caracteres de Formato Personalizado de Data e Hora
Uma seqüência de formato de data e hora define a representação de texto de um DateTime ou DateTimeOffset valor que resulta de uma operação de formatação. Ele também pode definir a representação de um valor de data e hora que é necessário em uma operação de análise para converter a seqüência de caracteres para uma data e hora. Uma seqüência de caracteres de formato personalizado consiste em um ou mais Data personalizada e especificadores de formato de 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.
Data personalizada e time format strings podem ser usados com ambos DateTime e DateTimeOffset valores.
Observação
Você pode baixar o O utilitário de formato, um aplicativo que permite que você aplique o formato de seqüências de caracteres para a data e a hora ou valores e exibe a seqüência de resultado numéricos.
Em operações de formatação personalizada Data and time format strings podem ser usado tanto com o ToString método de uma instância de data e hora ou com um método que oferece suporte à formatação de composição. O exemplo a seguir ilustra os dois usos.
Dim thisDate1 As Date = #6/10/2011#
Console.WriteLine("Today is " + thisDate1.ToString("MMMM dd, yyyy") + ".")
Dim thisDate2 As New DateTimeOffset(2011, 6, 10, 15, 24, 16, TimeSpan.Zero)
Console.WriteLine("The current date and time: {0:MM/dd/yy H:mm:ss zzz}",
thisDate2)
' The example displays the following output:
' Today is June 10, 2011.
' The current date and time: 06/10/11 15:24:16 +00:00
DateTime thisDate1 = new DateTime(2011, 6, 10);
Console.WriteLine("Today is " + thisDate1.ToString("MMMM dd, yyyy") + ".");
DateTimeOffset thisDate2 = new DateTimeOffset(2011, 6, 10, 15, 24, 16,
TimeSpan.Zero);
Console.WriteLine("The current date and time: {0:MM/dd/yy H:mm:ss zzz}",
thisDate2);
// The example displays the following output:
// Today is June 10, 2011.
// The current date and time: 06/10/11 15:24:16 +00:00
Na análise de operações de data personalizada and time format strings podem ser usados com o DateTime.ParseExact, DateTime.TryParseExact, DateTimeOffset.ParseExact, e DateTimeOffset.TryParseExact métodos. Estes métodos requerem que uma seqüência de caracteres de entrada sigam exatamente um padrão específico para a operação de análise seja bem-sucedida. O exemplo a seguir ilustra uma chamada para o DateTimeOffset.ParseExact(String, String, IFormatProvider) método para analisar uma data que deve incluir um dia, mês e um ano de dois dígitos.
Imports System.Globalization
Module Example
Public Sub Main()
Dim dateValues() As String = { "30-12-2011", "12-30-2011",
"30-12-11", "12-30-11" }
Dim pattern As String = "MM-dd-yy"
Dim parsedDate As Date
For Each dateValue As String In dateValues
If DateTime.TryParseExact(dateValue, pattern, Nothing,
DateTimeStyles.None, parsedDate) Then
Console.WriteLine("Converted '{0}' to {1:d}.",
dateValue, parsedDate)
Else
Console.WriteLine("Unable to convert '{0}' to a date and time.",
dateValue)
End If
Next
End Sub
End Module
' The example displays the following output:
' Unable to convert '30-12-2011' to a date and time.
' Unable to convert '12-30-2011' to a date and time.
' Unable to convert '30-12-11' to a date and time.
' Converted '12-30-11' to 12/30/2011.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
string[] dateValues = { "30-12-2011", "12-30-2011",
"30-12-11", "12-30-11" };
string pattern = "MM-dd-yy";
DateTime parsedDate;
foreach (var dateValue in dateValues) {
if (DateTime.TryParseExact(dateValue, pattern, null,
DateTimeStyles.None, out parsedDate))
Console.WriteLine("Converted '{0}' to {1:d}.",
dateValue, parsedDate);
else
Console.WriteLine("Unable to convert '{0}' to a date and time.",
dateValue);
}
}
}
// The example displays the following output:
// Unable to convert '30-12-2011' to a date and time.
// Unable to convert '12-30-2011' to a date and time.
// Unable to convert '30-12-11' to a date and time.
// Converted '12-30-11' to 12/30/2011.
A tabela a seguir descreve os data personalizada e especificadores de formato de hora e exibe uma seqüência de resultado produzida por cada especificador de formato. Se um especificador de formato particular produz uma seqüência de caracteres de resultado localizado, o exemplo também observa a cultura ao qual se aplica a seqüência de resultado. Consulte a seção de notas para obter informações adicionais sobre o uso de data personalizada e time format strings.
Especificador de Formato |
Descrição |
Exemplos |
|---|---|---|
"d" |
O dia do mês, de 1 a 31. Mais informações: O "d" O especificador de formato personalizado. |
1 De 6 de 2009 1:45:30 PM - > 1 15 De 6 de 2009 1:45:30 PM - > 15 |
"dd" |
O dia do mês, de 01 a 31. Mais informações: "dd" O especificador de formato personalizado. |
1 De 6 de 2009 1:45:30 PM - > 01 15 De 6 de 2009 1:45:30 PM - > 15 |
"ddd" |
O nome abreviado do dia da semana. Mais informações: "ddd" O especificador de formato personalizado. |
15 De 6 de 2009 1:45:30 PM - > Segunda-feira (en-US) 15 De 6 de 2009 1:45:30 PM - > Пн (ru-RU) 15 De 6 de 2009 1:45:30 PM - > LUN. (fr-FR) |
"dddd" |
O nome completo do dia da semana. Mais informações: "dddd" O especificador de formato personalizado. |
15 De 6 de 2009 1:45:30 PM - > Segunda-feira (en-US) 15 De 6 de 2009 1:45:30 PM - > Понедельник (ru-RU) 15 De 6 de 2009 1:45:30 PM - > lundi (fr-FR) |
"f" |
Décimos de segundo um valor de data e hora. Mais informações: "f" O especificador de formato personalizado. |
6/15/2009 13:45:30.617 -> 6 6/15/2009 13:45:30.050 -> 0 |
"ff" |
Centésimos de segundos em um valor de data e hora. Mais informações: "ff" O especificador de formato personalizado. |
6/15/2009 13:45:30.617 -> 61 6/15/2009 13:45:30.005 -> 00 |
"fff" |
Milissegundos em um valor de data e hora. Mais informações: "fff" O especificador de formato personalizado. |
6/15/2009 13:45:30.617 -> 617 6/15/2009 13:45:30.0005 -> 000 |
"ffff" |
Os dez milésimos de segundo um valor de data e hora. Mais informações: "ffff" O especificador de formato personalizado. |
6/15/2009 13:45:30.6175 -> 6175 6/15/2009 13:45:30.00005 -> 0000 |
"fffff" |
O milésimos de centenas de segundo um valor de data e hora. Mais informações: "fffff" O especificador de formato personalizado. |
6/15/2009 13:45:30.61754 -> 61754 6/15/2009 13:45:30.000005 -> 00000 |
"ffffff" |
Milionésimos de segundo um valor de data e hora. Mais informações: "ffffff" O especificador de formato personalizado. |
6/15/2009 13:45:30.617542 -> 617542 6/15/2009 13:45:30.0000005 -> 000000 |
"fffffff" |
O milionésimos de dez segundo um valor de data e hora. Mais informações: "fffffff" O especificador de formato personalizado. |
6/15/2009 13:45:30.6175425 -> 6175425 6/15/2009 13:45:30.0001150 -> 0001150 |
"F" |
Se diferente de zero, os décimos de segundo um valor de data e hora. Mais informações: "F" O especificador de formato personalizado. |
6/15/2009 13:45:30.617 -> 6 13:45:30.050 de 15/6/2009 - > (sem saída) |
"FF" |
Se diferente de zero, os centésimos de segundos em um valor de data e hora. Mais informações: "FF" O especificador de formato personalizado. |
6/15/2009 13:45:30.617 -> 61 13:45:30.005 de 15/6/2009 - > (sem saída) |
"FFF" |
Se diferente de zero, o valor de data e hora de milissegundos. Mais informações: "FFF" O especificador de formato personalizado. |
6/15/2009 13:45:30.617 -> 617 13:45:30.0005 de 15/6/2009 - > (sem saída) |
"FFFF" |
Se diferente de zero a dez milésimos de segundo um valor de data e hora. Mais informações: "ffff" O especificador de formato personalizado. |
6/1/2009 13:45:30.5275 -> 5275 13:45:30.00005 de 15/6/2009 - > (sem saída) |
"FFFFF" |
Se diferente de zero, o milésimos de centenas de segundo um valor de data e hora. Mais informações: "fffff" O especificador de formato personalizado. |
6/15/2009 13:45:30.61754 -> 61754 13:45:30.000005 de 15/6/2009 - > (sem saída) |
"FFFFFF" |
Se diferente de zero, os milionésimos de segundo um valor de data e hora. Mais informações: "ffffff" O especificador de formato personalizado. |
6/15/2009 13:45:30.617542 -> 617542 13:45:30.0000005 de 15/6/2009 - > (sem saída) |
"FFFFFFF" |
Se diferente de zero, o milionésimos de dez segundo um valor de data e hora. Mais informações: "fffffff" O especificador de formato personalizado. |
6/15/2009 13:45:30.6175425 -> 6175425 6/15/2009 13:45:30.0001150 -> 000115 |
"g", "gg" |
O período ou era. Mais informações: "g" ou "gg" O especificador de formato personalizado. |
15 De 6 de 2009 1:45:30 PM - > D.C. |
"h" |
A hora, usando um relógio de 12 horas de 1 a 12. Mais informações: O "h" O especificador de formato personalizado. |
15 De 6 de 2009 1:45:30 AM - > 1 15 De 6 de 2009 1:45:30 PM - > 1 |
"hh" |
A hora, usando um relógio de 12 horas de 01 a 12. Mais informações: "hh" O especificador de formato personalizado. |
15 De 6 de 2009 1:45:30 AM - > 01 15 De 6 de 2009 1:45:30 PM - > 01 |
"H" |
A hora, usando um relógio de 24 horas de 0 a 23. Mais informações: O "H" O especificador de formato personalizado. |
15 De 6 de 2009 1:45:30 AM - > 1 15 De 6 de 2009 1:45:30 PM - > 13 |
"HH" |
A hora, usando um relógio de 24 horas de 00 a 23. Mais informações: "hh" O especificador de formato personalizado. |
15 De 6 de 2009 1:45:30 AM - > 01 15 De 6 de 2009 1:45:30 PM - > 13 |
"K" |
Informações de fuso horário. Mais informações: O "K" O especificador de formato personalizado. |
Com DateTime valores: 15 De 6 de 2009 1:45:30 PM, tipo não especificado - > 15 De 6 de 2009 1:45:30 PM, Kind Utc - > Z 15 De 6 de 2009 1:45:30 PM, tipo Local - > -07: 00 (depende das configurações do computador local) Com DateTimeOffset valores: 15 De 6 de 2009 1:45:30 AM-07: 00 - > -07: 00 15 De 6 de 2009 8:45:30 AM + 00: 00 - > + 00: 00. |
"m" |
O minuto de 0 a 59. Mais informações: "m" O especificador de formato personalizado. |
15 De 6 de 2009 1:09:30 AM - > 9 15 De 6 de 2009 1:09:30 PM - > 9 |
"mm" |
O minuto de 00 a 59. Mais informações: "mm" O especificador de formato personalizado. |
15 De 6 de 2009 1:09:30 AM - > 09 15 De 6 de 2009 1:09:30 PM - > 09 |
“M” |
O mês, de 1 a 12. Mais informações: "M" O especificador de formato personalizado. |
15 De 6 de 2009 1:45:30 PM - > 6 |
"MM" |
O mês de 01 a 12. Mais informações: "MM" O especificador de formato personalizado. |
15 De 6 de 2009 1:45:30 PM - > 06 |
"MMM" |
O nome abreviado do mês. Mais informações: "MMM" O especificador de formato personalizado. |
15 De 6 de 2009 1:45:30 PM - > Jun (en-US) 15 De 6 de 2009 1:45:30 PM - > juin (fr-FR) 15 De 6 de 2009 1:45:30 PM - > Jun (zu-ZA) |
"MMMM" |
O nome completo do mês. Mais informações: "MMMM" O especificador de formato personalizado. |
15 De 6 de 2009 1:45:30 PM - > Junho (en-US) 15 De 6 de 2009 1:45:30 PM - > juni (da-DK) 15 De 6 de 2009 1:45:30 PM - > uJuni (zu-ZA) |
"s" |
O segundo, de 0 a 59. Mais informações: O "s" O especificador de formato personalizado. |
15 De 6 de 2009 1:45:09 PM - > 9 |
"ss" |
O segundo de 00 a 59. Mais informações: "ss" O especificador de formato personalizado. |
15 De 6 de 2009 1:45:09 PM - > 09 |
"t" |
O primeiro caractere do designador AM/PM. Mais informações: O "t" O especificador de formato personalizado. |
15 De 6 de 2009 1:45:30 PM - > P (en-US) 15 De 6 de 2009 1:45:30 PM - > 午 (ja-JP) 15 De 6 de 2009 1:45:30 PM - > (fr-FR) |
"tt" |
O designador AM/PM. Mais informações: "tt" O especificador de formato personalizado. |
15 De 6 de 2009 1:45:30 PM - > PM (en-US) 15 De 6 de 2009 1:45:30 PM - > 午後 (ja-JP) 15 De 6 de 2009 1:45:30 PM - > (fr-FR) |
"y" |
O ano, de 0 a 99. Mais informações: O "y" O especificador de formato personalizado. |
1/1/0001 12: 00: 00 AM - > 1 1/1/0900 12:00:00 AM - > 0 1/1/1900 12:00:00 AM - > 0 15 De 6 de 2009 1:45:30 PM - > 9 |
"AA" |
O ano de 00 a 99. Mais informações: "AA" O especificador de formato personalizado. |
1/1/0001 12: 00: 00 AM - > 01 1/1/0900 12:00:00 AM - > 00 1/1/1900 12:00:00 AM - > 00 15 De 6 de 2009 1:45:30 PM - > 09 |
"yyy" |
O ano, com um mínimo de três dígitos. Mais informações: "yyy" O especificador de formato personalizado. |
1/1/0001 12: 00: 00 AM - > 001 1/1/0900 12:00:00 AM - > 900 1/1/1900 12:00:00 AM - > 1900 15 De 6 de 2009 1:45:30 PM - > 2009 |
"aaaa" |
O ano como um número de quatro dígitos. Mais informações: "Aaaa" O especificador de formato personalizado. |
1/1/0001 12: 00: 00 AM - > 0001 1/1/0900 12:00:00 AM - > 0900 1/1/1900 12:00:00 AM - > 1900 15 De 6 de 2009 1:45:30 PM - > 2009 |
"yyyyy" |
O ano como um número de cinco dígitos. Mais informações: "yyyyy" O especificador de formato personalizado. |
1/1/0001 12: 00: 00 AM - > 00001 15 De 6 de 2009 1:45:30 PM - > 02009 |
"z" |
Horas de deslocamento de UTC, com nenhuma zeros. Mais informações: A "z" O especificador de formato personalizado. |
15 De 6 de 2009 1:45:30 PM-07: 00 - > -7 |
"zz" |
Horas de deslocamento de UTC, com um zero à esquerda para um valor de um único dígito. Mais informações: "zz" O especificador de formato personalizado. |
15 De 6 de 2009 1:45:30 PM-07: 00 - > -07 |
"zzz" |
Deslocamento de horas e minutos do UTC. Mais informações: "zzz" O especificador de formato personalizado. |
15 De 6 de 2009 1:45:30 PM-07: 00 - > -07: 00 |
":" |
O separador de hora. Mais informações: O ":" O especificador de formato personalizado. |
15 De 6 de 2009 1:45:30 PM - > : (en-US) 15 De 6 de 2009 1:45:30 PM - > . (it-IT) 15 De 6 de 2009 1:45:30 PM - > : (ja-JP) |
"/" |
O separador de data. Mais informações: A "/" O especificador de formato personalizado. |
15 De 6 de 2009 1:45:30 PM - > / (en-US) 15 De 6 de 2009 1:45:30 PM - > -(DZ do ar) 15 De 6 de 2009 1:45:30 PM - > . (tr-TR) |
"string" 'seqüência de caracteres' |
Delimitador de seqüência de caracteres literal. |
15 De 6 de 2009 1:45:30 PM ("arr:" h:m t) - > arr: 1: 45 P 15 De 6 de 2009 1:45:30 PM ('arr:' h:m t) - > arr: 1: 45 P |
% |
Define o caractere a seguir como um especificador de formato personalizado. Mais informações: Usando especificadores de formato personalizado único. |
15 De 6 de 2009 1:45:30 PM (% h) - > 1 |
\ |
O caractere de escape. |
15 De 6 de 2009 1:45:30 PM (\h h) - > 1h |
Qualquer outro caractere |
O caractere é copiado para a seqüência de caracteres de resultado inalterada. Mais informações: Usando o caractere de Escape. |
15 De 6 de 2009 1:45:30 AM (hh: mm de arr t-) > arr 01: 45 A |
As seções a seguir fornecem informações adicionais sobre cada data personalizada e o especificador de formato de hora. Salvo indicação em contrário, cada especificador produz uma representação de seqüência de caracteres idênticos independentemente de ele é usado com um DateTime valor ou uma DateTimeOffset valor.
O "d" Especificador de formato personalizado
O "d" o especificador de formato personalizado representa o dia do mês como um número entre 1 e 31. Um dia de dígito é formatado sem um zero à esquerda.
Se o "d" especificador de formato é usado sem outros especificadores de formato personalizado, ele é interpretado como o "d" data padrão e o especificador de formato de hora. Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato personalizado único posteriormente neste tópico.
O exemplo a seguir inclui o "d" especificador de formato personalizado em várias cadeias de caracteres de 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
Volta à tabela
"dd" Especificador de formato personalizado
"dd" seqüência de caracteres de formato personalizado representa o dia do mês como um número de 01 a 31. Um dia de dígito é formatado com um zero à esquerda.
O exemplo a seguir inclui "dd" especificador de formato personalizado em uma seqüê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
Volta à tabela
"ddd" Especificador de formato personalizado
"ddd" o especificador de formato personalizado representa o nome abreviado do dia da semana. O nome abreviado localizado do dia da semana é recuperado da DateTimeFormatInfo.AbbreviatedDayNames a propriedade da cultura atual ou especificado.
O exemplo a seguir inclui "ddd" especificador de formato personalizado em uma seqüê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 août
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 août
Volta à tabela
"dddd" Especificador de formato personalizado
"dddd" o especificador de formato personalizado (além de qualquer número de "d" adicional especificadores) representa o nome completo do dia da semana. O nome localizado do dia da semana é recuperado da DateTimeFormatInfo.DayNames a propriedade da cultura atual ou especificado.
O exemplo a seguir inclui "dddd" especificador de formato personalizado em uma seqüê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
Volta à tabela
"f" Especificador de formato personalizado
"f" o especificador de formato personalizado representa o dígito mais significativo da fração segundos; ou seja, ele representa os décimos de segundo um valor de data e hora.
Se a letra "f" especificador de formato é usado sem outros especificadores de formato, ele é interpretado como "f" data padrão e o especificador de formato de hora. Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato personalizado único posteriormente neste tópico.
Quando você usa o "f" Formatar especificadores como parte de uma seqüência de formato fornecido para o ParseExact, TryParseExact, ParseExact, ou TryParseExact método, o número de "f" especificadores de formato indica o número de dígitos de mais significativos da fração de segundos que deve estar presente com êxito, analisar a seqüência de caracteres.
O exemplo a seguir inclui "f" especificador de formato personalizado em uma seqüê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
Volta à tabela
"ff" Especificador de formato personalizado
"ff" o especificador de formato personalizado representa os dois dígitos mais significativos da fração segundos; ou seja, ele representa os centésimos de segundos em um valor de data e hora.
exemplo a seguir inclui a "ff" especificador de formato personalizado em uma seqüê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
Volta à tabela
"fff" Especificador de formato personalizado
"fff" o especificador de formato personalizado representa os três dígitos mais significativos da fração segundos; ou seja, ele representa o milissegundos em um valor de data e hora.
O exemplo a seguir inclui "fff" especificador de formato personalizado em uma seqüê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
Volta à tabela
"ffff" Especificador de formato personalizado
"ffff" o especificador de formato personalizado representa os quatro dígitos mais significativos da fração segundos; ou seja, ele representa a dez milésimos de segundo um valor de data e hora.
Embora seja possível exibir os dez milésimos de segundo componente de um valor de tempo, esse valor não pode ser significativo. A precisão dos valores de data e hora dependem da resolução em relação ao relógio do sistema. Na versão 3.5 (e posterior) do Windows NT e sistemas operacionais Windows Vista, a resolução do relógio é de aproximadamente de 10 a 15 milissegundos.
Volta à tabela
"fffff" Especificador de formato personalizado
"fffff" o especificador de formato personalizado representa os cinco dígitos mais significativos da fração segundos; ou seja, ele representa o milésimos de centenas de segundo um valor de data e hora.
Embora seja possível exibir o milésimos de centenas de um segundo componente de um valor de tempo, esse valor não pode ser significativo. A precisão dos valores de data e hora dependem da resolução em relação ao relógio do sistema. Na Windows NT de 3,5 (e posterior) e sistemas operacionais Windows Vista, a resolução do relógio é de aproximadamente de 10 a 15 milissegundos.
Volta à tabela
"ffffff" Especificador de formato personalizado
"ffffff" o especificador de formato personalizado representa os seis dígitos mais significativos da fração segundos; ou seja, ele representa os milionésimos de segundo um valor de data e hora.
Embora seja possível exibir os milionésimos de um segundo componente de um valor de tempo, esse valor não pode ser significativo. A precisão dos valores de data e hora dependem da resolução em relação ao relógio do sistema. Na Windows NT de 3,5 (e posterior) e sistemas operacionais Windows Vista, a resolução do relógio é de aproximadamente de 10 a 15 milissegundos.
Volta à tabela
"fffffff" Especificador de formato personalizado
"fffffff" o especificador de formato personalizado representa os sete dígitos mais significativos da fração segundos; ou seja, ele representa o milionésimos de dez segundo um valor de data e hora.
Embora seja possível exibir o milionésimos de dez de um segundo componente de um valor de tempo, esse valor não pode ser significativo. A precisão dos valores de data e hora dependem da resolução em relação ao relógio do sistema. Na Windows NT de 3,5 (e posterior) e sistemas operacionais Windows Vista, a resolução do relógio é de aproximadamente de 10 a 15 milissegundos.
Volta à tabela
"F" Especificador de formato personalizado
"F" o especificador de formato personalizado representa o dígito mais significativo da fração segundos; ou seja, ele representa os décimos de segundo um valor de data e hora. Nada será exibido se o dígito for zero.
Se a letra "F" especificador de formato é usado sem outros especificadores de formato, ele é interpretado como "F" data padrão e o especificador de formato de hora. Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato personalizado único posteriormente neste tópico.
O número de "F" usado com os especificadores de formato de ParseExact, TryParseExact, ParseExact, ou TryParseExact método indica o número máximo de dígitos de mais significativos da fração de segundos que pode estar presente com êxito a analisar a seqüência de caracteres.
O exemplo a seguir inclui "F" especificador de formato personalizado em uma seqüê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
Volta à tabela
"FF" Especificador de formato personalizado
"FF" o especificador de formato personalizado representa os dois dígitos mais significativos da fração segundos; ou seja, ele representa os centésimos de segundos em um valor de data e hora. No entanto, zeros à direita ou dois dígitos de zero não são exibidos.
O exemplo a seguir inclui a "FF" especificador de formato personalizado em uma seqüê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
Volta à tabela
"FFF" Especificador de formato personalizado
"FFF" o especificador de formato personalizado representa os três dígitos mais significativos da fração segundos; ou seja, ele representa o milissegundos em um valor de data e hora. No entanto, zeros à direita ou três dígitos de zero não são exibidos.
O exemplo a seguir inclui "FFF" especificador de formato personalizado em uma seqüê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
Volta à tabela
"ffff" Especificador de formato personalizado
"ffff" o especificador de formato personalizado representa os quatro dígitos mais significativos da fração segundos; ou seja, ele representa a dez milésimos de segundo um valor de data e hora. No entanto, zeros à direita ou quatro dígitos de zero não são exibidos.
Embora seja possível exibir os dez milésimos de segundo componente de um valor de tempo, esse valor não pode ser significativo. A precisão dos valores de data e hora dependem da resolução em relação ao relógio do sistema. Na Windows NT de 3,5 (e posterior) e sistemas operacionais Windows Vista, a resolução do relógio é de aproximadamente de 10 a 15 milissegundos.
Volta à tabela
"fffff" Especificador de formato personalizado
"fffff" o especificador de formato personalizado representa os cinco dígitos mais significativos da fração segundos; ou seja, ele representa o milésimos de centenas de segundo um valor de data e hora. No entanto, zeros à direita ou cinco dígitos de zero não são exibidos.
Embora seja possível exibir o milésimos de centenas de um segundo componente de um valor de tempo, esse valor não pode ser significativo. A precisão dos valores de data e hora dependem da resolução em relação ao relógio do sistema. Na Windows NT de 3,5 (e posterior) e sistemas operacionais Windows Vista, a resolução do relógio é de aproximadamente de 10 a 15 milissegundos.
Volta à tabela
"ffffff" Especificador de formato personalizado
"ffffff" o especificador de formato personalizado representa os seis dígitos mais significativos da fração segundos; ou seja, ele representa os milionésimos de segundo um valor de data e hora. 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 segundo componente de um valor de tempo, esse valor não pode ser significativo. A precisão dos valores de data e hora dependem da resolução em relação ao relógio do sistema. No tfhe Windows NT de 3,5 (e posterior) e sistemas operacionais Windows Vista, a resolução do relógio é de aproximadamente de 10 a 15 milissegundos.
Volta à tabela
"fffffff" Especificador de formato personalizado
"fffffff" o especificador de formato personalizado representa os sete dígitos mais significativos da fração segundos; ou seja, ele representa o milionésimos de dez segundo um valor de data e hora. No entanto, zeros à direita ou sete dígitos de zero não são exibidos.
Embora seja possível exibir o milionésimos de dez de um segundo componente de um valor de tempo, esse valor não pode ser significativo. A precisão dos valores de data e hora dependem da resolução em relação ao relógio do sistema. Na Windows NT de 3,5 (e posterior) e sistemas operacionais Windows Vista, a resolução do relógio é de aproximadamente de 10 a 15 milissegundos.
Volta à tabela
"g" ou "gg" Especificador de formato personalizado
"g" ou "gg" especificadores de formato personalizado (além de qualquer número de "g" adicional especificadores) representa o período ou era, como, por exemplo, d.c. A operação de formatação ignora este especificador se a data a ser formatado não tem um período associado ou uma seqüência de era.
Se "g" especificador de formato é usado sem outros especificadores de formato personalizado, ele é interpretado como um "g" data padrão e o especificador de formato de hora. Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato personalizado único posteriormente neste tópico.
O exemplo a seguir inclui um "g" especificador de formato personalizado em uma seqüê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.
Volta à tabela
O "h" Especificador de formato personalizado
O "h" o especificador de formato personalizado representa a hora como um número de 1 a 12; ou seja, a hora é representada por um relógio de 12 horas que conta as horas inteiras desde a meia-noite ou 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, dada a um tempo de 5: 43 na manhã ou tarde, este especificador de formato personalizado exibe "5".
Se o "h" o especificador de formato é usado sem outros especificadores de formato personalizado, ele é interpretado como uma data padrão e o especificador de formato de hora e lança um FormatException. Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato personalizado único posteriormente neste tópico.
O exemplo a seguir inclui o "h" especificador de formato personalizado 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 µ
Volta à tabela
"hh" Especificador de formato personalizado
"hh" o especificador de formato personalizado (além de qualquer número de "h" adicional especificadores) representa a hora como um número de 01 a 12; ou seja, a hora é representada por um relógio de 12 horas que conta as horas inteiras desde a meia-noite ou 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, dada a um tempo de 5: 43 na manhã ou tarde, o especificador de formato exibe "05".
O exemplo a seguir inclui "hh" especificador de formato personalizado em uma seqüência de caracteres de formato personalizado.
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss 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 tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss 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.
Volta à tabela
O "H" Especificador de formato personalizado
O "H" o especificador de formato personalizado representa a hora como um número de 0 a 23; ou seja, a hora é representada por um relógio de 24 horas com base em zero que conta as horas desde meia-noite. Uma hora de dígito único é formatada sem um zero à esquerda.
Se o "H" o especificador de formato é usado sem outros especificadores de formato personalizado, ele é interpretado como uma data padrão e o especificador de formato de hora e lança um FormatException. Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato personalizado único posteriormente neste tópico.
O exemplo a seguir inclui o "H" especificador de formato personalizado em uma seqüê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
Volta à tabela
"hh" Especificador de formato personalizado
"hh" o especificador de formato personalizado (além de qualquer número de "H" adicional especificadores) representa a hora como um número de 00 a 23; ou seja, a hora é representada por um relógio de 24 horas com base em zero que conta as horas desde meia-noite. Uma hora de dígito único é formatada sem um zero à esquerda.
O exemplo a seguir inclui "hh" especificador de formato personalizado em uma seqüê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
Volta à tabela
O "K" Especificador de formato personalizado
O "K" o especificador de formato personalizado representa as informações de fuso horário de um valor de data e hora. Quando o especificador de formato é usado com DateTime valores, a seqüência de caracteres de resultado é definido pelo valor da DateTime.Kind propriedade:
Para o fuso horário local (um DateTime.Kind valor da propriedade de DateTimeKind.Local), este especificador é equivalente a "zzz" especificador e produz um resultado de cadeia de caracteres que contém o local de deslocamento da Hora Universal Coordenada (UTC); Por exemplo, "-07: 00".
Para uma hora UTC (um DateTime.Kind valor da propriedade de DateTimeKind.Utc), a seqüência de resultado inclui a "Z" caractere para representar uma data UTC.
Por um período de uma zona de tempo não especificado (uma hora cujo DateTime.Kind propriedade é igual a DateTimeKind.Unspecified), o resultado é equivalente a String.Empty.
Para DateTimeOffset valores, o "K" especificador de formato é equivalente a "zz" especificador de formato e produz uma seqüência de resultado contendo o DateTimeOffset o deslocamento do valor de UTC.
Se o "K" o especificador de formato é usado sem outros especificadores de formato personalizado, ele é interpretado como uma data padrão e o especificador de formato de hora e lança um FormatException. Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato personalizado único posteriormente neste tópico.
O exemplo a seguir exibe a seqüência de caracteres que resulta do usando o "K" especificador de formato personalizado com várias DateTime e DateTimeOffset valores em um sistema nos EUA. Fuso horário do Pacífico.
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
Volta à tabela
"m" Especificador de formato personalizado
"m" o especificador de formato personalizado representa o minuto como um número de 0 a 59. O minuto representa os minutos inteiros que se passaram desde a última hora. Uma hora de dígito único é formatada sem um zero à esquerda.
Se o "m" especificador de formato é usado sem outros especificadores de formato personalizado, ele é interpretado como "m" data padrão e o especificador de formato de hora. Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato personalizado único posteriormente neste tópico.
O exemplo a seguir inclui "m" especificador de formato personalizado 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 µ
Volta à tabela
"mm" Especificador de formato personalizado
"mm" o especificador de formato personalizado (além de qualquer número de "m" adicional especificadores) representa o minuto como um número de 00 a 59. O minuto representa os minutos inteiros que se passaram desde a última hora. Uma hora de dígito único é formatada com um zero à esquerda.
O exemplo a seguir inclui "mm" especificador de formato personalizado em uma seqüência de caracteres de formato personalizado.
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss 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 tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss 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.
Volta à tabela
"M" Especificador de formato personalizado
"M" o especificador de formato personalizado representa o mês como um número de 1 a 12 (ou de 1 a 13 para calendários que possuem 13 meses). Um mês de dígito é formatado sem um zero à esquerda.
Se o "M" especificador de formato é usado sem outros especificadores de formato personalizado, ele é interpretado como "M" data padrão e o especificador de formato de hora. Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato personalizado único posteriormente neste tópico.
O exemplo a seguir inclui "M" especificador de formato personalizado em uma seqüê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
Volta à tabela
"MM" Especificador de formato personalizado
"MM" o especificador de formato personalizado representa o mês como um número de 01 a 12 (ou de 1 a 13 para calendários que possuem 13 meses). Um mês de dígito é formatado com um zero à esquerda.
O exemplo a seguir inclui "MM" especificador de formato personalizado em uma seqüê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
Volta à tabela
"MMM" Especificador de formato personalizado
"MMM" o especificador de formato personalizado representa o nome abreviado do mês. O nome abreviado localizado do mês é recuperado da DateTimeFormatInfo.AbbreviatedMonthNames a propriedade da cultura atual ou especificado.
O exemplo a seguir inclui "MMM" especificador de formato personalizado em uma seqüê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 août
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 août
Volta à tabela
"MMMM" Especificador de formato personalizado
"MMMM" o especificador de formato personalizado representa o nome completo do mês. O nome localizado do mês é recuperado da DateTimeFormatInfo.MonthNames a propriedade da cultura atual ou especificado.
O exemplo a seguir inclui "MMMM" especificador de formato personalizado em uma seqüê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
Volta à tabela
O "s" Especificador de formato personalizado
O "s" o especificador de formato personalizado representa os segundos como um número de 0 a 59. O resultado representa todo segundos que se passaram desde o último minuto. Um segundo de dígito único é formatado sem um zero à esquerda.
Se o "s" especificador de formato é usado sem outros especificadores de formato personalizado, ele é interpretado como o "s" data padrão e o especificador de formato de hora. Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato personalizado único posteriormente neste tópico.
O exemplo a seguir inclui o "s" especificador de formato personalizado 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 µ
Volta à tabela
"ss" Especificador de formato personalizado
"ss" o especificador de formato personalizado (além de qualquer número de "s" adicionais especificadores) representa os segundos como um número de 00 a 59. O resultado representa todo segundos que se passaram desde o último minuto. Um segundo de dígito único é formatado sem um zero à esquerda.
O exemplo a seguir inclui "ss" especificador de formato personalizado em uma seqüência de caracteres de formato personalizado.
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss 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 tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss 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.
Volta à tabela
O "t" Especificador de formato personalizado
O "t" o especificador de formato personalizado representa o primeiro caractere do designador AM/PM. O designador localizado apropriado é recuperado do DateTimeFormatInfo.AMDesignator ou DateTimeFormatInfo.PMDesignator a propriedade da cultura atual ou específicos. O designador AM é usado para todos os horários de 0: 00: 00 (meia-noite) para 11:59:59.999. O designador de PM é usado para todos os horários de 12: 00: 00 (meio-dia) para 23:59:59.99.
Se o "t" especificador de formato é usado sem outros especificadores de formato personalizado, ele é interpretado como o "t" data padrão e o especificador de formato de hora. Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato personalizado único posteriormente neste tópico.
O exemplo a seguir inclui o "t" especificador de formato personalizado 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 µ
Volta à tabela
"tt" Especificador de formato personalizado
"tt" o especificador de formato personalizado (além de qualquer número de "t" adicional especificadores) representa o designador AM/PM inteiro. O designador localizado apropriado é recuperado do DateTimeFormatInfo.AMDesignator ou DateTimeFormatInfo.PMDesignator a propriedade da cultura atual ou específicos. O designador AM é usado para todos os horários de 0: 00: 00 (meia-noite) para 11:59:59.999. O designador de PM é usado para todos os horários de 12: 00: 00 (meio-dia) para 23:59:59.99.
Certifique-se de usar "tt" especificador de idiomas para os quais é necessário para 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 "tt" especificador de formato personalizado em uma seqüência de caracteres de formato personalizado.
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss 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 tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss 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.
Volta à tabela
O "y" Especificador de formato personalizado
O "y" o especificador de formato personalizado representa o ano como um número 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.
Se o "y" especificador de formato é usado sem outros especificadores de formato personalizado, ele é interpretado como um "y" data padrão e o especificador de formato de hora. Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato personalizado único posteriormente neste tópico.
O exemplo a seguir inclui um "y" especificador de formato personalizado em uma seqüê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
Volta à tabela
"AA" Especificador de formato personalizado
"AA" o especificador de formato personalizado representa o ano como um número de 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 tem menos de dois dígitos de significativos, o número é preenchido com zeros para produzir dois dígitos.
O exemplo a seguir inclui a "AA" especificador de formato personalizado em uma seqüê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
Volta à tabela
"yyy" Especificador de formato personalizado
"yyy" o especificador de formato personalizado 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 para produzir três dígitos.
Observação
Para o calendário budista tailandês, que pode ter cinco dígitos, o especificador de formato exibe todos os dígitos significativos.
O exemplo a seguir inclui "yyy" especificador de formato personalizado em uma seqüê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
Volta à tabela
"Aaaa" Especificador de formato personalizado
"Aaaa" o especificador de formato personalizado representa o ano com um mínimo de quatro dígitos. Se o ano tem mais de quatro dígitos de significativos, eles são incluídos na seqüência de resultado. Se o ano tem menos de quatro dígitos, o número é preenchido com zeros para produzir os quatro dígitos.
Observação
Para o calendário budista tailandês, que pode ter cinco dígitos, o especificador de formato exibe um mínimo de quatro dígitos.
O exemplo a seguir inclui "aaaa" especificador de formato personalizado em uma seqüê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
Volta à tabela
"yyyyy" Especificador de formato personalizado
"yyyyy" o especificador de formato personalizado (além de qualquer número de "y" adicional especificadores) representa o ano com um mínimo de cinco dígitos. Se o ano tem mais de cinco dígitos de significativos, eles são incluídos na seqüência de resultado. Se o ano tem menos de cinco dígitos, o número é preenchido com zeros para produzir cinco dígitos.
Se houver adicional "y" especificadores, o número é preenchido com zeros quantos conforme necessário para produzir o número de "y" especificadores.
O exemplo a seguir inclui "yyyyy" especificador de formato personalizado em uma seqüê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
Volta à tabela
A "z" Especificador de formato personalizado
Com DateTime valores, a "z" especificador de formato personalizado representa o deslocamento assinado da zona de tempo do sistema operacional local de tempo Universal Coordenado (UTC), medido em horas. Ele não reflete o valor de uma instância da propriedade DateTime.Kind. Por esse motivo, a "z" especificador de formato não é recomendado para uso com o DateTime valores.
Com DateTimeOffset o especificador de formato de valores, representa o DateTimeOffset o deslocamento do valor de UTC em horas.
O deslocamento é sempre exibido com um sinal à esquerda. Um sinal de adição (+) indica horas à frente de UTC, e um sinal de subtração (-) horas atrás UTC. Um deslocamento de dígito é formatado sem um zero à esquerda.
Se a "z" o especificador de formato é usado sem outros especificadores de formato personalizado, ele é interpretado como uma data padrão e o especificador de formato de hora e lança um FormatException. Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato personalizado único posteriormente neste tópico.
O exemplo a seguir inclui a "z" especificador de formato personalizado em uma seqüê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
Volta à tabela
"zz" Especificador de formato personalizado
Com DateTime valores, "zz" especificador de formato personalizado representa o deslocamento assinado da zona de tempo do sistema operacional local de UTC, medido em horas. Ele não reflete o valor de uma instância da propriedade DateTime.Kind. Por esse motivo, o "zz" especificador de formato não é recomendado para uso com o DateTime valores.
Com DateTimeOffset o especificador de formato de valores, representa o DateTimeOffset o deslocamento do valor de UTC em horas.
O deslocamento é sempre exibido com um sinal à esquerda. Um sinal de adição (+) indica horas à frente de UTC, e um sinal de subtração (-) horas atrás UTC. Um deslocamento de dígito é formatado com um zero à esquerda.
O exemplo a seguir inclui "zz" especificador de formato personalizado em uma seqüê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
Volta à tabela
"zzz" Especificador de formato personalizado
Com DateTime valores, "zzz" especificador de formato personalizado representa o deslocamento assinado da zona de tempo do sistema operacional local de UTC, medido em horas e minutos. Ele não reflete o valor de uma instância da propriedade DateTime.Kind. Por esse motivo, o "zzz" especificador de formato não é recomendado para uso com o DateTime valores.
Com DateTimeOffset o especificador de formato de valores, representa o DateTimeOffset o deslocamento do valor de UTC em horas e minutos.
O deslocamento é sempre exibido com um sinal à esquerda. Um sinal de adição (+) indica horas à frente de UTC, e um sinal de subtração (-) horas atrás UTC. Um deslocamento de dígito é formatado com um zero à esquerda.
O exemplo a seguir inclui "zzz" especificador de formato personalizado em uma seqüê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
Volta à tabela
O ":" Especificador de formato personalizado
O ":" o especificador de formato personalizado representa o separador de hora é usado para diferenciar as horas, minutos e segundos. O separador de hora localizadas apropriada é recuperado da DateTimeFormatInfo.TimeSeparator a propriedade da cultura atual ou especificado.
Se a ":" o especificador de formato é usado sem outros especificadores de formato personalizado, ele é interpretado como uma data padrão e o especificador de formato de hora e lança um FormatException. Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato personalizado único posteriormente neste tópico.
Volta à tabela
A "/" Especificador de formato personalizado
A "/" o especificador de formato personalizado representa o separador de data, a qual s usados para diferenciar os dias, meses e anos. O separador de data localizado adequada é recuperado da DateTimeFormatInfo.DateSeparator a propriedade da cultura atual ou especificado.
Se a "/" o especificador de formato é usado sem outros especificadores de formato personalizado, ele é interpretado como uma data padrão e o especificador de formato de hora e lança um FormatException. Para obter mais informações sobre como usar um especificador de formato único, consulte Usando especificadores de formato personalizado único posteriormente neste tópico.
Volta à tabela
Anotações
Usando especificadores de formato único personalizado
Uma sequência de formato personalizado de data e hora consiste de dois ou mais caracteres. Data e hora formatação métodos interpretam seqüência de formato de hora e de qualquer seqüência de caractere único como uma data padrão. Se eles não reconhecem o caractere como um especificador de formato válido, eles lançam uma FormatException. Por exemplo, uma seqüência de formato que consiste somente o especificador "h" é interpretado como uma data padrão e uma seqüência de formato de hora. No entanto, nesse caso específico, uma exceção é lançada porque há um "h" padrão data e hora especificador de formato.
Para usar qualquer um dos especificadores de formato de hora e data personalizado como o especificador somente em uma seqüência de formato (isto é, usar o "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":", ou "/" especificador de formato personalizado por si só), inclua um espaço antes ou após o especificador ou incluir uma porcentagem ("%") especificador de formato antes da única de data personalizada e o especificador de tempo.
Por exemplo, "%h" é interpretado como uma data e uma seqüência de caracteres de formato de tempo que exibe a hora representada pela atual data e hora do valor. Você também pode usar o " h" ou "h" Formatar a seqüência de caracteres, embora isso inclui um espaço na seqüência de resultado junto com a hora. O exemplo a seguir ilustra essas três seqüências de caracteres de formato.
Dim dat1 As Date = #6/15/2009 1:45PM#
Console.WriteLine("'{0:%h}'", dat1)
Console.WriteLine("'{0: h}'", dat1)
Console.WriteLine("'{0:h }'", dat1)
' The example displays the following output:
' '1'
' ' 1'
' '1 '
DateTime dat1 = new DateTime(2009, 6, 15, 13, 45, 0);
Console.WriteLine("'{0:%h}'", dat1);
Console.WriteLine("'{0: h}'", dat1);
Console.WriteLine("'{0:h }'", dat1);
// The example displays the following output:
// '1'
// ' 1'
// '1 '
Usando o caractere de Escape
O "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":", ou "/" caracteres em uma seqüência de formato são interpretados como especificadores de formato personalizado, em vez de fazê-lo como caracteres literais. Para impedir que um caractere seja interpretado como um especificador de formato, você pode preceda com uma barra invertida (\), que é o caractere de escape. O caractere de escape significa que o caractere é um caractere literal que deve ser incluído na seqüência de resultado inalterada.
Para incluir uma barra invertida em uma seqüência de resultado, você precisa isolá-lo com outra barra invertida (\\).
Observação
Alguns compiladores, como, por exemplo, os compiladores de C++ e C# também podem interpretar um caractere de barra invertida como um caractere de escape.Para garantir que uma seqüência de caracteres é interpretada corretamente quando a formatação, você pode usar o caractere literal de cadeia de caracteres verbatim (o caractere @) antes da cadeia de caracteres C#, ou adicionar outro caractere de barra invertida antes de cada barra invertida em C# e C++.O exemplo a seguir C# ilustra as duas abordagens.
O exemplo a seguir usa o caractere de escape para impedir que a operação de formatação de interpretação "h" e "m" caracteres como especificadores de formato.
Dim date1 As Date = #6/15/2009 13:45#
Dim fmt As String = "h \h m \m"
Console.WriteLine("{0} ({1}) -> {2}", date1, fmt, date1.ToString(fmt))
' The example displays the following output:
' 6/15/2009 1:45:00 PM (h \h m \m) -> 1 h 45 m
DateTime date = new DateTime(2009, 06, 15, 13, 45, 30, 90);
string fmt1 = "h \\h m \\m";
string fmt2 = @"h \h m \m";
Console.WriteLine("{0} ({1}) -> {2}", date, fmt1, date.ToString(fmt1));
Console.WriteLine("{0} ({1}) -> {2}", date, fmt2, date.ToString(fmt2));
// The example displays the following output:
// 6/15/2009 1:45:30 PM (h \h m \m) -> 1 h 45 m
// 6/15/2009 1:45:30 PM (h \h m \m) -> 1 h 45 m
Configurações do Painel de controle
O regionais e idioma configurações no painel de controle de influenciam a seqüência de caracteres de resultado produzida por uma operação de formatação que inclui muitos dos especificadores de formato de hora e data personalizados. 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 que usam diferentes configurações geram cadeias de caracteres de resultado diferente.
Além disso, se você usar o CultureInfo.CultureInfo(String) construtor para instanciar uma nova CultureInfo objeto que representa a cultura mesma como a cultura atual do sistema, todas as personalizações estabelecidas pelo regionais e idioma item no painel de controle será aplicada à nova CultureInfo objeto. Você pode usar o CultureInfo.CultureInfo(String, Boolean) constructo para criar um CultureInfo objeto que não reflete as 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. Para o IFormatProvider parâmetro, você deve especificar um CultureInfo objeto que representa uma cultura, ou um DateTimeFormatInfo objeto.
A seqüência de caracteres de resultado produzida por muitos dos especificadores de formato de hora e data personalizados também depende de propriedades do atual DateTimeFormatInfo objeto. 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 "ddd" especificador de formato adiciona um nome de dia da semana abreviado encontrado na AbbreviatedDayNames matriz de cadeia de caracteres para a seqüência de resultado. Da mesma forma, o "MMMM" especificador de formato adiciona um nome de mês completo encontrado no MonthNames matriz de cadeia de caracteres para a seqüência de resultado.
Consulte também
Referência
Conceitos
Sequências de caracteres de formato padrão de data e hora
Histórico de alterações
Date |
History |
Motivo |
|---|---|---|
|
Março de 2011 |
Adicionado um link para o utilitário de formato. |
Aprimoramento de informações. |
|
Julho de 2010 |
Adicionadas informações sobre o uso de seqüências de caracteres de formato personalizado na formatação e análise de operações. |
Comentários do cliente. |