Partilhar via

format_datetime()

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Formata uma data/hora de acordo com o formato fornecido.

Sintaxe

format_datetime( data,Formato)

Saiba mais sobre convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
data datetime ✔️ O valor para 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 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. 6/15/2009 13:45:30.617 -> 617, 6/15/2009 13:45:30.0005 -> 000
ffff Os dez 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 cem 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.0000005 -> 000000
fffffff Os dez 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.0500000 -> (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.0050000 -> (sem saída)
FFF Se for 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 dez 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 cem 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.0000005 -> (sem saída)
FFFFFFF Se diferente de zero, os dez 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 AM / PM horas 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 de caracteres com data formatada conforme especificado pelo formato.

Exemplos

O exemplo a seguir mostra como usar a format_datetime() função para formatar um valor datetime. A saída é formatada com dois dígitos para o dia, hora, minuto e segundo.

:::moniker range="azure-data-explorer"
> [!div class="nextstepaction"]
> <a href="https://dataexplorer.azure.com/clusters/help/databases/Samples?query=H4sIAAAAAAAAA8tJLVFIKVGwVUhJLEktycxN1TAyMDTXNTDUNbJUMLC0MjCwMjDVtOblKijKzCtR4OUqM7RNyy/KTSyJh+tIKdFRr6zU9fXVTUlRiPbwsMrNtSoujlXXBAC5cbYnXQAAAA" target="_blank">Run the query</a>
::: moniker-end

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

Realização

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

O exemplo a seguir mostra como usar a format_datetime() função para formatar um valor datetime. A saída é formatada com um único dígito para o mês e a hora, e com quatro dígitos para o ano.

:::moniker range="azure-data-explorer"
> [!div class="nextstepaction"]
> <a href="https://dataexplorer.azure.com/clusters/help/databases/Samples?query=H4sIAAAAAAAAA8tJLVFIKVGwVUhJLEktycxN1TAyMDTXNTDUNbJUMLC0MjCwMjDVtOblKijKzCtR4OUqM7JNyy/KTSyJh+tIKdFRUK8EAl1f3ZQUhWgPq9xcq+LiWHVNAPGQ6QdeAAAA" target="_blank">Run the query</a>
::: moniker-end

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

Realização

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

O exemplo a seguir mostra como usar a format_datetime() função para formatar um valor datetime. A saída é formatada com um único dígito para o mês e a hora, e com quatro dígitos para o ano.

:::moniker range="azure-data-explorer"
> [!div class="nextstepaction"]
> <a href="https://dataexplorer.azure.com/clusters/help/databases/Samples?query=H4sIAAAAAAAAA8tJLVFIKVGwVUhJLEktycxN1TAyMDTXNTDUNbJUMLC0MjCwMjDVtOblKijKzCtR4OUqM7ZNyy/KTSyJh+tIKdFRUK+s1PX11U1JUYjOyLDKzbUqLlYoKYlV1wQA0Nc3NmEAAAA" target="_blank">Run the query</a>
::: moniker-end

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

Realização

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

Conteúdo relacionado