format_datetime()

  • Artigo

Formata um datetime de acordo com o formato fornecido.

Syntax

format_datetime(Data,Formato)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
date datetime ✔️ O valor a ser formatado.
format string ✔️ O formato de saída composto por um ou mais dos elementos de formato com suporte.

Elementos de formato com suporte

O parâmetro format deve incluir um ou mais dos seguintes elementos:

Especificador de formato Descrição Exemplos
d O dia do mês, de 1 a 31. 2009-06-01T13:45:30 -> 1, 2009-06-15T13:45:30 -> 15
dd O dia do mês, de 01 a 31. 2009-06-01T13:45:30 -> 01, 2009-06-15T13:45:30 -> 15
f Os décimos de segundo em um valor de data e hora. 2009-06-15T13:45:30.6170000 -> 6, 2009-06-15T13:45:30.05 -> 0
ff Os centésimos de segundo em um valor de data e hora. 2009-06-15T13:45:30.6170000 -> 61, 2009-06-15T13:45:30.0050000 -> 00
fff Os milissegundos em um valor de data e hora. 15/06/2009 13:45:30.617 -> 617, 15/06/2009 13:45:30.0005 -> 000
ffff Os décimos de milésimos de segundo em um valor de data e hora. 2009-06-15T13:45:30.6175000 -> 6175, 2009-06-15T13:45:30.0000500 -> 0000
fffff Os centésimos de milésimos de segundo em um valor de data e hora. 2009-06-15T13:45:30.6175400 -> 61754, 2009-06-15T13:45:30.000005 -> 00000
ffffff Os milionésimos de segundo em um valor de data e hora. 2009-06-15T13:45:30.6175420 -> 617542, 2009-06-15T13:45:30.00000005 -> 000000
fffffff Os décimos de milionésimos de segundo em um valor de data e hora. 2009-06-15T13:45:30.6175425 -> 6175425, 2009-06-15T13:45:30.0001150 -> 0001150
F Se diferente de zero, os décimos de segundo em um valor de data e hora. 2009-06-15T13:45:30.6170000 -> 6, 2009-06-15T13:45:30.05000000 -> (sem saída)
FF Se diferente de zero, os centésimos de segundo em um valor de data e hora. 2009-06-15T13:45:30.6170000 -> 61, 2009-06-15T13:45:30.00500000 -> (sem saída)
FFF Se diferente de zero, os milissegundos em um valor de data e hora. 2009-06-15T13:45:30.6170000 -> 617, 2009-06-15T13:45:30.0005000 -> (sem saída)
FFFF Se diferente de zero, os décimos de milésimos de segundo em um valor de data e hora. 2009-06-15T13:45:30.5275000 -> 5275, 2009-06-15T13:45:30.0000500 -> (sem saída)
FFFFF Se diferente de zero, os centésimos de milésimos de segundo em um valor de data e hora. 2009-06-15T13:45:30.6175400 -> 61754, 2009-06-15T13:45:30.0000050 -> (sem saída)
FFFFFF Se diferente de zero, os milionésimos de segundo em um valor de data e hora. 2009-06-15T13:45:30.6175420 -> 617542, 2009-06-15T13:45:30.00000005 -> (sem saída)
FFFFFFF Se diferente de zero, os décimos de milionésimos de segundo em um valor de data e hora. 2009-06-15T13:45:30.6175425 -> 6175425, 2009-06-15T13:45:30.0001150 -> 000115
h A hora, usando um relógio de 12 horas de 1 a 12. 2009-06-15T01:45:30 -> 1, 2009-06-15T13:45:30 -> 1
hh A hora, usando um relógio de 12 horas de 01 a 12. 2009-06-15T01:45:30 -> 01, 2009-06-15T13:45:30 -> 01
H A hora, usando um relógio de 24 horas de 0 a 23. 2009-06-15T01:45:30 -> 1, 2009-06-15T13:45:30 -> 13
HH A hora, usando um relógio de 24 horas de 00 a 23. 2009-06-15T01:45:30 -> 01, 2009-06-15T13:45:30 -> 13
m O minuto, de 0 a 59. 2009-06-15T01:09:30 -> 9, 2009-06-15T13:29:30 -> 29
mm O minuto, de 00 a 59. 2009-06-15T01:09:30 -> 09, 2009-06-15T01:45:30 -> 45
M O mês, de 1 a 12. 2009-06-15T13:45:30 –> 6
MM O mês, de 01 a 12. 2009-06-15T13:45:30 –> 06
s O segundo, de 0 a 59. 2009-06-15T13:45:09 –> 9
ss O segundo, de 00 a 59. 2009-06-15T13:45:09 –> 09
y O ano, de 0 a 99. 0001-01-01T00:00:00 -> 1, 0900-01-01T00:00:00 -> 0, 1900-01-01T00:00:00 -> 0, 2009-06-15T13:45:30 -> 9, 2019-06-15T13:45:30 -> 19
yy O ano, de 00 a 99. 0001-01-01T00:00:00 -> 01, 0900-01-01T00:00:00 -> 00, 1900-01-01T00:00:00 -> 00, 2019-06-15T13:45:30 -> 19
yyyy O ano como um número de quatro dígitos. 0001-01-01T00:00:00 -> 0001, 0900-01-01T00:00:00 -> 0900, 1900-01-01T00:00:00 -> 1900, 2009-06-15T13:45:30 -> 2009
tt Horas AM/PM 2009-06-15T13:45:09 -> PM

Delimitadores com suporte

O especificador de formato pode incluir os seguintes delimitadores:

Delimitador Comentário
' ' Space
'/'
'-' Traço
':'
','
'.'
'_'
'['
']'

Retornos

Uma cadeia de caracteres com data formatada conforme especificado por formato.

Exemplos

Os três exemplos a seguir retornam datetimes formatados de forma diferente.

Executar a consulta

let dt = datetime(2017-01-29 09:00:05);
print 
v1=format_datetime(dt,'yy-MM-dd [HH:mm:ss]')

Saída

v1
17-01-29 [09:00:05]

Executar a consulta

let dt = datetime(2017-01-29 09:00:05);
print 
v2=format_datetime(dt, 'yyyy-M-dd [H:mm:ss]')

Saída

v2
2017-1-29 [9:00:05]

Executar a consulta

let dt = datetime(2017-01-29 09:00:05);
print 
v3=format_datetime(dt, 'yy-MM-dd [hh:mm:ss tt]')

Saída

v3
17-01-29 [09:00:05 AM]

Conteúdo relacionado