datetime_local_to_utc()

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

Syntax

datetime_local_to_utc(De,Timezone)

Découvrez les conventions de syntaxe.

Paramètres

Nom	Type	Obligatoire	Description
from	datetime	✔️	Dateheure locale à convertir.
timezone	string	✔️	Fuseau horaire du dateheure souhaité. La valeur doit être l’un des fuseaux horaires pris en charge.

Retours

Datetime UTC qui correspond à la dateheure locale dans le spécifiétimezone.

Exemple

Exécuter la requête

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

Notes

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

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

Contenu connexe

• Pour convertir utc en local, consultez datetime_utc_to_local()
• Liste des fuseaux horaires pris en charge
• format_datetime()