Перейти к основному содержимому

DateTimeZone.FromText

Создание datetimezone из локальных, универсальных и пользовательских форматов datetimezone.

Syntax​

DateTimeZone.FromText(
    text as text,
    optional options as any
) as datetimezone

Remarks​

Создает значение datetimezone из текстового представления text. При необходимости можно задать необязательный параметр options типа record для указания дополнительных свойств. В состав record могут входить следующие поля:

  • Format. Значение типа text, указывающее используемый формат. Дополнительные сведения: https://go.microsoft.com/fwlink/?linkid=2180104 и https://go.microsoft.com/fwlink/?linkid=2180105. Если пропустить это поле или указать NULL, распознавание даты будет выполняться по принципу наилучшего возможного варианта.
  • Culture: если Format не имеет значения NULL, Culture управляет определенными спецификаторами формата. Например, при использовании "en-US" значение "MMM" представляется как "Jan", "Feb", "Mar", …, тогда как для "ru-RU" значение "MMM" выглядит как "янв", "фев", "мар", …. Если Format имеет значение NULL, Culture задает формат, используемый по умолчанию. Если значение Culture равно NULL или пропущено, используется Culture.Current.
Для поддержки прежних версий рабочих процессов options также может быть текстовым значением. При этом происходит то же самое, что и при options = [Format = null, Culture = options].

Examples​

Example #1​

Преобразование <code>"2010-12-31T01:30:00-08:00"</code> в значение <code>datetimezone</code>.

DateTimeZone.FromText("2010-12-31T01:30:00-08:00")

Result:

#datetimezone(2010, 12, 31, 1, 30, 0, -8, 0)

Example #2​

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

DateTimeZone.FromText("30 Dez 2010 02:04:50.369730 +02:00", [Format="dd MMM yyyy HH:mm:ss.ffffff zzz", Culture="de-DE"])

Result:

#datetimezone(2010, 12, 30, 2, 4, 50.36973, 2, 0)

Example #3​

Преобразование с помощью ISO 8601.

DateTimeZone.FromText("2009-06-15T13:45:30.0000000-07:00", [Format="O", Culture="en-US"])

Result:

#datetimezone(2009, 6, 15, 13, 45, 30, -7, 0)

Category​

DateTimeZone