Personalizar formatos de data e hora para a função FORMAT
A tabela a seguir mostra caracteres que podem ser usados para criar formatos de data e hora definidos pelo usuário.
Especificação de formato |
Descrição |
|---|---|
(:) |
Separador de hora. Em algumas localidades, outros caracteres podem ser usados para representar o separador de hora. O separador de hora separa horas, minutos e segundos quando valores de tempo são formatados. O caractere real usado como separador de hora na saída formatada é determinado pelo valor cultural atual do seu aplicativo. |
(/) |
Separador de data. Em algumas localidades, outros caracteres podem ser usados para representar o separador de data. O separador de data separa dia, mês e ano quando valores de data são formatados. O caractere real usado como separador de data na saída formatada é determinado pela cultura atual do seu aplicativo. |
(%) |
Usado para indicar que os caracteres a seguir devem ser lidos como o formato de uma única letra, sem considerar nenhuma letra à direita. Também usado para indicar que o formato de uma única letra é lido como um formato definido pelo usuário. Veja os itens a seguir para obter detalhes adicionais. |
d |
Exibe o dia como um número sem zero à esquerda (por exemplo, 1). Use %d se esse for o único caractere no seu formato numérico definido pelo usuário. |
dd |
Exibe o dia como um número com um zero à esquerda (por exemplo, 01). |
ddd |
Exibe o dia como uma abreviação (por exemplo, Dom). |
dddd |
Exibe o dia como um nome inteiro (por exemplo, domingo). |
M |
Exibe o mês como um número sem um zero à esquerda (por exemplo, janeiro é representado como 1). Use %M se esse for o único caractere no seu formato numérico definido pelo usuário. |
MM |
Exibe o mês como um número com um zero à esquerda (por exemplo, 01/12/01). |
MMM |
Exibe o mês como uma abreviação (por exemplo, jan). |
MMMM |
Exibe o mês como um nome completo de mês (por exemplo, janeiro). |
gg |
Exibe a cadeia de caracteres de período/era (por exemplo, A.D.). |
h |
Exibe a hora como um número sem zeros à esquerda usando o formato de 12 horas (por exemplo, 1:15:15 PM). Use %h se esse for o único caractere no seu formato numérico definido pelo usuário. |
hh |
Exibe a hora como um número com zeros à esquerda usando o formato de 12 horas (por exemplo, 01:15:15 PM). |
H |
Exibe a hora como um número sem zeros à esquerda usando o formato de 24 horas (por exemplo, 1:15:15). Use %H se esse for o único caractere no seu formato numérico definido pelo usuário. |
HH |
Exibe a hora como um número com zeros à esquerda usando o formato de 24 horas (por exemplo, 01:15:15). |
m |
Exibe o minuto como um número sem zeros à esquerda (por exemplo, 12:1:15). Use %m se esse for o único caractere no seu formato numérico definido pelo usuário. |
mm |
Exibe o minuto como um número com zeros à esquerda (por exemplo, 12:01:15). |
s |
Exibe o segundo como um número sem zeros à esquerda (por exemplo, 12:15:5). Use %s se esse for o único caractere no seu formato numérico definido pelo usuário. |
ss |
Exibe o segundo como um número com zeros à esquerda (por exemplo, 12:15:05). |
f |
Exibe frações de segundos. Por exemplo, ff exibe centésimos de segundos, enquanto ffff exibe décimos milésimos de segundos. Você pode usar até sete símbolos f no seu formato definido pelo usuário. Use %f se esse for o único caractere no seu formato numérico definido pelo usuário. |
t |
Usa o formato de 12 horas e exibe um A maiúsculo para qualquer hora antes de meio-dia; exibe um P maiúsculo para qualquer hora entre meio-dia e 11:59 PM. Use %t se esse for o único caractere no seu formato numérico definido pelo usuário. |
tt |
Para localidades que usam o formato de 12 horas, exibe AM em maiúsculas para qualquer hora antes de meio-dia; exibe PM em maiúsculas para qualquer hora entre meio-dia e 11:59 PM. Para localidades que usam o formato de 24 horas, não exibe nada. |
y |
Exibe o número do ano (0-9) sem zeros à esquerda. Use %y se esse for o único caractere no seu formato numérico definido pelo usuário. |
yy |
Exibe o ano no formato numérico de dois dígitos com um zero à esquerda, se aplicável. |
yyy |
Exibe o ano no formato numérico de quatro dígitos. |
yyyy |
Exibe o ano no formato numérico de quatro dígitos. |
z |
Exibe o deslocamento de fuso horário sem um zero à esquerda (por exemplo, -8). Use %z se esse for o único caractere no seu formato numérico definido pelo usuário. |
zz |
Exibe o deslocamento de fuso horário com um zero à esquerda (por exemplo, -08). |
zzz |
Exibe o deslocamento de fuso horário completo (por exemplo, -08:00) |
Comentários
Cadeias de caracteres de formatação diferenciam maiúsculas e minúsculas. Uma formatação diferente pode ser obtida usando maiúsculas ou minúsculas. Por exemplo, ao formatar um valor de data com a cadeia de caracteres "D", você obterá a data no formato longo (de acordo com sua localidade atual). Porém, se você alterar para "d", você obterá a data no formato curto. Além disso, poderão ser obtidos resultados inesperados ou um erro se a formatação pretendida não corresponder ao uso de maiúsculas e minúsculas de qualquer cadeia de formato definida.
A formatação de Data/Hora usa a localidade do usuário atual para determinar o formato definitivo da cadeia de caracteres. Por exemplo, para formatar a data 18 de março de 1995 com a cadeia de formato "M/d/aaaa", se a localidade do usuário estiver definida como Estados Unidos da América (en-us), o resultado será '3/18/1995', mas se a localidade do usuário estiver definida como Alemanha (de-de), o resultado será '18.03.1995'.