Прочитать на английском

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


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" "янв", "фев", "мар", ..."ru-RU" ."Jan", "Feb", "Mar", ..."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"