format_datetime()

  • Artigo

Formatar 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 Necessário Descrição
data datetime ✔️ O valor a formatar.
formato string ✔️ O formato de saída composto por um ou mais dos elementos de formato suportados.

Elementos de formato suportados

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

Especificador de formato Descrição Exemplos
d O dia do mês, de 1 a 31. 06-2009-01T13:45:30 -> 1, 2009-06-15T13:45:30 -> 15
dd O dia do mês, de 01 a 31. 06-2009-01T13:45:30 -> 01, 2009-06-15T13:45:30 -> 15
f Os décimos de segundo num valor de data e hora. 06-2009-15T13:45:30.6170000 -> 6, 2009-06-15T13:45:30.05 -> 0
ff Os centésimos de segundo num valor de data e hora. 2009-06-15T13:45:30.6170000 -> 61, 2009-06-15T13:45:30.0050000 -> 00
fff Os milissegundos num valor de data e hora. 15/06/2009 13:45:30.617 -> 617, 15/06/2009 13:45:30.0005 -> 000
ffff Os dez milésimos de segundo num valor de data e hora. 2009-06-15T13:45:30.6175000 -> 6175, 2009-06-15T13:45:30.0000500 -> 0000
fffff Os cem milésimos de segundo num 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 num valor de data e hora. 2009-06-15T13:45:30.6175420 -> 617542, 2009-06-15T13:45:30.0000005 -> 000000
fffffff Os dez milionésimos de segundo num valor de data e hora. 2009-06-15T13:45:30.6175425 -> 6175425, 2009-06-15T13:45:30.0001150 -> 0001150
F Se não for zero, as décimas de um segundo num valor de data e hora. 06-2009-15T13:45:30.6170000 -> 6, 2009-06-15T13:45:30.0500000 -> (sem saída)
FF Se não for zero, os centésimos de segundo num valor de data e hora. 2009-06-15T13:45:30.6170000 -> 61, 2009-06-15T13:45:30.0050000 -> (sem saída)
FFF Se não for zero, os milissegundos num valor de data e hora. 2009-06-15T13:45:30.6170000 -> 617, 2009-06-15T13:45:30.0005000 -> (sem saída)
FFFF Se não for zero, os dez milésimos de segundo num valor de data e hora. 2009-06-15T13:45:30.5275000 -> 5275, 2009-06-15T13:45:30.0000500 -> (sem saída)
FFFFF Se não for zero, os cem milésimos de segundo num valor de data e hora. 2009-06-15T13:45:30.6175400 -> 61754, 2009-06-15T13:45:30.0000050 -> (sem saída)
FFFFFF Se não for zero, os milionésimos de segundo num valor de data e hora. 2009-06-15T13:45:30.6175420 -> 617542, 2009-06-15T13:45:30.0000005 -> (sem saída)
FFFFFFF Se não for zero, os dez milionésimos de segundo num valor de data e hora. 2009-06-15T13:45:30.6175425 -> 6175425, 2009-06-15T13:45:30.0001150 -> 000115
h A hora, utilizando 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, utilizando um relógio de 12 horas de 01 a 12. 06-2009-15T01:45:30 -> 01, 2009-06-15T13:45:30 -> 01
H A hora, utilizando um relógio de 24 horas de 0 a 23. 06-2009-15T01:45:30 -> 1, 2009-06-15T13:45:30 -> 13
HH A hora, utilizando um relógio de 24 horas de 00 a 23. 06-2009-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. 06-2009-15T01:09:30 -> 09, 2009-06-15T01:45:30 -> 45
M O mês, de 1 a 12. 06-2009-15T13:45:30 -> 6
MM O mês, de 01 a 12. 06-2009-15T13:45:30 -> 06
s O segundo, de 0 a 59. 06-2009-15T13:45:09 -> 9
ss O segundo, de 00 a 59. 06-2009-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 suportados

O especificador de formato pode incluir os seguintes delimitadores:

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

Devoluções

Uma cadeia com data formatada conforme especificado pelo formato.

Exemplos

Os três exemplos seguintes devolvem 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]

Conteúdo relacionado