Ler em inglês

Partilhar via


Date.From

Sintaxe

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

Sobre

Retorna um valor de data do valor fornecido.

  • value: O valor a ser coberto até uma data. Se o valor dado for null, esta função retornará null. Se o valor dado for date, value é retornado. Os valores dos seguintes tipos podem ser convertidos em um date valor:

    • text: Um date valor da representação textual. Consulte Date.FromText para obter detalhes.
    • datetime: O componente de data do value.
    • datetimezone: O componente de data do equivalente data/hora local de value.
    • number: O componente de data do equivalente data/hora de um número de vírgula flutuante cujo componente integral é o número de dias antes ou depois da meia-noite, 30 de dezembro de 1899, e cujo componente fracionário representa a hora nesse dia dividida por 24. Por exemplo, meia-noite, 31 de dezembro de 1899 é representado por 1,0; 6 A.M., 1 de janeiro de 1900 é representado por 2.25; meia-noite, 29 de dezembro de 1899 é representado por -1,0; e 6 A.M., 29 de dezembro de 1899 é representado por -1.25. O valor base é meia-noite, 30 de dezembro de 1899. O valor mínimo é meia-noite, 1 janeiro 0100. O valor máximo é o último momento de 31 de dezembro de 9999.

    Se value for de qualquer outro tipo, um erro será retornado.

  • culture: A cultura do valor dado (por exemplo, "en-US").

Exemplo 1

Converta a data e a hora especificadas em um valor de data.

Utilização

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

Saída

#date(1899, 12, 30)

Exemplo 2

Converta o número especificado em um valor de data.

Utilização

Date.From(43910)

Saída

#date(20/03/2020)

Exemplo 3

Converta as datas de texto em alemão na coluna Data de publicação em valores de data.

Utilização

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"

Saída

#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}
})