Partager via

datetime_local_to_utc() // convertit la date et l'heure locale en UTC

S’applique à : ✅Microsoft Fabric

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 Catégorie Requise Descriptif
du datetime ✔️ Datetime locale à convertir.
fuseau horaire string ✔️ Fuseau horaire de l’heure de date souhaitée. La valeur doit être l’un des fuseaux horaires pris en charge.

Retours

Retourne une datetime UTC qui correspond à l’heure de date locale dans le paramètre spécifié timezone.

Exemples

L’exemple suivant montre comment convertir une datetime locale en datetime UTC.

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 Amérique/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

Contenu connexe

  • Last updated on