Перейти к основному содержимому

Date.ToText

Возвращает текстовое представление значения даты.

Syntax​

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

Remarks​

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

Examples​

Example #1​

Преобразование <code>#date(2010, 12, 31)</code> в значение <code>text</code>. <i>Результат может зависеть от текущего языка и региональных параметров.</i>

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

Result:

"12/31/2010"

Example #2​

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

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

Result:

"31 Dez 2010"

Example #3​

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

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

Result:

"1420"

Category​

Date