Saltar para o conteúdo principal

Time.ToText

Devolve uma representação textual do valor de hora.

Syntax​

Time.ToText(
    time as time,
    optional options as any,
    optional culture as text
) as text

Remarks​

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

  • Format: Um valor de text que indica o formato a utilizar. Aceda a 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 utilizando a predefinição definida pela Culture.
  • Culture: Quando o Format não é null, a Culture controla alguns especificadores de formato. Por exemplo, em "en-US", "tt" é "AM" ou "PM", ao passo que em "ar-EG", "tt" é "ص" ou "م". Quando o Format é null, a Culture controla o formato predefinido a utilizar. Quando Culture é null ou omitida, é utilizado Culture.Current.
Para suportar fluxos de trabalho legados, options e culture também podem ser valores de texto. O comportamento é idêntico ao caso em que options = [Format = options, Culture = culture].

Examples​

Example #1​

Converter <code>#time(01, 30, 25)</code> num valor de <code>text</code>. <i>O resultado pode variar dependendo da cultura atual.</i>

Time.ToText(#time(11, 56, 2))

Result:

"11:56 AM"

Example #2​

Converter com um formato personalizado e a cultura alemã.

Time.ToText(#time(11, 56, 2), [Format="hh:mm", Culture="de-DE"])

Result:

"11:56"

Example #3​

Converter com o formato de hora padrão.

Time.ToText(#time(11, 56, 2), [Format="T", Culture="de-DE"])

Result:

"11:56:02"

Category​

Time