Date.From

Створює дату із заданого значення.

Syntax

Date.From(
    value as any,
    optional culture as text
) as date

Remarks

Повертає значення дати, використовуючи задане значення.

• value: значення, яке потрібно перетворити на дату. Якщо задане значення є значенням null, ця функція повертає значення null. Якщо задане значення є значенням date, повертається значення value. Значення наведених нижче типів можна перетворити на значення date:
  • text: значення date із текстового представлення. Докладні відомості див. в Date.FromText.
  • datetime: компонент дати в value.
  • datetimezone: компонент дати еквівалента місцевих дати й часу в value.
  • number: компонент дати еквівалента місцевих дати й часу числа з рухомою комою, невід’ємним компонентом якого є кількість днів до півночі або після неї, 30 грудня 1899 р., а дробова складова якої представляє час у цей день, розділений на 24. Наприклад, північ 31 грудня 1899 року представлено як 1.0; 6:00, 1 січня 1900 року представлено як 2.25; північ 29 грудня 1899 року представлено як -1.0; 6:00 29 грудня 1899 року представлено як -1.25. Базове значення – північ 30 грудня 1899 року. Мінімальне значення – північ 1 січня 0100 року. Максимальне значення – це останній момент 31 грудня 9999 року.
  • Якщо "value" є будь-якого іншого типу, повертається помилка.
• culture: культура заданого значення (наприклад, "en-US").

Examples

Example #1

Перетворення вказаних дати й часу на значення дати.

Date.From(#datetime(1899, 12, 30, 06, 45, 12))

Result:

#date(1899, 12, 30)

Example #2

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

Date.From(43910)

Result:

#date(2020, 3, 20)

Example #3

Перетворення текстових дат, написаних німецькою мовою, у стовпці "Дата публікації" на значення дат.

let
    Source = #table(type table [Account Code = text, Posted Date = text, Sales = number],
    {
        {"US-2004", "20 Januar 2023", 580},
        {"CA-8843", "18 Juli, 2023", 280},
        {"PA-1274", "12 Januar, 2022", 90},
        {"PA-4323", "14 April 2023", 187},
        {"US-1200", "14 Dezember, 2022", 350},
        {"PTY-507", "4 Juni, 2023", 110}
    }),
    #"Filtered rows" = Table.TransformColumns(
        Source,
        {"Posted Date", each Date.From(_, "de-DE"), type date}
    )
in
    #"Filtered rows"

Result:

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

Category

Date