now()

  • Artigo

Retorna a hora UTC atual, opcionalmente deslocada por um determinado período de tempo.

O horário UTC atual permanecerá o mesmo em todos os usos de now() em uma única instrução de consulta, mesmo que tecnicamente haja uma pequena diferença de tempo entre quando cada uma now() é executada.

Syntax

now([ offset ])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
offset timespan Um período de tempo a ser adicionado à hora atual do relógio UTC. O valor padrão é 0.

Retornos

A hora atual do relógio UTC, mais o tempo de deslocamento , se fornecido, como um datetime.

Exemplos

Mostrar a hora atual

Executar a consulta

print now()

Mostrar a hora há 2 dias

Executar a consulta

print now(-2d)

Localizar o tempo decorrido de um determinado evento

O exemplo a seguir mostra o tempo decorrido desde o início dos eventos de tempestade.

Executar a consulta

StormEvents
| extend Elapsed=now() - StartTime
| take 10

Obter a data em relação a um intervalo de tempo específico

Executar a consulta

let T = datatable(label: string, timespanValue: timespan) [
    "minute", 60s, 
    "hour", 1h, 
    "day", 1d, 
    "year", 365d
];
T 
| extend timeAgo = now() - timespanValue

Saída

label timespanValue timeAgo
year 365.00:00:00 2022-06-19T08:22:54.6623324Z
dia 1.00:00:00 2023-06-18T08:22:54.6623324Z
hour 01:00:00 2023-06-19T07:22:54.6623324Z
minute 00:01:00 2023-06-19T08:21:54.6623324Z

Observação

Essa operação pode ser realizada com a função ago().