Função de Texto no PowerAppsText function in PowerApps

Formata um número ou um valor de data/hora para apresentação como uma cadeia de texto.Formats a number or a date/time value for display as a string of text.

DescriçãoDescription

A função de Texto formata um número ou um valor de data/hora com base num dos seguintes tipos de argumentos:The Text function formats a number or a date/time value based on one of these types of arguments:

  • Um formato de data/hora predefinido que especifica com a enumeração DateTimeFormat.A predefined date/time format, which you specify by using the DateTimeFormat enumeration. Para datas e horas, esta abordagem é preferencial, uma vez que se ajusta automaticamente ao idioma e à localização de cada utilizador.For dates and times, this approach is preferred as it automatically adjusts to each user's language and location.
  • 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.A custom format, a string of text that comprises placeholders that describe how to format the number or the date/time value. 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.Placeholders define how many digits to show, whether grouping separators should be used, and how to display the name of a month. O PowerApps suporta um subconjunto dos marcadores de posição que o Microsoft Excel suporta.PowerApps supports a subset of the placeholders that Microsoft Excel does.

Consulte working with dates and times (trabalhar com datas e horas), para obter mais informações.See working with dates and times for more information.

Formatos de data/hora predefinidosPredefined date/time formats

Formato PredefinidoPredefined Format DescriçãoDescription
DateTimeFormat.LongDateDateTimeFormat.LongDate Ano completo, mês, dia do mês e dia da semana.Full year, month, day of the month, and day of the week. Os nomes do mês e o dia da semana não são abreviados.The names of the month and the day of the week aren't abbreviated.
DateTimeFormat.LongDateTimeDateTimeFormat.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.Full year, month, day of the month, and day of the week, plus hour (12-hour clock), minutes, seconds, and AM/PM designation. Os nomes do mês e o dia da semana não são abreviados.The names of the month and the day of the week aren't abbreviated.
DateTimeFormat.LongDateTime24DateTimeFormat.LongDateTime24 Ano completo, mês, dia do mês e dia da semana, mais hora (relógio de 24 horas), minutos e segundos.Full year, month, day of the month, and day of the week, plus hour (24-hour clock), minutes, and seconds. Os nomes do mês e o dia da semana não são abreviados.The names of the month and the day of the week aren't abbreviated.
DateTimeFormat.LongTimeDateTimeFormat.LongTime Hora (relógio de 12 horas), minutos, segundos e designação AM/PM.Hour (12-hour clock), minutes, seconds, and AM/PM designation. Mesmo que ShortTime.Same as ShortTime.
DateTimeFormat.LongTime24DateTimeFormat.LongTime24 Hora (relógio de 24 horas), minutos, segundos.Hour (24-hour clock), minutes, seconds. Mesmo que ShortTime24.Same as ShortTime24.
DateTimeFormat.ShortDateDateTimeFormat.ShortDate Ano de quatro dígitos com mês de dois dígitos e dia do mês.Four-digit year with two-digit month and day of the month.
DateTimeFormat.ShortDateTimeDateTimeFormat.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.Four-digit year with two-digit month and day of the month, plus hour (12-hour clock), minutes, seconds, and AM/PM designation.
DateTimeFormat.ShortDateTime24DateTimeFormat.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.Four-digit year with two-digit month and day of the month, plus hour (24-hour clock), minutes, and seconds.
DateTimeFormat.ShortTimeDateTimeFormat.ShortTime Hora (relógio de 12 horas), minutos, segundos e designação AM/PM.Hour (12-hour clock), minutes, seconds, and AM/PM designation. Mesmo que LongTime.Same as LongTime.
DateTimeFormat.ShortTime24DateTimeFormat.ShortTime24 Hora (relógio de 24 horas), minutos e segundos.Hour (24-hour clock), minutes, and seconds. Mesmo que LongTime24.Same as LongTime24.
DateTimeFormat.UTCDateTimeFormat.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.The date/time value is converted to UTC based on the current user's time zone and formatted according to the ISO 8601 standard.

Marcadores de posição de númerosNumber placeholders

