Función Text en PowerAppsText function in PowerApps

Da formato a un número o un valor de fecha y hora para mostrar como una cadena de texto.Formats a number or a date/time value for display as a string of text.

DescripciónDescription

La función Text da formato a un número o a un valor de fecha y hora según uno de estos tipos de argumentos:The Text function formats a number or a date/time value based on one of these types of arguments:

  • Un formato predefinido de fecha y hora que especifica a través de la enumeración DateTimeFormat.A predefined date/time format, which you specify by using the DateTimeFormat enumeration. En el caso de fechas y horas, se prefiere este enfoque porque se ajusta automáticamente al idioma y la ubicación de cada usuario.For dates and times, this approach is preferred as it automatically adjusts to each user's language and location.
  • Un formato personalizado, una cadena de texto que incluye marcadores de posición que describen cómo dar formato al número o al valor de fecha y hora.A custom format, a string of text that comprises placeholders that describe how to format the number or the date/time value. Los marcadores de posición definen cuántos dígitos se deben mostrar, si se deben usar separadores de agrupación y cómo mostrar el nombre de un mes.Placeholders define how many digits to show, whether grouping separators should be used, and how to display the name of a month. PowerApps admite un subconjunto de los marcadores de posición que admite Microsoft Excel.PowerApps supports a subset of the placeholders that Microsoft Excel does.

Consulte cómo trabajar con fechas y horas para más información.See working with dates and times for more information.

Formatos predefinidos de fecha y horaPredefined date/time formats

Formato predefinidoPredefined Format DescripciónDescription
DateTimeFormat.LongDateDateTimeFormat.LongDate Año completo, mes, día del mes y día de la semana.Full year, month, day of the month, and day of the week. Los nombres del mes y del día de la semana no se abrevian.The names of the month and the day of the week aren't abbreviated.
DateTimeFormat.LongDateTimeDateTimeFormat.LongDateTime Año completo, mes, día del mes y día de la semana, además de la hora (reloj de 12 horas), minutos, segundos y designación a.m y p.m.Full year, month, day of the month, and day of the week, plus hour (12-hour clock), minutes, seconds, and AM/PM designation. Los nombres del mes y del día de la semana no se abrevian.The names of the month and the day of the week aren't abbreviated.
DateTimeFormat.LongDateTime24DateTimeFormat.LongDateTime24 Año completo, mes, día del mes y día de la semana, además de la hora (reloj de 24 horas), minutos y segundos.Full year, month, day of the month, and day of the week, plus hour (24-hour clock), minutes, and seconds. Los nombres del mes y del día de la semana no se abrevian.The names of the month and the day of the week aren't abbreviated.
DateTimeFormat.LongTimeDateTimeFormat.LongTime Hora (reloj de 12 horas), minutos, segundos y designación a.m. y p.m.Hour (12-hour clock), minutes, seconds, and AM/PM designation. Igual que ShortTime.Same as ShortTime.
DateTimeFormat.LongTime24DateTimeFormat.LongTime24 Hora (reloj de 24 horas), minutos y segundos.Hour (24-hour clock), minutes, seconds. Igual que ShortTime24.Same as ShortTime24.
DateTimeFormat.ShortDateDateTimeFormat.ShortDate Año de cuatro dígitos con mes de dos dígitos y día de la semana.Four-digit year with two-digit month and day of the month.
DateTimeFormat.ShortDateTimeDateTimeFormat.ShortDateTime Año de cuatro dígitos con mes de dos dígitos y día de la semana, además de la hora (reloj de 12 horas), minutos, segundos y designación a.m. y p.m.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 Año de cuatro dígitos con mes de dos dígitos y día de la semana, además de la hora (reloj de 24 horas), minutos y 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 (reloj de 12 horas), minutos, segundos y designación a.m. y p.m.Hour (12-hour clock), minutes, seconds, and AM/PM designation. Igual que LongTime.Same as LongTime.
DateTimeFormat.ShortTime24DateTimeFormat.ShortTime24 Hora (reloj de 24 horas), minutos y segundos.Hour (24-hour clock), minutes, and seconds. Igual que LongTime24.Same as LongTime24.
DateTimeFormat.UTCDateTimeFormat.UTC El valor de fecha y hora se convierte en UTC según la zona horaria del usuario actual y usa un formato basado en el estándar 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 posición de númeroNumber placeholders

