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

Descrição

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

  • Um formato de data/hora predefinido que especifica com a enumeração DateTimeFormat. Para datas e horas, esta abordagem é preferencial, uma vez que se ajusta automaticamente ao idioma e à localização de cada utilizador.
  • Um formato personalizado, uma cadeia de texto que abrange marcadores de posição que descrevem como formatar o número ou o valor de data/hora. Os marcadores de posição definem o número de dígitos a mostrar, se devem ser utilizados separadores de agrupamento e como apresentar o nome de um mês. O PowerApps suporta um subconjunto dos marcadores de posição que o Microsoft Excel suporta.

Consulte working with dates and times (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 do mês e o dia da semana não são abreviados.
DateTimeFormat.LongDateTime Ano completo, mês, dia do mês e dia da semana, mais hora (relógio de 12 horas), minutos, segundos e designação AM/PM. Os nomes do mês e o dia da semana não são abreviados.
DateTimeFormat.LongDateTime24 Ano completo, mês, dia do mês e dia da semana, mais hora (relógio de 24 horas), minutos e segundos. Os nomes do mês e o dia da semana não são abreviados.
DateTimeFormat.LongTime Hora (relógio de 12 horas), minutos, segundos e designação AM/PM. Mesmo que ShortTime.
DateTimeFormat.LongTime24 Hora (relógio de 24 horas), minutos, segundos. Mesmo que ShortTime24.
DateTimeFormat.ShortDate Ano de quatro dígitos com mês de dois dígitos e dia do mês.
DateTimeFormat.ShortDateTime Ano de quatro dígitos com mês de dois dígitos e dia do mês, mais hora (relógio de 12 horas), minutos, segundos e designação AM/PM.
DateTimeFormat.ShortDateTime24 Ano de quatro dígitos com mês de dois dígitos e dia do mês, mais hora (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 Hora (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 utilizador atual e formatado de acordo com a norma ISO 8601.

Marcadores de posição de números

Marcador de posição Descrição
0 (zero) Mostra zeros insignificantes se existirem menos dígitos num número do que zeros existentes no formato. Por exemplo, utilize o formato #,00 se pretender apresentar 8,9 como 8,90.
# Segue as mesmas regras que 0 (zero). No entanto, Texto não devolve zeros adicionais se o número tiver menos dígitos em ambos os lados do decimal do que símbolos # no formato. Por exemplo, é apresentado 8,9 se o formato personalizado for #,## e o número a formatar for 8,9.
, (vírgula) Apresenta a vírgula decimal num número. Depende do idioma do formato personalizado, consulte global apps (aplicações globais) para obter mais detalhes.
, (vírgula) Apresenta o separador de agrupamento num número, frequentemente utilizado para milhares. O Texto separa os grupos por vírgulas se o formato tiver uma vírgula entre sinais de cardinal (#) ou zeros. Depende do idioma do formato personalizado, consulte global apps (aplicações globais) para obter mais detalhes.

Se um número tiver mais dígitos à direita da vírgula decimal do que marcadores de posição no formato, o número é arredondado para tantas casas decimais quantos marcadores de posição. Se existirem mais dígitos à esquerda da vírgula decimal do que marcadores de posição, os dígitos adicionais são apresentados. Se o formato tiver apenas sinais de cardinal (#) à esquerda da vírgula decimal, os números inferiores a 1 começam com uma vírgula decimal (por exemplo, ,47).

Marcadores de posição de data e hora

Marcador de posição Descrição
m Apresenta o mês como um número sem um zero à esquerda.
mm Apresenta o mês como um número com um zero à esquerda, quando necessário.
mmm Apresenta o mês como uma abreviatura (Jan a Dez).
mmmm Apresenta o mês como um nome completo (Janeiro a Dezembro).
d Apresenta o dia como um número sem um zero à esquerda.
dd Apresenta o dia como um número com um zero à esquerda, quando necessário.
ddd Apresenta o dia como uma abreviatura (Dom a Sáb).
dddd Apresenta o dia como um nome completo (Domingo a Sábado).
aa Apresenta o ano como um número de dois dígitos.
aaaa Apresenta o ano como um número de quatro dígitos.
h Apresenta a hora como um número sem um zero à esquerda.
hh Apresenta a hora como um número com um zero à esquerda, quando necessário. Se o formato tiver AM ou PM, a hora é apresentada com base no relógio de 12 horas. Caso contrário, a hora é apresentada com base no relógio de 24 horas.
m Apresenta o minuto como um número sem um zero à esquerda. Nota: o código m ou o mm tem de aparecer imediatamente a seguir ao código h ou hh, ou imediatamente antes do código ss; caso contrário, o Texto devolve o mês, em vez dos minutos.
mm Apresenta o minuto como um número com um zero à esquerda, quando necessário. Nota: o marcador de posição m ou o mm tem de aparecer imediatamente após o marcador de posição h ou hh, ou imediatamente antes do marcador de posição ss. Caso contrário, o Texto devolve o mês em vez dos minutos.
s Apresenta o segundo como um número sem um zero à esquerda.
ss Apresenta o segundo como um número com um zero à esquerda, quando necessário.
f Apresenta as frações de segundos.
AM/PM, am/pm, A/P, a/p Apresenta a hora com base no relógio de 12 horas. O Texto devolve "AM", "am", "A" ou "a" para horas da meia-noite ao meio-dia e "PM", "pm", "P" ou "p" para horas do meio-dia à meia-noite

Marcadores de posição literais

Pode incluir qualquer um dos carateres seguintes na sua cadeia de formato. Serão apresentados no resultado do Texto inalterados. Os carateres adicionais estão reservados para futuros marcadores de posição, pelo que não os deve utilizar.

Caráter Descrição
Qualquer símbolo de moeda Cifrão, símbolo de cêntimos, símbolo de euro, etc.
+ Sinal de adição
( Parêntese esquerdo
: Dois pontos
^ Acento circunflexo
' Apóstrofo
{ Chaveta esquerda
< Sinal menor que
= Sinal de igual
- Sinal de subtração
/ Barra
) Parêntese direito
& "E" comercial
~ Til
} Chaveta direita
> Sinal de maior que
  Caráter de espaço

Aplicações globais

A função de Texto tem conhecimento global. Para uma grande variedade de idiomas, esta sabe como escrever corretamente datas, horas, moedas e números. Para realizar a sua tarefa, necessita de duas informações:

  • O idioma do formato personalizado: para autores, como deve ser interpretado um formato personalizado? Os carateres de separação (. e ,) têm significados diferentes em diferentes idiomas. Isto é processado com um marcador de posição especial que contém uma etiqueta de idioma. Ainda mais simples, os formatos de data/hora predefinidos desconhecem o idioma.

  • O idioma do resultado: para os utilizadores, que idioma deverá ser utilizado no resultado da função? Os nomes dos meses e dos dias da semana têm de estar no idioma apropriado para o utilizador da aplicação. Isto é resolvido com um terceiro argumento opcional para a função de Texto.

Para ambos, o idioma é fornecido com uma etiqueta de idioma. Para ver a lista de tipos de idiomas suportados escreva Texto (1234, "",) na barra de fórmula ou avançada, veja e percorra a lista das regiões sugeridas para o terceiro argumento.

Marcador de posição de idioma de formato personalizado

Para especificar o idioma de formato personalizado, utilize:

Marcador de posição Descrição
[$-LanguageTag] A LanguageTag é uma etiqueta de idioma devolvida da função Idioma. Pode estar na forma somente de idioma, como [$-en] para inglês, ou também pode incluir a região, como [$-en-GB] para especificar a Grã-Bretanha.

O marcador de posição de idioma pode aparecer em qualquer lugar no formato personalizado, mas apenas uma vez.

Ao escrever uma fórmula, se não fornecer um marcador de posição de idioma e a cadeia de formato for ambígua de um ponto de vista global, a ferramenta de criação irá inserir automaticamente a etiqueta de idioma para o seu idioma atual.

[$-en-US] é assumido se este marcador de posição não estiver presente quando a aplicação é executada.

NOTA: numa versão futura, poderá alterar a sintaxe deste marcador de posição para evitar confusões com um marcador de posição semelhante, mas diferente, suportado pelo Excel.

Etiqueta de idioma do resultado

No resultado do Texto estão as cadeias traduzidas para as designações do mês, do dia da semana e AM/PM, bem como os separadores decimais e de grupo adequados.

Por predefinição, o Texto utiliza o idioma do utilizador que executa a aplicação. A função Idioma devolve a etiqueta de idioma para o utilizador atual. Pode substituir esta predefinição ao fornecer uma etiqueta de idioma para o terceiro argumento opcional para o Texto.

Sintaxe

Texto( Número, DateTimeFormatEnum [, ResultLanguageTag ])

  • Número - Necessário. O número ou o valor de data/hora a formatar.
  • DateTimeFormat - Necessário. Um membro da enumeração DateTimeFormat.
  • ResultLanguageTag - Opcional. A etiqueta de idioma a utilizar para o texto de resultado. Por predefinição, é utilizado o idioma do utilizador atual.

Texto( Número, CustomFormat [, ResultLanguageTag ])

  • Número - Necessário. O número ou o valor de data/hora a formatar.
  • CustomFormat - Necessário. Um ou mais marcadores de posição entre aspas duplas.
  • ResultLanguageTag - Opcional. A etiqueta de idioma a utilizar para o texto de resultado. Por predefinição, é utilizado o idioma do utilizador atual.

Exemplos

O utilizador que executa estas fórmulas encontra-se nos Estados Unidos e selecionou inglês como idioma. A função Idioma está a devolver "en-US".

Número

Fórmula Descrição Resultado
Texto ( 1234,59, "####,#" ) Formata o número com uma casa decimal. "1234,6"
Texto ( 8,9, "#,000" ) Preenche a parte decimal do número com zeros à direita, se necessário. "8,900"
Texto ( 0,631, "0,#" ) Aponta o número inteiro com zeros à esquerda, se necessário. "0,6"
Texto ( 12, "#,0#" )
Texto ( 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"
Texto ( 12000, "$ #,###" )
Texto ( 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
Texto ( Now(), DateTimeFormat.LongDate ) Formata como uma cadeia de data longa, no idioma e região do utilizador atual. "Segunda-feira, 23 de Novembro de 2015"
Texto ( Now(), DateTimeFormat.LongDateTime ) Formata como uma cadeia de data e hora longa, no idioma e região do utilizador atual, com um relógio de 12 horas. "Segunda-feira, 23 de Novembro de 2015 2:37:47 PM"
Texto ( Now(), DateTimeFormat.LongTime24 ) Formata como uma cadeia de hora longa, com um relógio de 24 horas. "14:37:47"
Texto ( Now(), DateTimeFormat.ShortDate ) Formata como uma cadeia de data curta, no idioma e região do utilizador atual. "11/23/2015"
Texto ( Now(), "d-mmm-yy" ) Formata com carateres de marcador de posição:
  • d para um dia do mês com um ou dois dígitos
  • - como um caráter literal copiado para o resultado
  • mmm para uma abreviatura de três letras do mês
  • - como outro caráter literal copiado para o resultado
  • aa para uma abreviatura de dois dígitos do ano
"23-Nov-15"

Aplicações globais

Fórmula Descrição Resultado
Texto ( 1234567.89, "[$-en-US]$ #,###" ) Interpreta , como um separador de agrupamento colocado a cada três carateres e $ como o símbolo de moeda. Como não tem casas decimais a apresentar, o valor é arredondado para o número inteiro superior seguinte. O [$-en-US] é opcional neste caso, porque esta é a predefinição. "$ 1,234,568"
Texto ( 1234567.89, "[$-es-ES]€ #,###" ) Interpreta , como um separador decimal e como o símbolo de moeda. Uma vez que o [$-fr-FR] só determina como é interpretada a cadeia de formato, o resultado irá utilizar os carateres da etiqueta de idioma predefinida "en-US": . (vírgula) para o separador decimal e $ para o símbolo de moeda. "$ 1234567.89"
Texto( 1234567.89, "[$-es-ES]€ #,###", "es-ES" ) Interpreta , como um separador decimal. A etiqueta de idioma do resultado foi definida como "fr-FR", o que resultará em , (vírgula) a ser utilizada como separador decimal e como o símbolo de moeda. "€ 1234567,89"
Texto ( Date(2016,1,31), "dddd mmmm d" ) Devolve o dia da semana, mês e dia do mês no idioma do utilizador atual. Uma vez que nenhum dos marcadores de posição depende do idioma, não é necessária uma etiqueta de idioma do texto de formato. "Sábado 31 de Janeiro"
Texto ( Date(2016,1,31), "dddd mmmm d", "es-ES" ) Devolve o dia da semana, o mês e o dia do mês no idioma "es-ES". "domingo enero 31"