DateTimeZone.ToText

Синтаксис

DateTimeZone.ToText(
    dateTimeZone as nullable datetimezone,
    optional options as any,
    optional culture as nullable text
) as nullable text

О нас

Возвращает текстовое представление dateTimeZone. Для указания дополнительных свойств может быть предоставлен необязательный параметр recordoptions. culture используется только для устаревших рабочих процессов. record может содержать следующие поля:

  • Format: значение text, указывающее используемый формат. Дополнительные сведения см. в строках стандартного формата даты и времени и строках пользовательского формата даты и времени. В случае пропуска этого поля или указания null форматирование даты будет выполняться с использованием значения по умолчанию, заданного параметром Culture.
  • Culture: когда Format не имеет значение NULL, Culture управляет некоторыми описателями формата. Например, в "en-US""MMM" это "Jan", "Feb", "Mar", ..., тогда как в "ru-RU""MMM" это "янв", "фев", "мар", .... Если Format имеет значение null, Culture определяет используемый формат по умолчанию. Если Culture равен null или null опущен, используется .

Для поддержки устаревших рабочих процессов options и culture могут также быть текстовыми значениями. Это аналогично тому, как если бы options = [Format = options, Culture = culture].

Пример 1

Преобразование #datetimezone(2010, 12, 31, 01, 30, 25, 2, 0) в text значение. Итоговые результаты могут зависеть от текущих культурных настроек.

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

DateTimeZone.ToText(#datetimezone(2010, 12, 31, 01, 30, 25, 2, 0))

Выходные данные

"12/31/2010 1:30:25 AM +02:00"

Пример 2

Преобразование с использованием пользовательского формата и немецкой локали.

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

DateTimeZone.ToText(#datetimezone(2010, 12, 30, 2, 4, 50.36973, -8,0), [Format="dd MMM yyyy HH:mm:ss.ffffff zzz", Culture="de-DE"])

Выходные данные

"30 Dez 2010 02:04:50.369730 -08:00"

Пример 3

Преобразуйте, используя шаблон ISO 8601.

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

DateTimeZone.ToText(#datetimezone(2000, 2, 8, 3, 45, 12, 2, 0),[Format="O", Culture="en-US"])

Выходные данные

"2000-02-08T03:45:12.0000000+02:00"