Перейти до основного вмісту

DateTimeZone.From

Створює із заданого значення дату й час із часовим поясом.

Syntax​

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

Remarks​

Створює datetimezone із заданого значення.

  • value: значення, що використовується для створення datetimezone.
  • culture: (необов’язково) культура, яка використовуватиметься для перетворення типів стовпців (наприклад, "uk-UA").

Значення наведених нижче типів можна перетворити на значення date:

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

Якщо "value" є будь-якого іншого типу, повертається помилка.

Значення зсуву, що відповідає місцевому часовому поясу, відрізняється під час виконання цієї функції локально й онлайн. При локальному запуску повертається місцевий часовий пояс. При запуску онлайн повертається часовий пояс UTC (+00:00).

Examples​

Example #1​

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

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

Result:

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

Example #2​

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

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

Result:

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

Example #3​

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

DateTimeZone.From(45658.5)

Result:

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

Category​

DateTimeZone