Time.ToText

Sintaxe

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

Sobre

Devolve uma representação textual de time. Um parâmetro opcional record , 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 text valor que indica o formato a ser usado. Para obter mais detalhes, vá para Cadeias de caracteres de formato de data e hora padrão e Cadeias de caracteres de formato de data e hora personalizadas. 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""tt" é "AM" or "PM", enquanto em "ar-EG""tt" é "ص" or "م". Quando Format é null, Culture controla o formato padrão a ser usado. Quando Culture é null ou omitido, Culture.Current é usado.

Para suportar 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].

Exemplo 1

Converta #time(01, 30, 25) em um text valor. A saída do resultado pode variar dependendo da cultura atual.

Utilização

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

Saída

"11:56 AM"

Exemplo 2

Converta usando um formato personalizado e a cultura alemã.

Utilização

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

Saída

"11:56"

Exemplo 3

Converta usando o formato de hora padrão.

Utilização

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

Saída

"11:56:02"

Conteúdo relacionado

• Como a cultura afeta a formatação de texto
• Cadeias de caracteres de formato de data e hora padrão
• Cadeias de caracteres de formato de data e hora personalizadas