Marcador de posiçãoPlaceholder DescriçãoDescription
0 (zero)0 (zero) Mostra zeros insignificantes se existirem menos dígitos num número do que zeros existentes no formato.Displays insignificant zeros if a number has fewer digits than there are zeros in the format. Por exemplo, utilize o formato #,00 se pretender apresentar 8,9 como 8,90.For example, use the format #.00 if you want to display 8.9 as 8.90.
# Segue as mesmas regras que 0 (zero).Follows the same rules as the 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.However, Text doesn't return extra zeros when the number has fewer digits on either side of the decimal than there are # symbols in the format. Por exemplo, é apresentado 8,9 se o formato personalizado for #,## e o número a formatar for 8,9.For example, 8.9 is displayed if the custom format is #.## and the number to format is 8.9.
,. (vírgula)(period) Apresenta a vírgula decimal num número.Displays the decimal point in a number. Depende do idioma do formato personalizado, consulte global apps (aplicações globais) para obter mais detalhes.Depends on the language of the custom format, see global apps for more details.
, (vírgula), (comma) Apresenta o separador de agrupamento num número, frequentemente utilizado para milhares.Displays the grouping separator in a number, often used for thousands. O Texto separa os grupos por vírgulas se o formato tiver uma vírgula entre sinais de cardinal (#) ou zeros.Text separates groups by commas if the format contains a comma that's enclosed by number signs (#) or by zeros. Depende do idioma do formato personalizado, consulte global apps (aplicações globais) para obter mais detalhes.Depends on the language of the custom format, see global apps for more details.

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.If a number has more digits to the right of the decimal point than there are placeholders in the format, the number rounds to as many decimal places as there are placeholders. Se existirem mais dígitos à esquerda da vírgula decimal do que marcadores de posição, os dígitos adicionais são apresentados.If there are more digits to the left of the decimal point than there are placeholders, the extra digits are displayed. 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).If the format contains only number signs (#) to the left of the decimal point, numbers less than 1 start with a decimal point (for example, .47).

Marcadores de posição de data e horaDate and time placeholders

Marcador de posiçãoPlaceholder DescriçãoDescription
mm Apresenta o mês como um número sem um zero à esquerda.Displays the month as a number without a leading zero.
mmmm Apresenta o mês como um número com um zero à esquerda, quando necessário.Displays the month as a number with a leading zero when appropriate.
mmmmmm Apresenta o mês como uma abreviatura (Jan a Dez).Displays the month as an abbreviation (Jan to Dec).
mmmmmmmm Apresenta o mês como um nome completo (Janeiro a Dezembro).Displays the month as a full name (January to December).
dd Apresenta o dia como um número sem um zero à esquerda.Displays the day as a number without a leading zero.
dddd Apresenta o dia como um número com um zero à esquerda, quando necessário.Displays the day as a number with a leading zero when appropriate.
dddddd Apresenta o dia como uma abreviatura (Dom a Sáb).Displays the day as an abbreviation (Sun to Sat).
dddddddd Apresenta o dia como um nome completo (Domingo a Sábado).Displays the day as a full name (Sunday to Saturday).
aayy Apresenta o ano como um número de dois dígitos.Displays the year as a two-digit number.
aaaayyyy Apresenta o ano como um número de quatro dígitos.Displays the year as a four-digit number.
hh Apresenta a hora como um número sem um zero à esquerda.Displays the hour as a number without a leading zero.
hhhh Apresenta a hora como um número com um zero à esquerda, quando necessário.Displays the hour as a number with a leading zero when appropriate. Se o formato tiver AM ou PM, a hora é apresentada com base no relógio de 12 horas.If the format contains AM or PM, the hour is shown based on the 12-hour clock. Caso contrário, a hora é apresentada com base no relógio de 24 horas.Otherwise, the hour is shown based on the 24-hour clock.
mm Apresenta o minuto como um número sem um zero à esquerda.Displays the minute as a number without a leading zero. 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.Note: The m or the mm code must appear immediately after the h or hh code or immediately before the ss code; otherwise, Text returns the month instead of minutes.
mmmm Apresenta o minuto como um número com um zero à esquerda, quando necessário.Displays the minute as a number with a leading zero when appropriate. 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.Note: The m or the mm placeholder must appear immediately after the h or hh placeholder or immediately before the ss placeholder. Caso contrário, o Texto devolve o mês em vez dos minutos.Otherwise, Text returns the month instead of minutes.
ss Apresenta o segundo como um número sem um zero à esquerda.Displays the second as a number without a leading zero.
ssss Apresenta o segundo como um número com um zero à esquerda, quando necessário.Displays the second as a number with a leading zero when appropriate.
ff Apresenta as frações de segundos.Displays the fractions of seconds.
AM/PM, am/pm, A/P, a/pAM/PM, am/pm, A/P, a/p Apresenta a hora com base no relógio de 12 horas.Displays the hour based on a 12-hour clock. 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-noiteText returns "AM", "am", "A", or "a" for times from midnight until noon and "PM", "pm", "P", or "p" for times from noon until midnight

Marcadores de posição literaisLiteral placeholders

Pode incluir qualquer um dos carateres seguintes na sua cadeia de formato.You can include any of these characters in your format string. Serão apresentados no resultado do Texto inalterados.They will appear in the result of Text as is. Os carateres adicionais estão reservados para futuros marcadores de posição, pelo que não os deve utilizar.Additional characters are reserved for future placeholders, so you shouldn't use them.

CaráterCharacter DescriçãoDescription
Qualquer símbolo de moedaAny currency symbol Cifrão, símbolo de cêntimos, símbolo de euro, etc.Dollar sign, cents sign, euro sign, etc.
+ Sinal de adiçãoPlus sign
(( Parêntese esquerdoLeft parenthesis
:: Dois pontosColon
^ Acento circunflexoCircumflex accent (caret)
'' ApóstrofoApostrophe
{{ Chaveta esquerdaLeft curly bracket
< Sinal menor queLess-than sign
= Sinal de igualEqual sign
- Sinal de subtraçãoMinus sign
/ BarraSlash mark
)) Parêntese direitoRight parenthesis
& "E" comercialAmpersand
~ TilTilde
}} Chaveta direitaRight curly bracket
> Sinal de maior queGreater-than sign
  Caráter de espaçoSpace character

Aplicações globaisGlobal apps

A função de Texto tem conhecimento global.The Text function is globally aware. Para uma grande variedade de idiomas, esta sabe como escrever corretamente datas, horas, moedas e números.For a wide array of languages, it knows how to properly write out dates, times, currencies, and numbers. Para realizar a sua tarefa, necessita de duas informações:To do its job, it needs two pieces of information:

  • O idioma do formato personalizado: para autores, como deve ser interpretado um formato personalizado?The language of the custom format: For authors, how should a custom format be interpreted? Os carateres de separação (.The separator characters (. e ,) têm significados diferentes em diferentes idiomas.and ,) have different meanings in different languages. Isto é processado com um marcador de posição especial que contém uma etiqueta de idioma.This is handled with a special placeholder containing a language tag. Ainda mais simples, os formatos de data/hora predefinidos desconhecem o idioma.Even easier, the predefined date/time formats are language agnostic.
  • O idioma do resultado: para os utilizadores, que idioma deverá ser utilizado no resultado da função?The language of the result: For users, what language should be used in the result of the function? Os nomes dos meses e dos dias da semana têm de estar no idioma apropriado para o utilizador da aplicação.Names for months and weekdays need to be in the appropriate language for the user of the app. Isto é resolvido com um terceiro argumento opcional para a função de Texto.This is handled with a third optional argument to the Text function.

Para ambos, o idioma é fornecido com uma etiqueta de idioma.For both, the language is provided with a language tag. 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.To see the list of supported languages type Text( 1234, "", ) in the formula bar or advanced view and scroll through the list of locales suggested for the third argument.

Marcador de posição de idioma de formato personalizadoCustom format language placeholder

Para especificar o idioma de formato personalizado, utilize:To specify the language of the custom format, use:

Marcador de posiçãoPlaceholder DescriçãoDescription
[$-LanguageTag][$-LanguageTag] A LanguageTag é uma etiqueta de idioma devolvida da função Idioma.LanguageTag is a language tag as returned from the Language function. 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.It can be in the form of just the language such as [$-en] for English, or it can also include the region such as [$-en-GB] to further specify Great Britain.

O marcador de posição de idioma pode aparecer em qualquer lugar no formato personalizado, mas apenas uma vez.The language placeholder can appear anywhere in the custom format but only once.

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.While writing a formula, if you do not provide a language placeholder and the format string is ambiguous from a global standpoint, the authoring tool will automatically insert the language tag for your current language.

[$-en-US] é assumido se este marcador de posição não estiver presente quando a aplicação é executada.[$-en-US] is assumed if this placeholder is not present when your app is run.

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.NOTE: In a future version, the syntax of this placeholder may change to avoid confusion with a similar, but different, placeholder supported by Excel.

Etiqueta de idioma do resultadoResult language tag

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.Appearing in the result of Text are translated strings for month, weekday, and AM/PM designations, as well as the appropriate group and decimal separators.

Por predefinição, o Texto utiliza o idioma do utilizador que executa a aplicação.By default, Text uses the language of the user running the app. A função Idioma devolve a etiqueta de idioma para o utilizador atual.The Language function returns the language tag for the current user. Pode substituir esta predefinição ao fornecer uma etiqueta de idioma para o terceiro argumento opcional para o Texto.You can override this default by supplying a language tag for the optional third argument to Text.

SintaxeSyntax

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

  • Número - Necessário.Number - Required. O número ou o valor de data/hora a formatar.The number or the date/time value to format.
  • DateTimeFormat - Necessário.DateTimeFormat - Required. Um membro da enumeração DateTimeFormat.A member of the DateTimeFormat enumeration.
  • ResultLanguageTag - Opcional.ResultLanguageTag - Optional. A etiqueta de idioma a utilizar para o texto de resultado.The language tag to use for the result text. Por predefinição, é utilizado o idioma do utilizador atual.By default, the language of the current user is used.

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

  • Número - Necessário.Number - Required. O número ou o valor de data/hora a formatar.The number or the date/time value to format.
  • CustomFormat - Necessário.CustomFormat - Required. Um ou mais marcadores de posição entre aspas duplas.One or more placeholders enclosed in double quotation marks.
  • ResultLanguageTag - Opcional.ResultLanguageTag - Optional. A etiqueta de idioma a utilizar para o texto de resultado.The language tag to use for the result text. Por predefinição, é utilizado o idioma do utilizador atual.By default, the language of the current user is used.

ExemplosExamples

O utilizador que executa estas fórmulas encontra-se nos Estados Unidos e selecionou inglês como idioma.The user running these formulas is located in the United States and has selected English as their language. A função Idioma está a devolver "en-US".The Language function is returning "en-US".

NúmeroNumber

FórmulaFormula DescriçãoDescription ResultadoResult
Texto ( 1234,59, "####,#" )Text( 1234.59, "####.#" ) Formata o número com uma casa decimal.Formats the number with one decimal place. "1234,6""1234.6"
Texto ( 8,9, "#,000" )Text( 8.9, "#.000" ) Preenche a parte decimal do número com zeros à direita, se necessário.Pads the decimal portion of the number with trailing zeros, if needed. "8,900""8.900"
Texto ( 0,631, "0,#" )Text( 0.631, "0.#" ) Aponta o número inteiro com zeros à esquerda, se necessário.Pads the whole portion of the number with leading zeros, if needed. "0,6""0.6"
Texto ( 12, "#,0#" )Text( 12, "#.0#" )
Texto ( 1234,568, "#,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.Pads the decimal portion of the number with zeros for one decimal place, and includes a second decimal place if supplied. "12,0""12.0"
"1234,57""1234.57"
Texto ( 12000, "$ #,###" )Text( 12000, "$ #,###" )
Texto ( 1200000, "$ #,###" )Text( 1200000, "$ #,###" )
Coloca um separador de milhares a cada três dígitos e inclui um símbolo de moeda.Places a thousands separator every three digits, and includes a currency symbol. "$ 12,000""$ 12,000"
"$ 1,200,000""$ 1,200,000"

Data/HoraDate/Time

  • Às 2:37:47 PM na Segunda-feira, 23 de Novembro de 2015At 2:37:47 PM on Monday, November 23, 2015
  • Fuso Horário do Pacífico dos Estados Unidos (UTC-8)United States Pacific Time Zone (UTC-8)
FórmulaFormula DescriçãoDescription ResultadoResult
Texto ( Now(), DateTimeFormat.LongDate )Text( Now(), DateTimeFormat.LongDate ) Formata como uma cadeia de data longa, no idioma e região do utilizador atual.Formats as a long date string, in the language and locale of the current user. "Segunda-feira, 23 de Novembro de 2015""Monday, November 23, 2015"
Texto ( Now(), DateTimeFormat.LongDateTime )Text( 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.Formats as a long date and time string, in the language and locale of the current user, using a 12-hour clock. "Segunda-feira, 23 de Novembro de 2015 2:37:47 PM""Monday, November 23, 2015 2:37:47 PM"
Texto ( Now(), DateTimeFormat.LongTime24 )Text( Now(), DateTimeFormat.LongTime24 ) Formata como uma cadeia de hora longa, com um relógio de 24 horas.Formats as a long time string, using a 24-hour clock. "14:37:47""14:37:47"
Texto ( Now(), DateTimeFormat.ShortDate )Text( Now(), DateTimeFormat.ShortDate ) Formata como uma cadeia de data curta, no idioma e região do utilizador atual.Formats as a short date string, in the language and locale of the current user. "11/23/2015""11/23/2015"
Texto ( Now(), "d-mmm-yy" )Text( Now(), "d-mmm-yy" ) Formata com carateres de marcador de posição:Formats using placeholder characters:
  • d para um dia do mês com um ou dois dígitosd for a single-digit or double-digit day of the month
  • - como um caráter literal copiado para o resultado- as a literal character copied to the result
  • mmm para uma abreviatura de três letras do mêsmmm for a three-letter abbreviation of the month
  • - como outro caráter literal copiado para o resultado- as another literal character copied to the result
  • aa para uma abreviatura de dois dígitos do anoyy for a two-digit abbreviation of the year
"23-Nov-15""23-Nov-15"

Aplicações globaisGlobal apps

FórmulaFormula DescriçãoDescription ResultadoResult
Texto ( 1234567.89, "[$-en-US]$ #,###" )Text( 1234567.89, "[$-en-US]$ #,###" ) Interpreta , como um separador de agrupamento colocado a cada três carateres e $ como o símbolo de moeda.Interprets , as a grouping separator placed every three characters and $ as the currency symbol. Como não tem casas decimais a apresentar, o valor é arredondado para o número inteiro superior seguinte.As no decimals are to be displayed, the value is rounded up to the next higher whole number. O [$-en-US] é opcional neste caso, porque esta é a predefinição.The [$-en-US] is optional in this case, as this is the default. "$ 1,234,568""$ 1,234,568"
Texto ( 1234567.89, "[$-es-ES]€ #,###" )Text( 1234567.89, "[$-es-ES]€ #,###" ) Interpreta , como um separador decimal e como o símbolo de moeda.Interprets , as a decimal separator and as the currency symbol. 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": .Because the [$-fr-FR] only determines how the format string is interpreted, the result will use the characters from the default "en-US" lanugage tag: . (vírgula) para o separador decimal e $ para o símbolo de moeda.(period) for decimal separator and $ for currency symbol. "$ 1234567.89""$ 1234567.89"
Texto( 1234567.89, "[$-es-ES]€ #,###", "es-ES" )Text( 1234567.89, "[$-es-ES]€ #,###", "es-ES" ) Interpreta , como um separador decimal.Interprets , as a decimal separator. 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.The result language tag has been set to "fr-FR" which will result in , (comma) being used as the decimal separator and as the currency symbol. "€ 1234567,89""€ 1234567,89"
Texto ( Date(2016,1,31), "dddd mmmm d" )Text( Date(2016,1,31), "dddd mmmm d" ) Devolve o dia da semana, mês e dia do mês no idioma do utilizador atual.Returns the weekday, month, and day of the month in the language of the current user. Uma vez que nenhum dos marcadores de posição depende do idioma, não é necessária uma etiqueta de idioma do texto de formato.Because none of the placeholders are language dependent, there is no need for a format text language tag. "Sábado 31 de Janeiro""Saturday January 31"
Texto ( Date(2016,1,31), "dddd mmmm d", "es-ES" )Text( 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".Returns the weekday, month, and day of the month in the "es-ES" language. "domingo enero 31""domingo enero 31"