Formata um número ou um valor de data/hora para exibição como uma cadeia de texto.

Descrição

A função Texto formata um número ou um valor de data/hora com base em um dos tipos de argumentos a seguir:

  • Um formato de data/hora predefinido, especificado usando a enumeração DateTimeFormat. Essa é a abordagem preferencial para datas e horas, pois se ajusta automaticamente ao idioma e local de cada usuário.
  • Um formato personalizado, uma cadeia de texto com espaços reservados que descrevem como formatar o número ou o valor de data/hora. Espaços reservados definem quantos dígitos podem ser mostrados, se separadores de agrupamento devem ser usados e como exibir o nome de um mês. O PowerApps dá suporte a um subconjunto de espaços reservados do Microsoft Excel.

Consulte Trabalhar com datas e horas para obter mais informações.

Formatos de data/hora predefinidos

Formato predefinido Descrição
DateTimeFormat.LongDate Ano completo, mês, dia do mês e dia da semana. Os nomes de meses e de dias da semana não são abreviados.
DateTimeFormat.LongDateTime Ano completo, mês, dia do mês e dia da semana, além de horas (relógio de 12 horas), minutos, segundos e designação AM/PM. Os nomes de meses e de dias da semana não são abreviados.
DateTimeFormat.LongDateTime24 Ano completo, mês, dia do mês e dia da semana, além de horas (relógio de 24 horas), minutos e segundos. Os nomes de meses e de dias da semana não são abreviados.
DateTimeFormat.LongTime Hora (relógio de 12 horas), minutos, segundos e designação AM/PM. O mesmo que ShortTime.
DateTimeFormat.LongTime24 Horas (relógio de 24 horas), minutos e segundos. O mesmo que ShortTime24.
DateTimeFormat.ShortDate Ano de quatro dígitos com mês e dia de dois dígitos.
DateTimeFormat.ShortDateTime Ano de quatro dígitos com mês e dia de dois dígitos, além de horas (relógio de 12 horas), minutos, segundos e designação AM/PM.
DateTimeFormat.ShortDateTime24 Ano de quatro dígitos com mês e dia de dois dígitos, além de horas (relógio de 24 horas), minutos e segundos.
DateTimeFormat.ShortTime Hora (relógio de 12 horas), minutos, segundos e designação AM/PM. Mesmo que LongTime.
DateTimeFormat.ShortTime24 Horas (relógio de 24 horas), minutos e segundos. Mesmo que LongTime24.
DateTimeFormat.UTC O valor de data/hora é convertido para UTC, com base no fuso horário do usuário atual e formatado de acordo com o padrão ISO 8601.

Espaços reservados em formato de número

