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

Date.ToText

Синтаксис

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

О программе

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

Преобразование #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"

Связанный контент

  • Last updated on