O tipo de dados datetime

  • Artigo

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

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

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

Nota

Um datetime valor no Kusto está sempre no fuso horário UTC. Se for datetime necessário apresentar valores noutros fusos horários, utilize datetime_utc_to_local() ou datetime_local_to_utc().

datetime literais

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

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

Saiba mais sobre as convenções de sintaxe.

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

O Kusto fornece duas funções especiais, agora() e ago(), para permitir que as consultas referenciem o momento em que a consulta inicia a execução.

Formatos suportados

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

Aviso

Recomenda-se vivamente que utilize 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

Ordená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