Função Texto no PowerAppsText function in PowerApps

Formata um número ou um valor de data/hora para exibiçã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 Texto formata um número ou um valor de data/hora com base em um dos tipos de argumentos a seguir: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, especificado usando a enumeração DateTimeFormat.A predefined date/time format, which you specify by using the DateTimeFormat enumeration. Essa é a abordagem preferencial para datas e horas, pois se ajusta automaticamente ao idioma e local de cada usuário.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 com espaços reservados 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. 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.Placeholders define how many digits to show, whether grouping separators should be used, and how to display the name of a month. O PowerApps dá suporte a um subconjunto de espaços reservados do Microsoft Excel.PowerApps supports a subset of the placeholders that Microsoft Excel does.

Consulte 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 de meses e de dias 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, além de horas (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 de meses e de dias 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, além de horas (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 de meses e de dias 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. O mesmo que ShortTime.Same as ShortTime.
DateTimeFormat.LongTime24DateTimeFormat.LongTime24 Horas (relógio de 24 horas), minutos e segundos.Hour (24-hour clock), minutes, seconds. O mesmo que ShortTime24.Same as ShortTime24.
DateTimeFormat.ShortDateDateTimeFormat.ShortDate Ano de quatro dígitos com mês e dia de dois dígitos.Four-digit year with two-digit month and day of the month.
DateTimeFormat.ShortDateTimeDateTimeFormat.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.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 e dia de dois dígitos, além de horas (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 Horas (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 usuário atual e formatado de acordo com o padrão 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.

Espaços reservados em formato de númeroNumber placeholders

Espaço reservadoPlaceholder DescriçãoDescription
0 (zero)0 (zero) Exibe zeros não significativos se um número tiver menos dígitos do que zeros no formato.Displays insignificant zeros if a number has fewer digits than there are zeros in the format. Por exemplo, use o formato #.00 para exibir 8.9 como 8.90.For example, use the format #.00 if you want to display 8.9 as 8.90.
# Siga as mesmas regras do 0 (zero).Follows the same rules as the 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.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, 8.9 será exibido se o formato personalizado for #.## e o número para formatar for 8.9.For example, 8.9 is displayed if the custom format is #.## and the number to format is 8.9.
.. (ponto)(period) Exibe o ponto decimal em um número.Displays the decimal point in a number. Depende do idioma do formato personalizado, consulte aplicativos globais para obter mais detalhes.Depends on the language of the custom format, see global apps for more details.
, (vírgula), (comma) Exibe o separador de agrupamento em um número, geralmente usado para milhares.Displays the grouping separator in a number, often used for thousands. A função Texto separa grupos por vírgulas se o formato contiver uma vírgula entre sinais numéricos (#) 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 aplicativos 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 espaços reservados no formato, ele será arredondado para a quantidade de casas decimais definida pelos espaços reservados.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 houver mais dígitos à esquerda da vírgula decimal do que espaços reservados, os dígitos adicionais serão exibidos.If there are more digits to the left of the decimal point than there are placeholders, the extra digits are displayed. 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).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).

Espaços reservados de data e horaDate and time placeholders

Espaço reservadoPlaceholder DescriçãoDescription
mm Exibe o mês como um número sem um zero à esquerda.Displays the month as a number without a leading zero.
mmmm Exibe o mês como um número com um zero à esquerda.Displays the month as a number with a leading zero when appropriate.
mmmmmm Exibe o mês como uma abreviação (jan a dez).Displays the month as an abbreviation (Jan to Dec).
mmmmmmmm Exibe o mês como um nome completo (janeiro a dezembro).Displays the month as a full name (January to December).
dd Exibe o dia como um número sem um zero à esquerda.Displays the day as a number without a leading zero.
dddd Exibe o dia como um número com um zero à esquerda.Displays the day as a number with a leading zero when appropriate.
dddddd Exibe o dia como uma abreviatura (Sun a Sat).Displays the day as an abbreviation (Sun to Sat).
dddddddd Exibe o dia como um nome completo (domingo a sábado).Displays the day as a full name (Sunday to Saturday).
aayy Exibe o ano como um número de dois dígitos.Displays the year as a two-digit number.
aaaayyyy Exibe o ano como um número de quatro dígitos.Displays the year as a four-digit number.
hh Exibe a hora como um número sem um zero à esquerda.Displays the hour as a number without a leading zero.
hhhh Exibe a hora como um número com um zero à esquerda.Displays the hour as a number with a leading zero when appropriate. Se o formato contiver AM ou PM, a hora será mostrada 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 será mostrada com base no relógio de 24 horas.Otherwise, the hour is shown based on the 24-hour clock.
mm Exibe o minuto como um número sem um zero à esquerda.Displays the minute as a number without a leading zero. 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.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 Exibe o minuto como um número com um zero à esquerda quando apropriado.Displays the minute as a number with a leading zero when appropriate. 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.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, a função Texto retornará o mês em vez dos minutos.Otherwise, Text returns the month instead of minutes.
ss Exibe o segundo como um número sem um zero à esquerda.Displays the second as a number without a leading zero.
ssss Exibe o segundo como um número com um zero à esquerda quando apropriado.Displays the second as a number with a leading zero when appropriate.
ff Exibe 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 Exibe a hora com base em um relógio de 12 horas.Displays the hour based on a 12-hour clock. 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-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

Espaços reservados literaisLiteral placeholders

É possível incluir esses caracteres na cadeia de formato.You can include any of these characters in your format string. Eles aparecerão nos resultados da função Texto como são.They will appear in the result of Text as is. Caracteres adicionais estão reservados para futuros espaços reservados, portanto, você não deve usá-los.Additional characters are reserved for future placeholders, so you shouldn't use them.

CaractereCharacter DescriçãoDescription
Qualquer símbolo de moedaAny currency symbol Símbolos do dólar, euro, de centavos 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
{{ Chave à esquerdaLeft curly bracket
< Sinal de menor queLess-than sign
= Sinal de igualEqual sign
- Sinal de subtraçãoMinus sign
/ BarraSlash mark
)) Parêntese direitoRight parenthesis
& E comercialAmpersand
~ TilTilde
}} Chave à direitaRight curly bracket
> Sinal de maior queGreater-than sign
  Caractere de espaçoSpace character

Aplicativos globaisGlobal apps

A função Texto tem sensibilidade global.The Text function is globally aware. Ela escreve corretamente datas, horas, moedas e números em uma ampla variedade de idiomas.For a wide array of languages, it knows how to properly write out dates, times, currencies, and numbers. Para que ela funcione, são necessárias duas informações:To do its job, it needs two pieces of information:

  • O idioma do formato personalizado: para autores, como um formato personalizado deve ser interpretado?The language of the custom format: For authors, how should a custom format be interpreted? Os caracteres separadores (.The separator characters (. e ,) têm significados diferentes entre os idiomas.and ,) have different meanings in different languages. Isso é tratado com um espaço reservado especial, que contém uma marca de idioma.This is handled with a special placeholder containing a language tag. Ainda mais fáceis, os formatos de data/hora predefinidos não dependem do idioma.Even easier, the predefined date/time formats are language agnostic.
  • O idioma do resultado: para os usuários, qual idioma deve ser usado no resultado da função?The language of the result: For users, what language should be used in the result of the function? Nomes de meses e dias da semana precisam estar no idioma apropriado para o usuário do aplicativo.Names for months and weekdays need to be in the appropriate language for the user of the app. Isso é tratado com um terceiro argumento opcional para a função Texto.This is handled with a third optional argument to the Text function.

Para ambos, o idioma é fornecido com uma marca de idioma.For both, the language is provided with a language tag. 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.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.

Espaço reservado de idioma com formato personalizadoCustom format language placeholder

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

Espaço reservadoPlaceholder DescriçãoDescription
[$-LanguageTag][$-LanguageTag] LanguageTag é uma marca de idioma, conforme retornado pela função Idioma.LanguageTag is a language tag as returned from the Language function. 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.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 espaço reservado 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 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.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.

Adota-se o [$-en-US] se o espaço reservado não estiver presente ao executar o aplicativo.[$-en-US] is assumed if this placeholder is not present when your app is run.

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

Marca de idioma de resultadoResult language tag

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.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 padrão, a função Texto usa o idioma do usuário que executa o aplicativo.By default, Text uses the language of the user running the app. A função Idioma retorna a marca de idioma para o usuário atual.The Language function returns the language tag for the current user. É possível substituir esse padrão fornecendo uma marca de idioma para o terceiro argumento opcional da função Texto.You can override this default by supplying a language tag for the optional third argument to Text.

SintaxeSyntax

Text( Number, DateTimeFormatEnum [, ResultLanguageTag ] )Text( Number, DateTimeFormatEnum [, ResultLanguageTag ] )

  • Number – Obrigatório.Number - Required. O número ou o valor de data/hora para o formato.The number or the date/time value to format.
  • DateTimeFormat – Obrigatório.DateTimeFormat - Required. Membro da enumeração DateTimeFormat.A member of the DateTimeFormat enumeration.
  • ResultLanguageTag – Opcional.ResultLanguageTag - Optional. A marca de idioma a ser usada para o texto do resultado.The language tag to use for the result text. Por padrão, o idioma do usuário atual é utilizado.By default, the language of the current user is used.

Text( Number, CustomFormat [, ResultLanguageTag ] )Text( Number, CustomFormat [, ResultLanguageTag ] )

  • Number – Obrigatório.Number - Required. O número ou o valor de data/hora para o formato.The number or the date/time value to format.
  • CustomFormat – Obrigatório.CustomFormat - Required. Um ou mais espaços reservados entre aspas duplas.One or more placeholders enclosed in double quotation marks.
  • ResultLanguageTag – Opcional.ResultLanguageTag - Optional. A marca de idioma a ser usada para o texto do resultado.The language tag to use for the result text. Por padrão, o idioma do usuário atual é utilizado.By default, the language of the current user is used.

ExemplosExamples

O usuário que executa essas fórmulas está localizado nos Estados Unidos e selecionou o 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á retornando "en-US".The Language function is returning "en-US".

NúmeroNumber

FórmulaFormula DescriçãoDescription ResultadoResult
Text( 1234.59, "####.#" )Text( 1234.59, "####.#" ) Formata o número com uma casa decimal.Formats the number with one decimal place. "1234.6""1234.6"
Text( 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"
Text( 0.631, "0.#" )Text( 0.631, "0.#" ) Preenche a parte inteira do número com zeros à esquerda, se necessário.Pads the whole portion of the number with leading zeros, if needed. "0.6""0.6"
Text( 12, "#.0#" )Text( 12, "#.0#" )
Text( 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"
Text( 12000, "$ #,###" )Text( 12000, "$ #,###" )
Text( 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
Text( Now(), DateTimeFormat.LongDate )Text( Now(), DateTimeFormat.LongDate ) Formatos como uma cadeia de data por extenso, no idioma e a localidade do usuário 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"
Text( Now(), DateTimeFormat.LongDateTime )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.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"
Text( Now(), DateTimeFormat.LongTime24 )Text( Now(), DateTimeFormat.LongTime24 ) Formatos como uma cadeia de hora completa, com um relógio de 24 horas.Formats as a long time string, using a 24-hour clock. "14:37:47""14:37:47"
Text( Now(), DateTimeFormat.ShortDate )Text( Now(), DateTimeFormat.ShortDate ) Formatos como uma cadeia de data abreviada, no idioma e localidade do usuário 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-aa")Text( Now(), "d-mmm-yy" ) Formatos usando caracteres de espaço reservado:Formats using placeholder characters:
  • d para dia de dígito único ou de dois dígitosd for a single-digit or double-digit day of the month
  • - como um caractere 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 caractere 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"

Aplicativos globaisGlobal apps

FórmulaFormula DescriçãoDescription ResultadoResult
Text( 1234567.89, "[$-en-US]$ #,###" )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.Interprets , as a grouping separator placed every three characters and $ as the currency symbol. Como decimais não são exibidos, o valor é arredondado para o número inteiro mais próximo.As no decimals are to be displayed, the value is rounded up to the next higher whole number. O [$en-US] é opcional nesse caso, pois esse é o padrão.The [$-en-US] is optional in this case, as this is the default. "$ 1,234,568""$ 1,234,568"
Text( 1234567.89, "[$-es-ES]€ #,###" )Text( 1234567.89, "[$-es-ES]€ #,###" ) Interpreta a , como um separador decimal e como o símbolo de moeda.Interprets , as a decimal separator and as the currency symbol. 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": .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: . (ponto) como separador decimal e $ para o símbolo de moeda.(period) for decimal separator and $ for currency symbol. "$ 1234567.89""$ 1234567.89"
Text( 1234567.89, "[$-es-ES]€ #,###", "es-ES" )Text( 1234567.89, "[$-es-ES]€ #,###", "es-ES" ) Interpreta a , como um separador decimal.Interprets , as a decimal separator. 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.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"
Text( Date(2016,1,31), "dddd mmmm d" )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.Returns the weekday, month, and day of the month in the language of the current user. 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.Because none of the placeholders are language dependent, there is no need for a format text language tag. "31 de janeiro de sábado""Saturday January 31"
Text( Date(2016,1,31), "dddd mmmm d", "es-ES" )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".Returns the weekday, month, and day of the month in the "es-ES" language. "domingo enero 31""domingo enero 31"