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

Date.FromText

Создает дату из локальных, универсальных и пользовательских форматов дат.

Syntax​

Date.FromText(
    text as text,
    optional options as any
) as date

Remarks​

Создает значение date из текстового представления text. При необходимости можно задать необязательный параметр options типа record для указания дополнительных свойств. В состав record могут входить следующие поля:

  • Format. Значение типа text, указывающее используемый формат. Дополнительные сведения: https://go.microsoft.com/fwlink/?linkid=2180104 и https://go.microsoft.com/fwlink/?linkid=2180105. Если пропустить это поле или указать NULL, распознавание даты будет выполняться по принципу наилучшего возможного варианта.
  • Culture: если Format не имеет значения NULL, Culture управляет определенными спецификаторами формата. Например, при использовании "en-US" значение "MMM" представляется как "Jan", "Feb", "Mar", …, тогда как для "ru-RU" значение "MMM" выглядит как "янв", "фев", "мар", …. Если Format имеет значение NULL, Culture задает формат, используемый по умолчанию. Если значение Culture равно NULL или пропущено, используется Culture.Current.
Для поддержки прежних версий рабочих процессов options также может быть текстовым значением. При этом происходит то же самое, что и при options = [Format = null, Culture = options].

Examples​

Example #1​

Преобразование <code>2010-12-31</code> в значение <code>date</code>.

Date.FromText("2010-12-31")

Result:

#date(2010, 12, 31)

Example #2​

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

Date.FromText("30 Dez 2010", [Format="dd MMM yyyy", Culture="de-DE"])

Result:

#date(2010, 12, 30)

Example #3​

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

Date.FromText("1400", [Format="yyyy", Culture="ar-SA"])

Result:

#date(1979, 11, 20)

Category​

Date