datetime_local_to_utc()
Преобразует локальное время даты и времени в формате UTC с помощью спецификации часового пояса.
Синтаксис
datetime_local_to_utc(
От,
Timezone)
Дополнительные сведения о соглашениях о синтаксисе.
Параметры
Имя | Тип | Обязательно | Описание |
---|---|---|---|
from | datetime |
✔️ | Локальное значение даты и времени для преобразования. |
Timezone | string |
✔️ | Часовой пояс требуемого значения datetime. Значение должно быть одним из поддерживаемых часовых поясов. |
Возвращаемое значение
Дата и время в формате UTC, соответствующее локальному значению datetime в указанном 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, однако при переходе на переход на местное время существует неоднозначность. При переводе из локального в UTC, а затем обратно в локальный может возникнуть часовое смещение между двумя локальными значениями даты и времени, если часы были перенесены из-за переходного времени.
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()
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по