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


DateTime.ToText

Синтаксис

DateTime.ToText(dateTime as nullable datetime, optional options as any, optional culture as nullable text) as nullable text

О программе

Возвращает текстовое представление dateTime. Для указания дополнительных свойств может быть предоставлен необязательный параметр 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 или отсутствует, используется Culture.Current.

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

Пример 1

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

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

DateTime.ToText(#datetime(2010, 12, 31, 01, 30, 25))

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

"12/31/2010 1:30:25 AM"

Пример 2

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

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

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

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

"30 Dez 2010 02:04:50.369730"

Пример 3

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

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

DateTime.ToText(#datetime(2000, 2, 8, 3, 45, 12),[Format="yyyy-MM-dd'T'HH:mm:ss'Z'", Culture="en-US"])

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

"2000-02-08T03:45:12Z"