Pular 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 date a partir de uma representação textual, text. Um parâmetro opcional record, options, pode ser fornecido para especificar propriedades adicionais. O record pode conter os seguintes campos:

  • Format: Um valor text 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 este campo ou fornecer null resultará na análise da data usando o melhor esforço 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 padrão a ser usado. Quando Culture é null ou omitido, Culture.Current é usado.
Para oferecer suporte a fluxos de trabalho legados, options também pode ser um valor de texto. Isso tem o mesmo comportamento como se options = [Format = null, Culture = options].

Examples​

Example #1​

Converta <code>"2010-12-31"</code> em um valor <code>date</code>.

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

Result:

#date(2010, 12, 31)

Example #2​

Converta usando 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​

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

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

Result:

#date(1979, 11, 20)

Category​

Date