Marcador de posiciónPlaceholder DescripciónDescription
0 (cero)0 (zero) Muestra ceros no significativos si un número tiene menos dígitos que ceros en el formato.Displays insignificant zeros if a number has fewer digits than there are zeros in the format. Por ejemplo, use el formato #.00 si desea mostrar 8.9 como 8.90.For example, use the format #.00 if you want to display 8.9 as 8.90.
# Sigue las mismas reglas que 0 (cero).Follows the same rules as the 0 (zero). Sin embargo, Text no muestra ceros adicionales cuando el número tiene menos dígitos en cualquier lado del decimal que símbolos # en el 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 ejemplo, se muestra 8.9 si el formato personalizado es #.## y el número al que debe darse formato es 8.9.For example, 8.9 is displayed if the custom format is #.## and the number to format is 8.9.
.. (punto)(period) Muestra el punto decimal de un número.Displays the decimal point in a number. Depende del idioma del formato personalizado; consulte las aplicaciones globales para más detalles.Depends on the language of the custom format, see global apps for more details.
, (coma), (comma) Muestra el separador de agrupación de un número; a menudo, se usa para los miles.Displays the grouping separator in a number, often used for thousands. Text separa los grupos con comas si el formato contiene una coma encerrada entre signos numéricos (#) o ceros.Text separates groups by commas if the format contains a comma that's enclosed by number signs (#) or by zeros. Depende del idioma del formato personalizado; consulte las aplicaciones globales para más detalles.Depends on the language of the custom format, see global apps for more details.

Si un número tiene más dígitos a la derecha del separador decimal que marcadores de posición en el formato, el número se redondea a tantas cifras decimales como marcadores de posición existen.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. Si hay más dígitos a la izquierda del separador decimal que marcadores de posición, se muestran los dígitos adicionales.If there are more digits to the left of the decimal point than there are placeholders, the extra digits are displayed. Si el formato solo consta de signos numéricos (#) a la izquierda del separador decimal, los números menores que 1 comienzan con un separador decimal (por ejemplo .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 posición de fecha y horaDate and time placeholders

Marcador de posiciónPlaceholder DescripciónDescription
mm Muestra el mes como número sin cero inicial.Displays the month as a number without a leading zero.
mmmm Muestra el mes como número con cero inicial cuando corresponda.Displays the month as a number with a leading zero when appropriate.
mmmmmm Muestra el mes abreviado (Ene a Dic).Displays the month as an abbreviation (Jan to Dec).
mmmmmmmm Muestra el nombre completo del mes (Enero a Diciembre).Displays the month as a full name (January to December).
dd Muestra el día como número sin cero inicial.Displays the day as a number without a leading zero.
dddd Muestra el día como número con cero inicial cuando corresponda.Displays the day as a number with a leading zero when appropriate.
dddddd Muestra el día abreviado (Dom a Sáb).Displays the day as an abbreviation (Sun to Sat).
dddddddd Muestra el nombre completo del día (Domingo a Sábado).Displays the day as a full name (Sunday to Saturday).
yyyy Muestra el año como número de dos dígitos.Displays the year as a two-digit number.
yyyyyyyy Muestra el año como número de cuatro dígitos.Displays the year as a four-digit number.
hh Muestra la hora como número sin cero inicial.Displays the hour as a number without a leading zero.
hhhh Muestra la hora como número con cero inicial cuando corresponda.Displays the hour as a number with a leading zero when appropriate. Si el formato contiene AM o PM, la hora se muestra según el reloj de 12 horas.If the format contains AM or PM, the hour is shown based on the 12-hour clock. De lo contrario, la hora se muestra según el reloj de 24 horas.Otherwise, the hour is shown based on the 24-hour clock.
mm Muestra el minuto como número sin cero inicial.Displays the minute as a number without a leading zero. Nota: El código m o mm debe aparecer inmediatamente después del código h o hh o inmediatamente antes del código ss; de lo contrario, Text muestra el mes en lugar de los 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 Muestra el minuto como número con cero inicial cuando corresponda.Displays the minute as a number with a leading zero when appropriate. Nota: El marcador de posición m o mm debe aparecer inmediatamente después del marcador de posición h o hh o inmediatamente antes del marcador de posición ss.Note: The m or the mm placeholder must appear immediately after the h or hh placeholder or immediately before the ss placeholder. De lo contrario, Text muestra el mes en lugar de los minutos.Otherwise, Text returns the month instead of minutes.
ss Muestra el segundo como número sin cero inicial.Displays the second as a number without a leading zero.
ssss Muestra el segundo como número con cero inicial cuando corresponda.Displays the second as a number with a leading zero when appropriate.
ff Muestra las fracciones de segundos.Displays the fractions of seconds.
AM/PM, am/pm, A/P, a/pAM/PM, am/pm, A/P, a/p Muestra la hora según un reloj de 12 horas.Displays the hour based on a 12-hour clock. Text muestra "AM", "am", "A" o "a" para las horas que van entre la medianoche hasta el mediodía y "PM", "pm", "P" o "p" para las horas que van desde el mediodía hasta la medianoche.Text 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 posición literalesLiteral placeholders

Puede incluir cualquiera de estos caracteres en su cadena de formato.You can include any of these characters in your format string. Aparecerán en el resultado de Text tal cual.They will appear in the result of Text as is. Los caracteres adicionales están reservados para marcadores de posición futuros, por lo que no debe usarlos.Additional characters are reserved for future placeholders, so you shouldn't use them.

CarácterCharacter DescripciónDescription
Cualquier símbolo de monedaAny currency symbol Signo de dólar, signo de centavo, signo de euro, etc.Dollar sign, cents sign, euro sign, etc.
+ Signo másPlus sign
(( Paréntesis de aperturaLeft parenthesis
:: Dos puntosColon
^ Acento circunflejo (símbolo de intercalación)Circumflex accent (caret)
'' ApóstrofoApostrophe
{{ Llave de aperturaLeft curly bracket
< Signo de menor queLess-than sign
= Signo igualEqual sign
- Signo menosMinus sign
/ Barra diagonalSlash mark
)) Paréntesis de cierreRight parenthesis
& Y comercialAmpersand
~ Tilde de la ñTilde
}} Llave de cierreRight curly bracket
> Signo de mayor queGreater-than sign
  Carácter de espacioSpace character

Aplicaciones globalesGlobal apps

La función Text es globalmente compatible.The Text function is globally aware. Para una amplia variedad de idiomas, sabe cómo escribir correctamente fechas, horas, monedas y números.For a wide array of languages, it knows how to properly write out dates, times, currencies, and numbers. Para ello, necesita dos tipos de información:To do its job, it needs two pieces of information:

  • El idioma del formato personalizado: para los autores, ¿cómo se debe interpretar un formato personalizado?The language of the custom format: For authors, how should a custom format be interpreted? Los caracteres separadores (.The separator characters (. y ,) tienen significados distintos en diferentes idiomas.and ,) have different meanings in different languages. Esto se controla con un marcador de posición especial que incluye una etiqueta de idioma.This is handled with a special placeholder containing a language tag. Incluso más sencillo, los formatos predefinidos de fecha y hora son independientes del idioma.Even easier, the predefined date/time formats are language agnostic.
  • El idioma del resultado: para los usuarios, ¿qué idioma se debe usar en el resultado de la función?The language of the result: For users, what language should be used in the result of the function? Los nombres de los meses y días de la semana deben estar en el idioma correspondiente al usuario de la aplicación.Names for months and weekdays need to be in the appropriate language for the user of the app. Esto se controla con un tercer argumento opcional de la función Text.This is handled with a third optional argument to the Text function.

En ambos casos, el idioma se proporciona con una etiqueta de idioma.For both, the language is provided with a language tag. Para ver la lista de idiomas compatibles, escriba Text( 1234, "", ) en la barra de fórmulas o en la vista avanzada y desplácese por la lista de configuraciones regionales sugeridas para el tercer 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 posición de formato personalizadoCustom format language placeholder

Para especificar el idioma del formato personalizado, use:To specify the language of the custom format, use:

Marcador de posiciónPlaceholder DescripciónDescription
[$-LanguageTag][$-LanguageTag] LanguageTag es una etiqueta de idioma que la función Language muestra.LanguageTag is a language tag as returned from the Language function. Puede tener el formato del idioma, como [$-en] para inglés, o también puede incluir la región, como[$-en-GB] para especificar, además, Gran Bretaña.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.

El marcador de posición de idioma puede aparecer en cualquier parte del formato personalizado, pero solo una vez.The language placeholder can appear anywhere in the custom format but only once.

Cuando escriba una fórmula, si no proporciona un marcador de posición de idioma y la cadena de formato es ambigua en términos globales, la herramienta de creación insertará automáticamente la etiqueta de idioma correspondiente al idioma actual.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] es el valor que se presume si este marcador de posición no está presente cuando se ejecuta la aplicación.[$-en-US] is assumed if this placeholder is not present when your app is run.

NOTA: En una versión futura, la sintaxis de este marcador de posición puede cambiar para evitar que se confunda con un marcador de posición similar, pero distinto, compatible con 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 del resultadoResult language tag

En el resultado de la función Text aparecen cadenas traducidas para mes, día de la semana y designaciones a.m. o p.m., además de separadores decimales y grupo adecuados.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.

De manera predeterminada, la función Text usa el idioma del usuario que ejecuta la aplicación.By default, Text uses the language of the user running the app. La función Language muestra la etiqueta de idioma correspondiente al usuario actual.The Language function returns the language tag for the current user. Puede reemplazar este valor predeterminado si suministra una etiqueta de idioma para el tercer argumento opcional de Text.You can override this default by supplying a language tag for the optional third argument to Text.

SintaxisSyntax

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

  • Number: requerido.Number - Required. El número o el valor de fecha y hora al que se dará formato.The number or the date/time value to format.
  • DateTimeFormat: requerido.DateTimeFormat - Required. Miembro de la enumeración DateTimeFormat.A member of the DateTimeFormat enumeration.
  • ResultLanguageTag: opcional.ResultLanguageTag - Optional. La etiqueta de idioma que se usará para el texto de resultado.The language tag to use for the result text. De manera predeterminada, se usa el idioma del usuario actual.By default, the language of the current user is used.

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

  • Number: requerido.Number - Required. El número o el valor de fecha y hora al que se dará formato.The number or the date/time value to format.
  • CustomFormat: requerido.CustomFormat - Required. Uno o más marcadores de posición entre comillas dobles.One or more placeholders enclosed in double quotation marks.
  • ResultLanguageTag: opcional.ResultLanguageTag - Optional. La etiqueta de idioma que se usará para el texto de resultado.The language tag to use for the result text. De manera predeterminada, se usa el idioma del usuario actual.By default, the language of the current user is used.

EjemplosExamples

El usuario que ejecuta estas fórmulas se encuentra en Estados Unidos y seleccionó inglés como idioma.The user running these formulas is located in the United States and has selected English as their language. La función Language muestra "en-US".The Language function is returning "en-US".

NúmeroNumber

FórmulaFormula DescripciónDescription ResultadoResult
Text( 1234.59, "####.#" )Text( 1234.59, "####.#" ) Da formato al número con un decimal.Formats the number with one decimal place. "1234.6""1234.6"
Text( 8.9, "#.000" )Text( 8.9, "#.000" ) Rellena la parte decimal del número con ceros finales, si es necesario.Pads the decimal portion of the number with trailing zeros, if needed. "8.900""8.900"
Text( 0.631, "0.#" )Text( 0.631, "0.#" ) Rellena la parte entera del número con ceros iniciales, si es necesario.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#" )
Rellena la parte decimal del número con ceros para una cifra decimal e incluye una segunda cifra decimal, si se suministra.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 un separador de miles cada tres dígitos e incluye un símbolo de moneda.Places a thousands separator every three digits, and includes a currency symbol. "$ 12,000""$ 12,000"
"$ 1,200,000""$ 1,200,000"

Fecha y horaDate/Time

  • A las 2:37:47 PM del Monday, November 23, 2015At 2:37:47 PM on Monday, November 23, 2015
  • Zona horaria del Pacífico de Estados Unidos (UTC-8)United States Pacific Time Zone (UTC-8)
FórmulaFormula DescripciónDescription ResultadoResult
Text( Now(), DateTimeFormat.LongDate )Text( Now(), DateTimeFormat.LongDate ) Da formato como una cadena de fecha larga, en el idioma y la configuración local del usuario actual.Formats as a long date string, in the language and locale of the current user. "Monday, November 23, 2015""Monday, November 23, 2015"
Text( Now(), DateTimeFormat.LongDateTime )Text( Now(), DateTimeFormat.LongDateTime ) Da formato como una cadena de fecha y hora larga, en el idioma y la configuración local del usuario actual, con un reloj 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. "Monday, November 23, 2015 2:37:47 PM""Monday, November 23, 2015 2:37:47 PM"
Text( Now(), DateTimeFormat.LongTime24 )Text( Now(), DateTimeFormat.LongTime24 ) Da formato como una cadena de hora larga, con un reloj 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 ) Da formato como una cadena de fecha corta, en el idioma y la configuración local del usuario actual.Formats as a short date string, in the language and locale of the current user. "11/23/2015""11/23/2015"
Text( Now(), "d-mmm-yy" )Text( Now(), "d-mmm-yy" ) Da formato con caracteres de marcador de posición:Formats using placeholder characters:
  • d para un día del mes de solo un dígito o de dos dígitosd for a single-digit or double-digit day of the month
  • - como carácter literal copiado en el resultado- as a literal character copied to the result
  • mmm para una abreviatura de tres letras del mesmmm for a three-letter abbreviation of the month
  • - como otro carácter literal copiado en el resultado- as another literal character copied to the result
  • yy para una abreviatura de dos dígitos del añoyy for a two-digit abbreviation of the year
