Partilhar via

O tipo de dados datetime

  • Artigo

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

O tipo de dados datetime representa um instante no tempo, normalmente expresso como uma data e hora do dia. Os valores variam de 00:00:00 (meia-noite), 1 de janeiro de 0001 Anno Domini (Era Comum) até 23:59:59 P.M., 31 de dezembro de 9999 A.D. (C.E.) no calendário gregoriano.

Os valores de tempo são medidos em unidades de 100 nanossegundos chamadas ticks, e uma data específica é o número de ticks desde 12:00 meia-noite, 1 de janeiro de 0001 A.D. (C.E.) no calendário GregorianCalendar (excluindo ticks que seriam adicionados por segundos bissextos). Por exemplo, um valor de ticks de 31241376000000000 representa a data, sexta-feira, 1 de janeiro, 0100 12:00:00 meia-noite. Isso às vezes é chamado de "um momento no tempo linear".

Os tipos de dados datetime e date são equivalentes.

Observação

Um valor datetime em Kusto está sempre no fuso horário UTC. Se for necessário exibir valores de datetime em outros fusos horários, use datetime_utc_to_local() ou datetime_local_to_utc().

datetime literais

Para especificar um literal datetime, use uma das seguintes opções de sintaxe:

Sintaxe Descrição Exemplo
datetime( ano.mês.diahora:minuto:segundo.milissegundos) Uma data e hora em formato UTC. datetime(2015-12-31 23:59:59.9)
datetime( ano.mês.dia) Uma data em formato UTC. datetime(2015-12-31)
datetime() Devolve a hora atual.
datetime(null) Representa o valor nulo .

Saiba mais sobre convenções de sintaxe.

O now() e ago() funções especiais

Kusto fornece duas funções especiais, now() e ago(), para permitir que as consultas façam referência ao momento em que a consulta inicia a execução.

Formatos suportados

Há vários formatos para que são suportados como literais datetime() e a função todatetime().

Advertência

É altamente recomendado usar apenas os formatos ISO 8601.

ISO 8601

Formato Exemplo
%Y-%m-%dT%H:%M:%s%z 2014-05-25T08:20:03.123456Z
%Y-%m-%dT%H:%M:%s 2014-05-25T08:20:03.123456
%Y-%m-%dT%H:%M 2014-05-25T08:20
%Y-%m-%d %H:%M:%s%z 2014-11-08 15:55:55.123456Z
%Y-%m-%d %H:%M:%s 2014-11-08 15:55:55
%Y-%m-%d %H:%M 2014-11-08 15:55
%Y-%m-%d 2014-11-08

RFC 822

Formato Exemplo
%w, %e %b %r %H:%M:%s %Z Sáb, 8 nov 14 15:05:02 GMT
%w, %e %b %r %H:%M:%s Sáb, 8 nov 14 15:05:02
%w, %e %b %r %H:%M Sáb, 8 nov 14 15:05
%w, %e %b %r %H:%M %Z Sáb, 8 nov 14 15:05 GMT
%e %b %r %H:%M:%s %Z 8 nov 14 15:05:02 GMT
%e %b %r %H:%M:%s 8 nov 14 15:05:02
%e %b %r %H:%M 8 nov 14 15:05
%e %b %r %H:%M %Z 8 nov 14 15:05 GMT

RFC 850

Formato Exemplo
%w, %e-%b-%r %H:%M:%s %Z Sábado, 08-Nov-14 15:05:02 GMT
%w, %e-%b-%r %H:%M:%s Sábado, 08-Nov-14 15:05:02
%w, %e-%b-%r %H:%M %Z Sábado, 08-Nov-14 15:05 GMT
%w, %e-%b-%r %H:%M Sábado, 08-Nov-14 15:05
%e-%b-%r %H:%M:%s %Z 08-Nov-14 15:05:02 GMT
%e-%b-%r %H:%M:%s 08-Nov-14 15:05:02
%e-%b-%r %H:%M %Z 08-Nov-14 15:05 GMT
%e-%b-%r %H:%M 08-Nov-14 15:05

Classificável

Formato Exemplo
%Y-%n-%e %H:%M:%s 2014-11-08 15:05:25
%Y-%n-%e %H:%M:%s %Z 2014-11-08 15:05:25 GMT
%Y-%n-%e %H:%M 2014-11-08 15:05
%Y-%n-%e %H:%M %Z 2014-11-08 15:05 GMT
%Y-%n-%eT%H:%M:%s 2014-11-08T15:05:25
%Y-%n-%eT%H:%M:%s %Z 2014-11-08T15:05:25 GMT
%Y-%n-%eT%H:%M 2014-11-08T15:05
%Y-%n-%eT%H:%M %Z 2014-11-08T15:05 GMT

Conteúdo relacionado