datetime_local_to_utc()
Область применения: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft 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 |
Связанный контент
- Сведения о преобразовании из UTC в локальный см. в разделе datetime_utc_to_local()
- Часовые пояса
- Список поддерживаемых часовых поясов
- format_datetime()