Partilhar via


Data.FromText

Sintaxe

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

Acerca de

Cria um date valor a partir de uma representação textual, text. Um parâmetro opcional record , , optionspode ser fornecido para especificar propriedades adicionais. O record pode conter os seguintes campos:

  • Format: Um text valor que indica o formato a ser usado. Para mais detalhes, vá para https://go.microsoft.com/fwlink/?linkid=2180104 e https://go.microsoft.com/fwlink/?linkid=2180105. Omitir este campo ou fornecer null resultará na análise da data usando um melhor esforço.

  • Culture: Quando Format não é nulo, Culture controla alguns especificadores de formato. Por exemplo, em é , enquanto em "ru-RU""en-US""MMM""MMM" é ."Jan", "Feb", "Mar", ..."янв", "фев", "мар", ... Quando Format é null, Culture controla o formato padrão a ser usado. Quando Culture é ou omitido, Culture.Current é null usado.

Para suportar fluxos de trabalho herdados, options também pode ser um valor de texto. Isso tem o mesmo comportamento como se options = [Format = null, Culture = options].

Exemplo 1

Converta "2010-12-31" em um date valor.

Utilização

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

Saída

#date(2010, 12, 31)

Exemplo 2

Converta usando um formato personalizado e a cultura alemã.

Utilização

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

Saída

#date(2010, 12, 30)

Exemplo 3

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

Utilização

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

Saída

#date(1979, 11, 20)