Saltar para o conteúdo principal

Date.FromText

Cria uma Data a partir de formatos de Data locais, universais e personalizados.

Syntax​

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

Remarks​

Cria um valor de data a partir de uma representação textual.

  • text: um valor de texto a converter em data.
  • options: um record opcional que poderá ser fornecido para especificar propriedades adicionais. O record pode conter os campos seguintes:
    • Format: um valor text que indica o formato a utilizar. Para obter mais detalhes, aceda a https://go.microsoft.com/fwlink/?linkid=2180104 e https://go.microsoft.com/fwlink/?linkid=2180105. A omissão deste campo ou o fornecimento de null resulta na análise da data da melhor forma possível.
    • Culture: quando Format não é nulo, Culture controla alguns especificadores de formato. Por exemplo, em "en-US" "MMM" é "Jan", "Feb", "Mar", ..., enquanto em "ru-RU" "MMM" é "янв", "фев", "мар", .... Quando Format é null, Culture controla o formato predefinido a utilizar. Quando Culture é null ou é omitido, é utilizado Culture.Current.

Para suportar fluxos de trabalho legados, options também poderá ser um valor de texto. Tem o mesmo comportamento que options = [Format = null, Culture = options].

Examples​

Example #1​

Converter "2010-12-31" num valor date.

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

Result:

#date(2010, 12, 31)

Example #2​

Converter com um formato personalizado e a cultura alemã.

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

Result:

#date(2010, 12, 30)

Example #3​

Encontrar a data no calendário gregoriano que corresponde ao início de 1400 no calendário hijri.

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

Result:

#date(1979, 11, 20)

Example #4​

Converter as datas do texto italiano com meses abreviados na coluna Data Publicada em valores de data.

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"

Result:

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

Category​

Date