Поделиться через


datetime_local_to_utc()

Область применения: ✅Microsoft Fabric✅Azure Data ExplorerAzure MonitorMicrosoft Sentinel

Преобразует локальное время даты и времени в формате UTC с помощью спецификации часового пояса.

Синтаксис

datetime_local_to_utc(из,часового пояса)

Дополнительные сведения о соглашениях синтаксиса.

Параметры

Имя (название) Type Обязательно Описание
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

Примечание.

Как правило, существует сопоставление 1:1 между UTC и местным временем, однако существует неоднозначность времени вблизи перехода DST. Преобразование из локального в UTC, а затем обратно на локальный может привести к смещению часов между двумя локальными значениями даты и времени, если часы были расширены из-за 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