Date.FromText

Sintaxe

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

Sobre

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

  • Format: um valor text que indica o formato a ser usado. Para obter mais detalhes, acesse https://go.microsoft.com/fwlink/?linkid=2180104 e https://go.microsoft.com/fwlink/?linkid=2180105. Omitir esse 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 "en-US""MMM" é "Jan", "Feb", "Mar", ..., enquanto em "ru-RU""MMM" é "янв", "фев", "мар", .... Quando Format é null, Culture controla o formato padrão a ser usado. Quando Culture é null ou omitido, Culture.Current é usado.

Para dar suporte a fluxos de trabalho herdados, options também podem ser um valor de texto. Isso tem o mesmo comportamento que options = [Format = null, Culture = options].

Exemplo 1

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

Usage

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

Saída

#date(2010, 12, 31)

Exemplo 2

Faça a conversão usando um formato personalizado e a cultura alemã.

Usage

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

Saída

#date(2010, 12, 30)

Exemplo 3

Localize a data no calendário gregoriano que corresponde ao início de 1400 no calendário islâmico.

Usage

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

Saída

#date(1979, 11, 20)