Pular para o conteúdo principal

DateTime.ToText

Retorna uma representação textual do valor datetime.

Syntax​

DateTime.ToText(
    dateTime as datetime,
    optional options as any,
    optional culture as text
) as text

Remarks​

Retorna uma representação textual de dateTime. Um parâmetro record opcional, options, pode ser fornecido para especificar propriedades adicionais. culture só é usado para fluxos de trabalho herdados. 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 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 dar suporte a 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].

Examples​

Example #1​

Converta <code>#datetime(2010, 12, 31, 01, 30, 25)</code> em um valor <code>text</code>. <i>O resultado pode variar dependendo da cultura atual.</i>

DateTime.ToText(#datetime(2010, 12, 31, 01, 30, 25))

Result:

"12/31/2010 1:30:25 AM"

Example #2​

Converta usando um formato personalizado e a cultura alemã.

DateTime.ToText(#datetime(2010, 12, 30, 2, 4, 50.36973), [Format="dd MMM yyyy HH:mm:ss.ffffff", Culture="de-DE"])

Result:

"30 Dez 2010 02:04:50.369730"

Example #3​

Converta usando o padrão ISO 8601.

DateTime.ToText(#datetime(2000, 2, 8, 3, 45, 12),[Format="yyyy-MM-dd'T'HH:mm:ss'Z'", Culture="en-US"])

Result:

"2000-02-08T03:45:12Z"

Category​

DateTime