Partilhar via


função para converter data/hora local para UTC

Aplica-se a: ✅Microsoft FabricAzure Data ExplorerAzure MonitorMicrosoft Sentinel

Converte datetime local em datetime UTC usando uma especificação de fuso horário.

Sintaxe

datetime_local_to_utc( De,Fuso horário)

Saiba mais sobre convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
de datetime ✔️ A data/hora local a ser convertida.
Fuso horário string ✔️ O fuso horário da data/hora desejada. O valor deve ser um dos fusos horários suportados.

Devoluções

Retorna um datetime UTC que corresponde ao datetime local no arquivo timezone.

Exemplos

O exemplo a seguir mostra como converter um datetime local em datetime UTC.

datatable(local_dt: datetime, tz: string)
[ datetime(2020-02-02 20:02:20), 'US/Pacific', 
  datetime(2020-02-02 20:02:20), 'America/Chicago', 
  datetime(2020-02-02 20:02:20), 'Europe/Paris']
| extend utc_dt = datetime_local_to_utc(local_dt, tz)

Realização

local_dt tz utc_dt
2020-02-02 20:02:20.0000000 Europa/Paris 2020-02-02 19:02:20.0000000
2020-02-02 20:02:20.0000000 América/Chicago 2020-02-03 02:02:20.0000000
2020-02-02 20:02:20.0000000 EUA/Pacífico 2020-02-03 04:02:20.0000000

Observação

Normalmente, há um mapeamento 1:1 entre UTC e hora local, no entanto, há uma ambiguidade de tempo perto da transição do horário de verão. A tradução de local para UTC e depois de volta para local pode produzir um deslocamento de hora entre dois valores de data/hora locais se os relógios foram adiantados devido ao horário de verão.

range Local from datetime(2022-03-27 01:00:00.0000000) to datetime(2022-03-27 04:00:00.0000000) step 1h
| extend UTC=datetime_local_to_utc(Local, 'Europe/Brussels')
| extend BackToLocal=datetime_utc_to_local(UTC, 'Europe/Brussels')
| extend diff=Local-BackToLocal
Locais UTC (Tempo Universal Coordenado) BackToLocal difamar
2022-03-27 02:00:00.0000000 2022-03-27 00:00:00.0000000 2022-03-27 01:00:00.0000000 01:00:00
2022-03-27 01:00:00.0000000 2022-03-27 00:00:00.0000000 2022-03-27 01:00:00.0000000 00:00:00
2022-03-27 03:00:00.0000000 2022-03-27 01:00:00.0000000 2022-03-27 03:00:00.0000000 00:00:00
2022-03-27 04:00:00.0000000 2022-03-27 02:00:00.0000000 2022-03-27 04:00:00.0000000 00:00:00