Saltar para o conteúdo principal

DateTimeZone.ToText

Devolve uma representação textual do valor datetimezone.

Syntax​

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

Remarks​

Devolve uma representação de texto de dateTimeZone. Um parâmetro opcional record options, poderá ser fornecido para especificar propriedades adicionais. culture é apenas utilizado para fluxos de trabalho de legado. O record pode conter os seguintes campos:

  • Format: Um valor text que indica o formato a utilizar. Para mais detalhes, aceda a https://go.microsoft.com/fwlink/?linkid=2180104 e https://go.microsoft.com/fwlink/?linkid=2180105. Omitir este campo ou fornecer null irá resultar na formatação da data utilizando a predifinição fornecida por Culture.
  • Culture: Quando Format não é nulo, Culture controla algumas especificações de formatos. Por exemplo, em "en-US" "MMM" é "Jan", "Feb", "Mar", ..., enquanto que em "ru-RU" "MMM" é "янв", "фев", "мар", .... Quando Format é null, Culture controla o formato predefindo a utilizar. Quando Culture é null ou omitido, Culture.Current é utilizado.
Para suportar fluxos de trabalho de legado, options e culture também poderão ser valores de texto. Isto tem o mesmo comportamento que se options = [Format = options, Culture = culture].

Examples​

Example #1​

Converter <code>#datetimezone(2010, 12, 31, 01, 30, 25, 2, 0)</code> num valor de <code>text</code>. <i>O resultado pode variar dependendo da cultura atual.</i>

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

Result:

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

Example #2​

Converter com um formato personalizado e a cultura alemã.

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

Result:

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

Example #3​

Converter com o padrão ISO 8601.

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

Result:

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

Category​

DateTimeZone