DateTimeZone.ToText

  • Статья

Синтаксис

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

О программе

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

  • Format: значение text, указывающее используемый формат. Дополнительные сведения см. в https://go.microsoft.com/fwlink/?linkid=2180104 и https://go.microsoft.com/fwlink/?linkid=2180105. В случае пропуска этого поля или указания null форматирование даты будет выполняться с использованием значения по умолчанию, заданного параметром Culture.

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

Для поддержки устаревших рабочих процессов 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"