Share via


datetime_local_to_utc()

Converteert lokale datum/tijd naar UTC-datum/tijd met behulp van een tijdzone-specificatie.

Syntax

datetime_local_to_utc(Van,Uurzonee)

Meer informatie over syntaxisconventies.

Parameters

Naam Type Vereist Beschrijving
Van datetime ✔️ De lokale datum/tijd die moet worden geconverteerd.
timezone string ✔️ De tijdzone van de gewenste datum/tijd. De waarde moet een van de ondersteunde tijdzones zijn.

Retouren

Een UTC-datum/tijd die overeenkomt met de lokale datum/tijd in de opgegeven timezone.

Voorbeeld

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)

Uitvoer

local_dt Tz utc_dt
2020-02-02 20:02:20.0000000 Europa/Parijs 2020-02-02 19:02:20.0000000
2020-02-02 20:02:20.0000000 Amerika/Chicago 2020-02-03 02:02:20.0000000
2020-02-02 20:02:20.0000000 VS/Pacific 2020-02-03 04:02:20.0000000

Notitie

Normaal gesproken is er een 1:1-toewijzing tussen UTC en lokale tijd, maar er is een tijd ambiguïteit in de buurt van de overgang naar zomertijd. Vertalen van lokaal naar UTC en vervolgens terug naar lokaal kan een uurverschil tussen twee lokale datum/tijdwaarden produceren als de klokken zijn vervorderd vanwege zomertijd.

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
Lokaal 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