Compartilhar via


DateTimeZone.ToText

Sintaxe

DateTimeZone.ToText(
    dateTimeZone as nullable datetimezone,
    optional options as any,
    optional culture as nullable text
) as nullable text

Sobre

Retorna uma representação textual de dateTimeZone. 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 * Cadeias de caracteres de formato de data e hora padrão e cadeias de caracteres de formato de data e hora personalizadas. 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 #datetimezone(2010, 12, 31, 01, 30, 25, 2, 0) em um valor text. A saída de resultado pode variar dependendo da cultura atual.

Usage

DateTimeZone.ToText(#datetimezone(2010, 12, 31, 01, 30, 25, 2, 0))

Saída

"12/31/2010 1:30:25 AM +02:00"

Exemplo 2

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

Usage

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

Saída

"30 Dez 2010 02:04:50.369730 -08:00"

Exemplo 3

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

Usage

DateTimeZone.ToText(#datetimezone(2000, 2, 8, 3, 45, 12, 2, 0),[Format="O", Culture="en-US"])

Saída

"2000-02-08T03:45:12.0000000+02:00"