Funció de text
S'aplica a:
Aplicacions de llenç Columnes de fórmula d'aplicacions Dataverse de llenç Aplicacions Power Platform basades en models CLI
Converteix qualsevol valor i formata un valor de nombre o data i hora en una cadena de text.
Descripció
La funció Text formata un valor de número o data i hora en funció d'un d'aquests tipus d'arguments:
- Format predefinit de data i hora, que especifiqueu mitjançant l'enumeració DateTimeFormat. Per a dates i hores, es prefereix aquest mètode perquè s'ajusta automàticament a la llengua i la regió de cada usuari.
- Format personalitzat, que inclou una cadena de marcadors de posició que defineixen, per exemple, si els números mostren un separador decimal i si les dates mostren el nom complet del mes, el mes amb una abreviatura o el mes com a número. El Power Apps admet un subconjunt dels marcadors de posició del Microsoft Excel. En aquesta cadena, el marcador de posició de la llengua especifica la llengua en què s'ha d'interpretar la resta de marcadors de posició. Si el format personalitzat inclou un punt, per exemple, el marcador de posició de format de la llengua especifica si el punt és un separador decimal (ja-JP) o un separador de milers (es-ES).
Vegeu Treballar amb dates i hores per obtenir més informació.
La funció Text també pot convertir qualsevol tipus de dades en una representació de text mitjançant un format per defecte. Utilitzeu-la per passar valors que no siguin de text a funcions basades en text, com ara Len, Right i IsMatch.
Formats predefinits de data i hora
Per a aquests exemples, la data i l'hora que s'utilitzen és el dimarts, 7 d'abril de 2020, a les 20:26:59.180, al fus horari UTC-7.
| DateTimeFormat enum | Descripció | Exemples (amb en-US) |
|---|---|---|
| LongDate | Any de quatre dígits, nom del mes, dia del mes i dia de la setmana. Els noms del mes i el dia de la setmana no s'abreugen. | "Dimarts, 7 d'abril de 2020" |
| LongDateTime | Any de quatre dígits, nom del mes, dia del mes i dia de la setmana, a més de l'hora (rellotge de 12 hores), minuts, segons i designació AM o PM. Els noms del mes i el dia de la setmana no s'abreugen. | "Dimarts, 7 d'abril de 2020 8:26:59 PM" |
| LongDateTime24 | Any de quatre dígits, mes, dia del mes i dia de la setmana, a més de l'hora (rellotge de 24 hores), minuts i segons. Els noms del mes i el dia de la setmana no s'abreugen. | "Dimarts, 7 d'abril de 2020 20:26:59" |
| LongTime | Hora (rellotge de 12 hores), minuts, segons i designació AM o PM. | "8:26:59 PM" |
| LongTime24 | Hora (rellotge de 24 hores), minuts i segons. | "20:26:59" |
| ShortDate | Any de quatre dígits amb el mes i el dia del mes en format numèric. | "4/7/2020" |
| ShortDateTime | Any de quatre dígits amb el mes i el dia del mes en format numèric, a més de l'hora (rellotge de 12 hores), minuts, segons i designació AM o PM. | "4/7/2020 8:26 PM" |
| ShortDateTime24 | Any de quatre dígits amb el mes i el dia del mes en format numèric, a més de l'hora (rellotge de 24 hores) i minuts. | "4/7/2020 20:26" |
| ShortTime | Hora (rellotge de 12 hores), minuts i designació AM o PM. | "8:26 PM" |
| ShortTime24 | Hora (rellotge de 24 hores) i minuts. | "20:26" |
| UTC | El valor de data i hora es converteix a UTC segons el fus horari de l'usuari actual i es formata segons l'estàndard ISO 8601. | "2020-04-08T03:26:59.180Z" |
Marcadors de posició de números
| Marcador de posició | Descripció |
|---|---|
| 0 (zero) | Mostra els zeros no significatius si un nombre té menys dígits que la quantitat de zeros del format. Per exemple, utilitzeu el format #.00 si voleu visualitzar 8.9 com a 8.90. |
| # | Segueix les mateixes regles que 0 (zero). No obstant això, Text no torna zeros addicionals quan el nombre té menys dígits a cada costat del decimal que la quantitat de símbols # del format. Per exemple, 8.9 es visualitza si el format personalitzat és #.## i el nombre que s'ha de formatar és 8.9. |
| . (punt) | Mostra el punt decimal d'un nombre. Depèn de la llengua del format personalitzat; vegeu Aplicacions globals per obtenir més informació. |
| , (coma) | Mostra el separador d'agrupament d'un nombre, que s'utilitza sovint per als milers. Text separa els grups per comes si el format conté una coma situada entre signes de nombre (#) o zeros. Depèn de la llengua del format personalitzat; vegeu Aplicacions globals per obtenir més informació. |
Si un nombre té més dígits a la dreta del punt decimal que la quantitat de marcadors de posició del format, el número s'arrodoneix al mateix nombre de decimals que de marcadors de posició. Si hi ha més dígits a l'esquerra del punt decimal que marcadors de posició, es mostren els dígits addicionals. Si el format conté només els signes de número (#) a l'esquerra del punt decimal, els números inferiors a 1 comencen amb un punt decimal (per exemple, .47).
Marcadors de posició de data i hora
| Marcador de posició | Descripció |
|---|---|
| m | Mostra el mes com un nombre sense zero a l'esquerra. |
| mm | Mostra el mes com un nombre amb un zero a l'esquerra quan correspon. |
| mmm | Mostra el mes en forma d'abreviatura (de gen a des). |
| mmmm | Mostra el mes amb el nom complet (de gener a desembre). |
| d | Mostra el dia com un nombre sense zero a l'esquerra. |
| dd | Mostra el dia com un nombre amb un zero a l'esquerra quan correspon. |
| ddd | Mostra el dia en forma d'abreviatura (de dg. a ds.). |
| dddd | Mostra el dia amb el nom complet (de diumenge a dissabte). |
| yy | Mostra l'any com un número de dos dígits. |
| yyyy | Mostra l'any com un número de quatre dígits. |
| h | Mostra l'hora com un nombre sense zero a l'esquerra. |
| hh | Mostra l'hora com un nombre amb un zero a l'esquerra quan correspon. Si el format conté AM o PM, l'hora es mostra en funció del rellotge de 12 hores. Altrament, l'hora es mostra amb el rellotge de 24 hores. |
| m | Mostra el minut com un nombre sense zero a l'esquerra. Aquest marcador de posició ha de figurar immediatament després del codi h o hh o immediatament abans del codi ss; altrament, Text torna el mes en comptes dels minuts. |
| mm | Mostra el minut com un nombre amb un zero a l'esquerra quan correspon. Aquest marcador de posició ha de figurar immediatament després del marcador de posició h o hh o immediatament abans del marcador de posició ss. Altrament, Text torna el mes en comptes dels minuts. |
| s | Mostra el segon com un nombre sense zero a l'esquerra. |
| ss | Mostra el segon com un nombre amb un zero a l'esquerra quan correspon. |
| f | Mostra les fraccions de segons. |
| AM/PM, a/p | Mostra l'hora en un rellotge de 12 hores. Text torna "AM" o "a" de les hores des de la mitjanit fins al migdia i "PM" o "p" de les hores des del migdia fins a la mitjanit |
Marcadors de posició literals
Podeu incloure qualsevol d'aquests caràcters a la cadena de format. Apareixeran al resultat de Text tal qual. Els caràcters addicionals es reserven per a marcadors de posició futurs, de manera que no heu d'utilitzar-los.
| Caràcter | Descripció |
|---|---|
| Qualsevol símbol monetari | Signe del dòlar, centaus, l'euro, etc. |
| + | Signe Més |
| ( | Parèntesi esquerre |
| : | Dos punts |
| ^ | Accent circumflex (signe d'intercalació) |
| ' | Apòstrof |
| { | Clau esquerra |
| < | Signe Menor que |
| = | Signe Igual |
| - | Signe Menys |
| / | Marca de barra |
| ) | Parèntesi dret |
| & | Et |
| ~ | Titlla |
| } | Clau dreta |
| > | Signe major que |
| Caràcter d'espai |
Aplicacions globals
La funció Text és globalment conscient. Per a una àmplia gamma de llengües, sap com escriure correctament dates, hores, divises i números. Per fer la seva feina, necessita dos fragments d'informació:
- Llengua del format personalitzat: per als creadors, com s'ha d'interpretar un format personalitzat? Els caràcters de separació (. i ,) tenen diferents significats en diferents llengües. Si especifiqueu un format personalitzat, podeu incloure un marcador de posició de llengua o triar el valor per defecte, que reflecteix la llengua definida a la configuració del dispositiu. Més fàcil encara, podeu utilitzar un dels formats predefinits de data i hora, que són agnòstics en relació amb la llengua.
- Llengua del resultat: per als usuaris, en quina llengua s'han de mostrar els resultats de la funció? Els noms dels mesos i dels dies han d'estar en la llengua apropiada per a l'usuari de l'aplicació, la qual podeu especificar afegint un tercer argument opcional per a la funció Text.
Per a totes dues opcions, especifiqueu la llengua mitjançant una etiqueta de llengua. Per veure la llista de les llengües admeses, escriviu Text(1234, "",) a la barra de fórmules o a pestanya Opcions avançades de la subfinestra de la dreta i, a continuació, desplaceu-vos per la llista de configuracions regionals suggerides per al tercer argument.
Marcador de posició de la llengua
Per especificar la llengua del format personalitzat, utilitzeu:
| Marcador de posició | Descripció |
|---|---|
| [$-LanguageTag] | LanguageTag és una etiqueta de llengua que es torna de la funció Language. Pot especificar només la llengua (com ara [$-en] per a l'anglès) o també la regió (com ara [$-en-GB] per especificar la Gran Bretanya). |
El marcador de posició de la llengua pot aparèixer en qualsevol part del format personalitzat, però només una vegada.
Si especifiqueu un format personalitzat sense cap marcador de posició de llengua i el format és ambigu des d'un punt de vista global, l'etiqueta de la llengua actual s'insereix automàticament.
[$-en-US] s'assumeix si no apareix el marcador de posició quan s'executa l'aplicació.
Nota
En una versió futura, la sintaxi d'aquest marcador de posició pot canviar per evitar confusions amb un marcador de posició similar, però diferent, que admet l'Excel.
Etiqueta de llengua resultant
El resultat de Text inclou les cadenes traduïdes per als mesos, els dies i les designacions AM o PM, així com el grup adient i els separadors decimals.
Per defecte, Text utilitza la llengua de l'usuari que executa l'aplicació. La funció Language torna l'etiqueta de llengua de l'usuari actual. Per substituir aquest valor per defecte, proporcioneu una etiqueta de llengua per al tercer argument de Text.
Sintaxi
Text(NumberOrDateTime, DateTimeFormatEnum, [ResultLanguageTag])
- NumberOrDateTime: obligatori. El nombre o el valor de data i hora del format.
- DateTimeFormat: obligatori. Membre de l'enumeració DateTimeFormat.
- ResultLanguageTag: opcional. L'etiqueta de llengua que s'utilitzarà per al text del resultat. Per defecte, s'utilitza la llengua de l'usuari actual.
Text(NumberOrDateTime, CustomFormat, [ResultLanguageTag])
- Número: obligatori. El nombre o el valor de data i hora del format.
- CustomFormat: obligatori. Un o diversos marcadors de posició tancats entre cometes dobles.
- ResultLanguageTag: opcional. L'etiqueta de llengua que s'utilitzarà per al text del resultat. Per defecte, s'utilitza la llengua de l'usuari actual.
Text(AnyValue)
- AnyValue: obligatori. Valor que es convertirà en una representació de text. S'utilitza un format per defecte.
Text ( sense tipus )
- Sense tipus: obligatori. Objecte sense tipus que representa una cadena. Els valors acceptables depenen del proveïdor sense tipus. Per a JSON, si l'objecte sense escriure és un número o booleà, es convertirà en text.
Exemples
Llevat que s'especifiqui el contrari, l'usuari que executa aquestes fórmules està situat als Estats Units i ha seleccionat l'anglès com a llengua. La funció Language torna "en-US".
Número
| Fórmula | Descripció | Resultat |
|---|---|---|
| Text( 1234.59, "####.#" ) | Formata el nombre amb un decimal. | "1234.6" |
| Text( 8.9, "#.000" ) | Amplia els decimals del nombre amb zeros a la dreta, si cal. | "8.900" |
| Text( 0.631, "0.#" ) | Amplia el nombre enter amb zeros a l'esquerra, si cal. | "0.6" |
| Text( 12, "#.0#" ) Text( 1234.568, "#.0#" ) |
Amplia els decimals del nombre amb zeros per a un decimal i inclou un segon decimal si es proporciona. | "12.0" "1234.57" |
| Text( 12000, "$ #,###" ) Text( 1200000, "$ #,###" ) |
Situa un separador de milers cada tres dígits i inclou un símbol monetari. | "$ 12,000" "$ 1,200,000" |
Data i hora
- A les 2:37:47 PM del dilluns 23 de novembre de 2015
- Fus horari del Pacífic dels Estats Units (UTC-8)
| Fórmula | Descripció | Resultat |
|---|---|---|
| Text(Now(), DateTimeFormat.LongDate) | Format com a cadena de data llarga, en la llengua i la configuració regional de l'usuari actual. | "Dilluns, 23 de novembre de 2015" |
| Text(Now(), DateTimeFormat.LongDateTime) | Format com a cadena de data i hora llarga, en la llengua i la configuració regional de l'usuari actual, amb un rellotge de 12 hores. | "Dilluns, 23 de novembre de 2015 2:37:47 PM" |
| Text(Now(), DateTimeFormat.LongTime24) | Format com a cadena d'hora llarga, amb un rellotge de 24 hores. | "14:37:47" |
| Text(Now(), DateTimeFormat.ShortDate) | Format com a cadena de data curta, en la llengua i la configuració regional de l'usuari actual. | "11/23/2015" |
| Text( Now(), "d-mmm-yy" ) | Format amb caràcters de marcador de posició:
|
"23-Nov-15" |
| Text(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") | Mostra un valor de data i hora de UNIX en format llegible si multipliqueu el valor d'origen per 1.000. | "Nov. 23, 2015 (02:47:37 PM)" |
Aplicacions globals
| Fórmula | Descripció | Resultat |
|---|---|---|
| Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") | Mostra un espai com a separador d'agrupament, la coma com a separador decimal i € com a símbol monetari. | "1 234 567,89 €" |
| Text(1234567,89; "[$-fr-FR]# ###,## €") | Si les dades d'origen segueixen el costum francès d'utilitzar una coma com a separador decimal, heu de canviar la configuració regional al francès i separar els arguments amb un punt i coma en comptes de comes per obtenir el mateix resultat que a dalt. | "1 234 567,89 €" |
| Text( Date(2016,1,31), "dddd mmmm d" ) | Torna el dia de la setmana, el mes i el dia del mes en la llengua de l'usuari actual. Com que cap dels marcadors de posició depèn de la llengua, no cal cap etiqueta de llengua de text de format. | "Diumenge, 31 de gener" |
| Text(Date(2016,1,31), "dddd mmmm d"", "es-ES") | Torna el dia de la setmana, el mes i el dia del mes en la llengua "es-ES". | "domingo enero 31" |
Convertir valors en text
| Fórmula | Descripció | Resultat |
|---|---|---|
| Text( 1234567.89 ) | Converteix un número en una cadena. No hi ha cap separador de milers ni control sobre el nombre de dígits abans o després del separador decimal; per obtenir més control, proporcioneu marcadors de posició de nombre com a segon argument. | "1234567.89" |
| Text( DateTimeValue( "01/04/2003" ) ) | Converteix un valor de data i hora en una cadena de text. Per controlar la conversió, proporcioneu un membre de l'enumeració DateTimeFormat o una cadena de format personalitzat. | "1/4/2003 12:00 AM" |
| Text( true ) | Converteix un valor booleà en una cadena. | "true" |
| Text( GUID() ) | Converteix el valor de GUID generat en una cadena. | "f8b10550-0f12-4f08-9aa3-bb10958bc3ff" |
| Left( Text( GUID() ), 4 ) | Retorna els quatre primers caràcters d'un GUID generat. | "2d9c" |