datetime_local_to_utc()
適用於：✅Microsoft網狀架構✅Azure 數據✅總管 Azure 監視器✅Microsoft Sentinel
使用 時區規格，將本機日期時間轉換為 UTC 日期時間。
語法
datetime_local_to_utc(從,時區)
深入瞭解 語法慣例。
參數
| 姓名 | 類型 | 必要 | 描述 |
|---|---|---|---|
| from | datetime |
✔️ | 要轉換的本機日期時間。 |
| timezone | string |
✔️ | 所需日期時間的時區。 此值必須是其中一個支援的 時區。 |
傳回
UTC 日期時間，對應指定 timezone中的本機日期時間。
範例
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)
輸出
| local_dt | tz | utc_dt |
|---|---|---|
| 2020-02-02 20:02:20.0000000 | 歐洲/巴黎 | 2020-02-02 19:02:20.0000000 |
| 2020-02-02 20:02:20.0000000 | 美洲/芝加哥 | 2020-02-03 02:02:20.0000000 |
| 2020-02-02 20:02:20.0000000 | 美國/太平洋 | 2020-02-03 04:02:20.0000000 |
注意
一般而言，UTC 與當地時間之間有 1：1 的對應，但 DST 轉換有時間模棱兩可。 如果時鐘因為 DST 而進階，則從本機轉譯為 UTC，然後回到 local 可能會產生兩個本機日期時間值之間的小時位移。
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
| 本機 | UTC | BackToLocal | 差異 |
|---|---|---|---|
| 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 |
相關內容
- 若要從 UTC 轉換為本機，請參閱 datetime_utc_to_local（）
- 時區
- 支援的時區清單
- format_datetime()