Espaço reservado Descrição
0 (zero) Exibe zeros não significativos se um número tiver menos dígitos do que zeros no formato. Por exemplo, use o formato #.00 para exibir 8.9 como 8.90.
# Siga as mesmas regras do 0 (zero). No entanto, a função Texto não retorna zeros adicionais quando o número tem menos dígitos em ambos os lados da casa decimal do que símbolos # no formato. Por exemplo, 8.9 será exibido se o formato personalizado for #.## e o número para formatar for 8.9.
. (ponto) Exibe o ponto decimal em um número. Depende do idioma do formato personalizado, consulte aplicativos globais para obter mais detalhes.
, (vírgula) Exibe o separador de agrupamento em um número, geralmente usado para milhares. A função Texto separa grupos por vírgulas se o formato contiver uma vírgula entre sinais numéricos (#) ou zeros. Depende do idioma do formato personalizado, consulte aplicativos globais para obter mais detalhes.

Se um número tiver mais dígitos à direita da vírgula decimal do que espaços reservados no formato, ele será arredondado para a quantidade de casas decimais definida pelos espaços reservados. Se houver mais dígitos à esquerda da vírgula decimal do que espaços reservados, os dígitos adicionais serão exibidos. Se o formato contiver apenas sinais numéricos (#) à esquerda da vírgula decimal, números inferiores a 1 começarão com uma vírgula decimal (por exemplo, .47).

Espaços reservados de data e hora

Espaço reservado Descrição
m Exibe o mês como um número sem um zero à esquerda.
mm Exibe o mês como um número com um zero à esquerda.
mmm Exibe o mês como uma abreviação (jan a dez).
mmmm Exibe o mês como um nome completo (janeiro a dezembro).
d Exibe o dia como um número sem um zero à esquerda.
dd Exibe o dia como um número com um zero à esquerda.
ddd Exibe o dia como uma abreviatura (Sun a Sat).
dddd Exibe o dia como um nome completo (domingo a sábado).
aa Exibe o ano como um número de dois dígitos.
aaaa Exibe o ano como um número de quatro dígitos.
h Exibe a hora como um número sem um zero à esquerda.
hh Exibe a hora como um número com um zero à esquerda. Se o formato contiver AM ou PM, a hora será mostrada com base no relógio de 12 horas. Caso contrário, a hora será mostrada com base no relógio de 24 horas.
m Exibe o minuto como um número sem um zero à esquerda. Observação: O código m ou mm deve aparecer imediatamente após o código h ou hh, ou imediatamente antes do código ss; caso contrário, a função Texto retornará o mês em vez dos minutos.
mm Exibe o minuto como um número com um zero à esquerda quando apropriado. Observação: os espaços reservados m ou mm devem aparecer imediatamente após os espaços reservados h ou hh ou imediatamente antes do espaço reservado ss. Caso contrário, a função Texto retornará o mês em vez dos minutos.
s Exibe o segundo como um número sem um zero à esquerda.
ss Exibe o segundo como um número com um zero à esquerda quando apropriado.
f Exibe as frações de segundos.
AM/PM, am/pm, A/P, a/p Exibe a hora com base em um relógio de 12 horas. A função Texto retorna "AM", "am", "A" ou "a" para horários de meia-noite até meio-dia e "PM", "pm", "P" ou "p" para horários do meio-dia até meia-noite

Espaços reservados literais

É possível incluir esses caracteres na cadeia de formato. Eles aparecerão nos resultados da função Texto como são. Caracteres adicionais estão reservados para futuros espaços reservados, portanto, você não deve usá-los.

Caractere Descrição
Qualquer símbolo de moeda Símbolos do dólar, euro, de centavos etc.
+ Sinal de adição
( Parêntese esquerdo
: Dois pontos
^ Acento circunflexo
' Apóstrofo
{ Chave à esquerda
< Sinal de menor que
= Sinal de igual
- Sinal de subtração
/ Barra
) Parêntese direito
& E comercial
~ Til
} Chave à direita
> Sinal de maior que
  Caractere de espaço

Aplicativos globais

A função Texto tem sensibilidade global. Ela escreve corretamente datas, horas, moedas e números em uma ampla variedade de idiomas. Para que ela funcione, são necessárias duas informações:

  • O idioma do formato personalizado: para autores, como um formato personalizado deve ser interpretado? Os caracteres separadores (. e ,) têm significados diferentes entre os idiomas. Isso é tratado com um espaço reservado especial, que contém uma marca de idioma. Ainda mais fáceis, os formatos de data/hora predefinidos não dependem do idioma.

  • O idioma do resultado: para os usuários, qual idioma deve ser usado no resultado da função? Nomes de meses e dias da semana precisam estar no idioma apropriado para o usuário do aplicativo. Isso é tratado com um terceiro argumento opcional para a função Texto.

Para ambos, o idioma é fornecido com uma marca de idioma. Para ver a lista de idiomas com suporte, digite Text( 1234, "", ) na barra de fórmulas ou exibição avançada e percorra a lista de localidades sugerida para o terceiro argumento.

Espaço reservado de idioma com formato personalizado

Para especificar o idioma do formato personalizado, use:

Espaço reservado Descrição
[$-LanguageTag] LanguageTag é uma marca de idioma, conforme retornado pela função Idioma. A forma pode ser apenas o idioma, como [$-en] para inglês, ou também pode incluir a região, como em [$-en-GB] para especificar a Grã-Bretanha.

O espaço reservado de idioma pode aparecer em qualquer lugar no formato personalizado, mas apenas uma vez.

Ao escrever uma fórmula, se você não fornecer um espaço reservado de idioma e a cadeia de formato for ambígua do ponto de vista global, a ferramenta de criação inserirá automaticamente a marca de idioma para o idioma atual.

Adota-se o [$-en-US] se o espaço reservado não estiver presente ao executar o aplicativo.

OBSERVAÇÃO: em uma versão futura, a sintaxe desse espaço reservado pode ser alterada para evitar confusões com um espaço reservado similar, mas diferente, com suporte no Excel.

Marca de idioma de resultado

Como resultado da função Texto, aparecem cadeias traduzidas para mês, dia da semana e designações de AM/PM, bem como o grupo apropriado e separadores decimais.

Por padrão, a função Texto usa o idioma do usuário que executa o aplicativo. A função Idioma retorna a marca de idioma para o usuário atual. É possível substituir esse padrão fornecendo uma marca de idioma para o terceiro argumento opcional da função Texto.

Sintaxe

Text( Number, DateTimeFormatEnum [, ResultLanguageTag ] )

  • Number – Obrigatório. O número ou o valor de data/hora para o formato.
  • DateTimeFormat – Obrigatório. Membro da enumeração DateTimeFormat.
  • ResultLanguageTag – Opcional. A marca de idioma a ser usada para o texto do resultado. Por padrão, o idioma do usuário atual é utilizado.

Text( Number, CustomFormat [, ResultLanguageTag ] )

  • Number – Obrigatório. O número ou o valor de data/hora para o formato.
  • CustomFormat – Obrigatório. Um ou mais espaços reservados entre aspas duplas.
  • ResultLanguageTag – Opcional. A marca de idioma a ser usada para o texto do resultado. Por padrão, o idioma do usuário atual é utilizado.

Exemplos

O usuário que executa essas fórmulas está localizado nos Estados Unidos e selecionou o inglês como idioma. A função Idioma está retornando "en-US".

Número

Fórmula Descrição Resultado
Text( 1234.59, "####.#" ) Formata o número com uma casa decimal. "1234.6"
Text( 8.9, "#.000" ) Preenche a parte decimal do número com zeros à direita, se necessário. "8.900"
Text( 0.631, "0.#" ) Preenche a parte inteira do número com zeros à esquerda, se necessário. "0.6"
Text( 12, "#.0#" )
Text( 1234.568, "#.0#" )
Preenche a parte decimal do número com zeros para uma casa decimal e inclui uma segunda casa decimal, se fornecida. "12.0"
"1234.57"
Text( 12000, "$ #,###" )
Text( 1200000, "$ #,###" )
Coloca um separador de milhares a cada três dígitos e inclui um símbolo de moeda. "$ 12,000"
"$ 1,200,000"

Data/Hora

  • Às 2:37:47 PM, na segunda-feira, 23 de novembro de 2015
  • Fuso horário do Pacífico dos Estados Unidos (UTC-8)
Fórmula Descrição Resultado
Text( Now(), DateTimeFormat.LongDate ) Formatos como uma cadeia de data por extenso, no idioma e a localidade do usuário atual. "Segunda-feira, 23 de novembro de 2015"
Text( Now(), DateTimeFormat.LongDateTime ) Formatos como uma cadeia de data e hora por extenso, no idioma e a localidade do usuário atual, com um relógio de 12 horas. "Segunda-feira, 23 de novembro de 2015 2:37:47 PM"
Text( Now(), DateTimeFormat.LongTime24 ) Formatos como uma cadeia de hora completa, com um relógio de 24 horas. "14:37:47"
Text( Now(), DateTimeFormat.ShortDate ) Formatos como uma cadeia de data abreviada, no idioma e localidade do usuário atual. "11/23/2015"
Texto(Now(), "d-mmm-aa") Formatos usando caracteres de espaço reservado:
  • d para dia de dígito único ou de dois dígitos
  • - como um caractere literal copiado para o resultado
  • mmm para uma abreviatura de três letras do mês
  • - como outro caractere literal copiado para o resultado
  • aa para uma abreviatura de dois dígitos do ano
"23-Nov-15"

Aplicativos globais

Fórmula Descrição Resultado
Text( 1234567.89, "[$-en-US]$ #,###" ) Interpreta a , como um separador de agrupamento colocado a cada três caracteres e $ como o símbolo de moeda. Como decimais não são exibidos, o valor é arredondado para o número inteiro mais próximo. O [$en-US] é opcional nesse caso, pois esse é o padrão. "$ 1,234,568"
Text( 1234567.89, "[$-es-ES]€ #,###" ) Interpreta a , como um separador decimal e como o símbolo de moeda. Como o [$-fr-FR] apenas determina como a cadeia de formato é interpretada, o resultado usará os caracteres de marca de idioma padrão "en-US": . (ponto) como separador decimal e $ para o símbolo de moeda. "$ 1234567.89"
Text( 1234567.89, "[$-es-ES]€ #,###", "es-ES" ) Interpreta a , como um separador decimal. A marca de idioma de resultado foi definida como "fr-FR", o que resultará no uso da , (vírgula) como separador decimal e o como o símbolo de moeda. "€ 1234567,89"
Text( Date(2016,1,31), "dddd mmmm d" ) Retorna o dia da semana, mês e dia do mês no idioma do usuário atual. Como nenhum dos espaços reservados são dependentes do idioma, não há necessidade de uma marca de idioma de texto de formato de idioma. "31 de janeiro de sábado"
Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) Retorna o dia da semana, mês e dia do mês no idioma "es-ES". "domingo enero 31"