Date.ToText

Синтаксис

Date.ToText(date as nullable date, optional options as any, optional culture as nullable text) as nullable text

О программе

Возвращает текстовое представление date. Для указания дополнительных свойств может быть предоставлен необязательный параметр recordoptions. 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" указывается как "Jan", "Feb", "Mar", ..., а в "ru-RU""MMM" — как "янв", "фев", "мар", .... Если Format имеет значение null, Culture определяет используемый формат по умолчанию. Если Culture имеет значение null или пропущен, используется Culture.Current.

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

Пример 1

Преобразование #date(2010, 12, 31) в text значение. Итоговые выходные данные могут зависеть от текущего языка и региональных параметров.

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

Date.ToText(#date(2010, 12, 31))

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

"12/31/2010"

Пример 2

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

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

Date.ToText(#date(2010, 12, 31), [Format="dd MMM yyyy", Culture="de-DE"])

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

"31 Dez 2010"

Пример 3

Поиск года в календаре Хиджра, который соответствует 1 января 2000 года в григорианском календаре.

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

Date.ToText(#date(2000, 1, 1), [Format="yyyy", Culture="ar-SA"])

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

"1420"