Partager via


datetime_local_to_utc()

S’applique à : ✅Microsoft Fabric✅Azure Data ExplorerAzure MonitorMicrosoft Sentinel

Convertit le datetime local en datetime UTC à l’aide d’une spécification de fuseau horaire.

Syntaxe

datetime_local_to_utc(à partir du,fuseau horaire)

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Type Requise Description
from datetime ✔️ Datetime locale à convertir.
timezone string ✔️ Fuseau horaire de l’heure de date souhaitée. La valeur doit être l’un des fuseaux horaires pris en charge.

Retours

Datetime UTC qui correspond à l’heure de date locale dans le fichier spécifié timezone.

Exemple

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)

Sortie

local_dt tz utc_dt
2020-02-02 20:02:20.0000000 Europe/Paris 2020-02-02 19:02:20.0000000
2020-02-02 20:02:20.0000000 America/Chicago 2020-02-03 02:02:20.0000000
2020-02-02 20:02:20.0000000 États-Unis/Pacifique 2020-02-03 04:02:20.0000000

Remarque

Normalement, il existe un mappage de 1:1 entre l’heure UTC et l’heure locale, mais il existe une ambiguïté temporelle près de la transition DST. La traduction de local en UTC, puis de retour en local peut produire un décalage d’heure entre deux valeurs datetime locales si les horloges ont été avancées en raison de la DST.

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
Local UTC BackToLocal diff
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