Ler em inglês

Compartilhar via


DateTime.ToText

Sintaxe

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

Sobre

Retorna uma representação textual de dateTime. Um parâmetro de record opcional, 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 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 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 que options = [Format = options, Culture = culture].

Exemplo 1

Converter #datetime(2010, 12, 31, 01, 30, 25) em um valor text. A saída de resultado pode variar dependendo da cultura atual.

Usage

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

Saída

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

Exemplo 2

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

Usage

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

Saída

"30 Dez 2010 02:04:50.369730"

Exemplo 3

Faça a conversão usando o padrão ISO 8601.

Usage

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

Saída

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