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

DateTimeZone.From

Синтаксис

DateTimeZone.From(value as any, optional culture as nullable text) as nullable datetimezone

О нас

Создает значение datetimezone из заданного значения.

  • value: значение, используемое для создания datetimezone.
  • culture: (Необязательно) Язык и региональные параметры, используемые при преобразовании значения (например, "en-US").

Значения следующих типов можно преобразовать в значение datetimezone:

  • text: возвращает datetimezone значение из текстового представления. Дополнительные сведения см. в DateTimeZone.FromText.
  • date: возвращает значение datetimezone с value компонентом даты в 12:00:00 AM качестве компонента времени и смещением, соответствующим местному часовом поясу.
  • datetime: возвращает значение datetimezone с value датой и смещением, соответствующим местному часовом поясу.
  • datetimezone: возвращает value.
  • time: возвращает datetimezone с датой, эквивалентной дате OLE Automation для 0 в качестве компонента даты, value в качестве компонента времени и корректировкой на местный часовой пояс. Дата автоматизации OLE состоит из числа с плавающей запятой, целочисленный компонент которого — это количество дней до полуночи, 30 декабря 1899 года, а дробный компонент которого представляет время на этот день, разделенное на 24. Например, полночь, 31 декабря 1899 года представлена как 1.0; 6 утра, 1 января 1900 года представлено как 2.25; полночь, 29 декабря 1899 года представлена как -1.0; и 6 утра, 29 декабря 1899 года представлено как -1.25. Базовое значение равно полуночи, 30 декабря 1899 года. Минимальное значение равно полуночи, 1 января 0100 г. Максимальное значение — последний момент 31 декабря 9999 года.
  • number: возвращает datetimezone значение с датой и временем, эквивалентной дате автоматизации OLE, выраженной value и смещением, соответствующим местному часовом поясу.
  • null: возвращает null.

Если value имеет любой другой тип, возвращается ошибка.

Значение смещения, соответствующего местному часовой поясу, отличается при локальном выполнении этой функции, а не в сети. При локальном запуске возвращается локальный часовой пояс. При запуске в режиме онлайн возвращается часовой пояс UTC (+00:00).

Пример 1

Преобразуйте текстовое представление даты, времени и часового пояса в значение datetimezone.

использование

DateTimeZone.From("2020-10-30T01:30:00-08:00")

Выход

#datetimezone(2020, 10, 30, 01, 30, 00, -8, 00)

Пример 2

Преобразуйте текстовое представление даты, времени и часового пояса бразильского португальского datetimezone в значение.

использование

DateTimeZone.From("13 de agosto de 2025 15:43:00 -03:00", "pt-BR")

Выход

#datetimezone(2025, 08, 13, 15, 43, 00, -3, 00)

Пример 3

Преобразуйте число, представляющее 1 января 2025 г. в 12:00 в datetimezone значение. Часовой пояс в результате зависит от того, выполняется ли пример локально или в сети.

использование

DateTimeZone.From(45658.5)

Выход

#datetimezone(2025, 01, 01, 12, 00, 00, 0, 00)

Связанное содержимое

  • Last updated on