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


Date.FromText

Синтаксис

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

О программе

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

  • text: текстовое значение для преобразования в дату.

  • options: необязательный record атрибут, который можно предоставить для указания дополнительных свойств. record может содержать следующие поля:

    • Format: значение text, указывающее используемый формат. Дополнительные сведения см. в строках стандартного формата даты и времени и настраиваемых строк формата даты и времени. Опущение этого поля или предоставление 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)

Пример 4

Преобразуйте даты итальянского текста с сокращенными месяцами в столбце "Дата публикации" в значения даты.

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

let
    Source = #table(type table [Account Code = text, Posted Date = text, Sales = number],
    {
        {"US-2004", "20 gen. 2023", 580},
        {"CA-8843", "18 lug. 2024", 280},
        {"PA-1274", "12 gen. 2023", 90},
        {"PA-4323", "14 apr. 2023", 187},
        {"US-1200", "14 dic. 2023", 350},
        {"PTY-507", "4 giu. 2024", 110}
    }),
    #"Converted Date" = Table.TransformColumns(
        Source, 
        {"Posted Date", each Date.FromText(_, [Culture = "it-IT"]), type date}
    )
in
    #"Converted Date"

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

#table(type table [Account Code = text, Posted Date = date, Sales = number],
{
    {"US-2004", #date(2023, 1, 20), 580},
    {"CA-8843", #date(2024, 7, 18), 280},
    {"PA-1274", #date(2023, 1, 12), 90},
    {"PA-4323", #date(2023, 4, 14), 187},
    {"US-1200", #date(2023, 12, 14), 350},
    {"PTY-507", #date(2024, 6, 4), 110}
})