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

Date.FromText

  • Статья

Синтаксис

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

О программе

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

Пример 1

Преобразование "2010-12-31" в date значение.

Использование

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

Выходные данные

#date(2010, 12, 31)

Пример 2

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

Использование

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

Выходные данные

#date(2010, 12, 30)

Пример 3

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

Использование

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

Выходные данные

#date(1979, 11, 20)