Partilhar via

Date.ToText

Sintaxe

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

Sobre

Devolve uma representação textual de date. Um parâmetro opcional record , options, pode ser fornecido para especificar propriedades adicionais. culture é usado apenas para fluxos de trabalho herdados. O record pode conter os seguintes campos:

  • Format: Um text valor que indica o formato a ser usado. Para obter mais detalhes, vá para Cadeias de caracteres de formato de data e hora padrão e Cadeias de caracteres de formato de data e hora personalizadas. Omitir este campo ou fornecer null resultará na formatação da data usando o padrão definido por Culture.

  • 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 suportar fluxos de trabalho herdados, options e culture também podem ser valores de texto. Isso tem o mesmo comportamento como se options = [Format = options, Culture = culture].

Exemplo 1

Converta #date(2010, 12, 31) em um text valor. A saída do resultado pode variar consoante a cultura atual.

Utilização

Date.ToText(#date(2010, 12, 31))

Saída

"12/31/2010"

Exemplo 2

Converter usando um formato próprio e a cultura alemã.

Utilização

Date.ToText(#date(2010, 12, 31), [Format="dd MMM yyyy", Culture="de-DE"])

Saída

"31 Dez 2010"

Exemplo 3

Encontre o ano no calendário Hijri que corresponde a 1 de janeiro de 2000 no calendário gregoriano.

Utilização

Date.ToText(#date(2000, 1, 1), [Format="yyyy", Culture="ar-SA"])

Saída

"1420"

Conteúdo relacionado

  • Last updated on