datetime_local_to_utc()

タイム ゾーンの指定を使って、ローカルの datetime を UTC datetime に変換します。

構文

datetime_local_to_utc(差出人,タイムゾーン)

構文規則について詳しく知る。

パラメーター

名前	型	必須	説明
from	datetime	✔️	変換するローカルの datetime。
timezone	string	✔️	目的の datetime のタイムゾーン。 値は、サポートされている タイムゾーンのいずれかである必要があります。

戻り値

指定した timezone内のローカル datetime に対応する UTC datetime。

例

クエリを実行する

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

Note

通常、UTC と現地時刻の間には 1 対 1 のマッピングがありますが、DST 遷移の近くに時刻のあいまいさがあります。 DST が原因でクロックが拡張された場合、ローカルから UTC に変換してからローカルに戻すと、2 つのローカル datetime 値の間に時間オフセットが生成される場合があります。

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

関連コンテンツ

• UTC からローカルに変換するには、datetime_utc_to_local() を参照してください。
• サポートされているタイムゾーンの一覧
• format_datetime()