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