"23-Nov-15""23-Nov-15"

Aplicaciones globalesGlobal apps

FórmulaFormula DescripciónDescription ResultadoResult
Text( 1234567.89, "[$-en-US]$ #,###" )Text( 1234567.89, "[$-en-US]$ #,###" ) Interpreta , como un separador de agrupación puesto cada tres caracteres y $ como el símbolo de moneda.Interprets , as a grouping separator placed every three characters and $ as the currency symbol. Como no se mostrarán decimales, el valor se redondea hacia arriba al próximo número entero.As no decimals are to be displayed, the value is rounded up to the next higher whole number. En este caso, la etiqueta [$-en-US] es opcional, dado que se trata del valor predeterminado.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 , como un separador decimal y como el símbolo de moneda.Interprets , as a decimal separator and as the currency symbol. Debido a que la etiqueta [$-fr-FR] solo determina cómo se interpretará la cadena de formato, el resultado usará los caracteres de la etiqueta de idioma "en-US" predeterminada: .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: . (punto) como separador decimal y $ como símbolo de moneda.(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 , como separador decimal.Interprets , as a decimal separator. La etiqueta de idioma del resultado se estableció en "fr-FR", lo que hará que , (coma) se use como separador decimal y , como símbolo de moneda.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" ) Muestra el día de la semana, el mes y el día del mes en el idioma del usuario actual.Returns the weekday, month, and day of the month in the language of the current user. Como ninguno de los marcadores de posición depende del idioma, no es necesario tener una etiqueta de idioma de texto de formato.Because none of the placeholders are language dependent, there is no need for a format text language tag. "Saturday January 31""Saturday January 31"
Text( Date(2016,1,31), "dddd mmmm d", "es-ES" )Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) Muestra el día de la semana, el mes y el día del mes en el idioma "es-ES".Returns the weekday, month, and day of the month in the "es-ES" language. "domingo enero 31""domingo enero 31"