Text (funcția text)
Se aplică la:
Aplicații proiectate pe pânză Aplicații proiectate pe pânză Coloane de formule Aplicații Dataverse Power Platform proiectate pe bază de model CLI
Convertește orice valoare și formatează un număr sau o valoare de dată/oră într-un șir de text.
Descriere
Funcția Text formatează un număr sau o dată/oră pe baza unuia dintre următoarele tipuri de argumente:
- Un format de dată/oră predefinit, pe care îl specificați utilizând enumerarea DateTimeFormat. Pentru date și ore, această abordare este preferată, deoarece se adaptează automat la limba și regiunea fiecărui utilizator.
- Un format particularizat, care cuprinde un șir de substituenți care definesc, de exemplu, dacă numerele arată un separator zecimal și dacă datele arată numele complet al lunii, luna ca abreviere sau luna ca număr. Power Apps acceptă un subset de substituenți rezervați de Microsoft Excel. În acest șir, substituentul de limbă specifică limba în care să interpreteze ceilalți substituenți. Dacă formatul particularizat include un punct, de exemplu, substituentul formatului limbii specifică dacă punctul este un separator zecimal (ja-JP) sau un separator de mii (es-ES).
Vedeți și lucrul cu date și ore pentru mai multe informații.
Funcția Text poate, de asemenea, să convertească orice tip de date într-o reprezentare a textului folosind un format implicit. Utilizați această funcție pentru a transmite valori non-text la funcții bazate pe text, cum ar fi Len, Right și IsMatch.
Formate de dată/oră predefinite
Pentru aceste exemple, data și ora utilizate sunt marți, 7 aprilie 2020 8:26:59.180 PM, în fusul orar UTC-7 ore.
| Enumerare DateTimeFormat | Descriere | Exemple (care utilizează en-US) |
|---|---|---|
| LongDate | Anul cu patru cifre, numele lunii, ziua din lună și ziua săptămânii. Numele lunii și al zilei din săptămână nu sunt abreviate. | "Marți 7 aprilie 2020" |
| LongDateTime | Anul cu patru cifre, numele lunii, ziua din lună și ziua din săptămână, plus ora (12 ore), minutele, secunde și indicația AM/PM. Numele lunii și al zilei din săptămână nu sunt abreviate. | "Marți 7 aprilie 2020 8:26:59 PM" |
| LongDateTime24 | Anul cu patru cifre, numele lunii, ziua din lună și ziua din săptămână, plus ora (24 de ore), minutele și secundele. Numele lunii și al zilei din săptămână nu sunt abreviate. | "Marți 7 aprilie 2020 20:26:59" |
| LongTime | Ora (12 ore), minutele, secundele și indicația AM/PM. | "8:26:59 PM" |
| LongTime24 | Ora (24 de ore), minutele, secundele. | "20:26:59" |
| ShortDate | Anul cu patru cifre, cu luna numerică și ziua din lună. | "4/7/2020" |
| ShortDateTime | Anul cu patru cifre, cu o lună și o zi din lună numerice, plus ora (12 ore), minutele și indicația AM/PM. | "4/7/2020 8:26 PM" |
| ShortDateTime24 | Anul cu patru cifre, cu o lună și o zi din lună numerice, plus ora (24 ore) și minutele. | "4/7/2020 20:26" |
| ShortTime | Ora (12 ore), minutele și indicația AM/PM. | "8:26 PM" |
| ShortTime24 | Ora (24 de ore) și minutele. | "20:26" |
| UTC | Valoarea dată/oră este convertită în UTC pe baza fusului orar al utilizatorului curent și este formatată conform standardului ISO 8601. | "2020-04-08T03:26:59.180Z" |
Substituenți numerici
| Substituent | Descriere |
|---|---|
| 0 (zero) | Afișează zerouri nesemnificative dacă un număr are mai puține cifre decât zerouri în format. De exemplu, utilizați formatul #.00 dacă doriți să afișați 8.9 ca 8,90. |
| # | Urmează aceleași reguli ca 0 (zero). Totuși, Text nu returnează zerouri suplimentare atunci când numărul are mai puține cifre pe fiecare parte a zecimalei decât numărul de simboluri # din format. De exemplu, se afișează 8.9 dacă formatul particularizat este #.##, iar numărul de formatat este 8.9. |
| . (punct) | Afișează punctul zecimal într-un număr. Depinde de limba formatului particularizat; consultați aplicații globale pentru mai multe detalii. |
| , (virgulă) | Afișează separatorul de grupare într-un număr, adesea folosit pentru mii. Text separă grupurile prin virgule dacă formatul conține o virgulă între semnele numerice (#) sau între zerouri. Depinde de limba formatului particularizat; consultați aplicații globale pentru mai multe detalii. |
Dacă un număr are mai multe cifre în dreapta punctului zecimal decât substituenți în format, valoarea se rotunjește la numărul de zecimale care corespunde cu numărul de substituenți. Dacă există mai multe cifre la stânga punctului zecimal decât substituenți, se afișează cifrele suplimentare. Dacă formatul conține doar semne numerice (#) la stânga punctului zecimal, numerele mai mici de 1 încep cu un separator zecimal (de exemplu, .47).
Substituenții datei și orei
| Substituent | Descriere |
|---|---|
| m | Afișează luna sub formă de număr fără zero în față. |
| mm | Afișează luna sub formă de număr cu un zero în față, după caz. |
| mmm | Afișează luna sub formă de abreviere (ian până la dec). |
| mmmm | Afișează numele complet al lunii (ianuarie până la decembrie). |
| z | Afișează ziua sub formă de număr fără zero în față. |
| dd | Afișează ziua sub formă de număr cu un zero în față, după caz. |
| ddd | Afișează ziua sub formă de abreviere (de dum până sâm). |
| dddd | Afișează numele complet al zilei (de duminică până sâmbătă). |
| yy | Afișează anul ca număr format din două cifre. |
| yyyy | Afișează anul ca număr format din patru cifre. |
| h | Afișează ora sub formă de număr fără zero în față. |
| hh | Afișează ora sub formă de număr cu un zero în față, după caz. Dacă formatul conține AM sau PM, ora este afișată în formatul cu 12 ore. În caz contrar, ora este afișată în formatul cu 24 de ore. |
| m | Afișează minutul sub formă de număr fără zero în față. Acest substituent trebuie să apară imediat după codul h sau hh sau imediat înainte de codul ss; în caz contrar, funcția Text returnează luna în loc de minute. |
| mm | Afișează minutul sub formă de număr cu un zero în față, după caz. Acest substituent trebuie să apară imediat după substituentul h sau hh sau imediat înainte de subtituentul ss. În caz contrar, funcția Text returnează luna în loc de minute. |
| s | Afișează secunda sub formă de număr fără zero în față. |
| ss | Afișează secunda sub formă de număr cu un zero în față, după caz. |
| f | Afișează fracțiunile de secunde. |
| AM/PM, a/p | Afișează ora în format de 12 ore. Funcția Text returnează "AM" sau "a" pentru orele de la miezul nopții până la prânz și "PM" sau "p" pentru orele de la prânz până la miezul nopții |
Substituenți literali
Puteți include oricare dintre aceste caractere în șirul dvs. de format. Ele vor apărea în rezultatul funcției Text ca atare. Caracterele suplimentare sunt rezervate pentru viitorii substituenți, deci nu trebuie să le utilizați.
| Caracter | Descriere |
|---|---|
| Orice simbol monetar | Simbolul pentru dolar, simbolul pentru cenți, simbolul pentru euro etc. |
| + | Semnul plus |
| ( | Paranteza stângă |
| : | Două puncte |
| ^ | Accent circumflex |
| ' | Apostrof |
| { | Acoladă stânga |
| < | Semnul mai mic decât |
| = | Semnul egal |
| - | Semnul minus |
| / | Semnul bară oblică |
| ) | Paranteza dreaptă |
| & | Ampersand |
| ~ | Tildă |
| } | Acoladă dreapta |
| > | Semnul mai mare decât |
| Caracter de spațiu |
Aplicații globale
Funcția Text recunoaște toate limbile. Pentru un număr mare de limbi, știe să scrie corect data, ora, monede și numere. Pentru a funcționa corespunzător, are nevoie de două informații:
- Limba formatului particularizat: Pentru creatori, cum ar trebui interpretat un format particularizat? Caracterele separator (. și ,) au semnificații diferite în funcție de limbă. Dacă specificați un format particularizat, puteți include un substituent de limbă sau puteți lua valoarea implicită, care reflectă limba în care este setat dispozitivul dvs. Chiar și mai ușor, puteți utiliza unul dintre formatele de dată/oră predefinite, care sunt agnostice cu privire la limbă.
- Limba rezultatului: Pentru utilizatori, în ce limbă ar trebui să apară rezultatul funcției? Numele lunilor și zilelor săptămânii trebuie să fie în limba corespunzătoare pentru utilizatorul aplicației, pe care o puteți specifica adăugând un al treilea argument opțional la funcția Text.
Pentru ambele, specificați limba utilizând o etichetă de limbă. Pentru a vedea lista de limbi acceptate, tastați Text( 1234, "", ) în bara de formule sau în panoul din dreapta al filei Complex și apoi parcurgeți lista de setări regionale sugerate pentru al treilea argument.
Substituent de limbă
Pentru a specifica limba formatului particularizat, utilizați:
| Substituent | Descriere |
|---|---|
| [$-LanguageTag] | LanguageTag este o etichetă de limbă returnată de funcția Language. Poate specifica doar limba (de ex [$-En] pentru engleză) sau poate specifica și regiunea (de ex [$-en-GB] pentru a preciza în continuare Marea Britanie). |
Substituentul de limbă poate apărea oriunde în formatul particularizat, dar o singură dată.
Dacă specificați un format particularizat fără un substituent de limbă, iar formatul este ambiguu din punct de vedere global, eticheta de limbă pentru limba dvs. curentă este introdusă automat.
Se folosește [$-en-US] dacă substituentul nu este prezent când aplicația dvs. este rulată.
Notă
Într-o versiune viitoare, sintaxa acestui substituent s-ar putea modifica pentru a se evita confuzia cu un substituent asemănător, dar diferit, acceptat de Excel.
Eticheta de limbă a rezultatului
Rezultatul textului include șiruri traduse pentru luni, zilele săptămânii și indicații AM/PM, precum și grupul și separatoarele zecimale corespunzătoare.
În mod implicit, funcția Text utilizează limba utilizatorului care rulează aplicația. Funcția Language returnează eticheta de limbă pentru utilizatorul curent. Puteți înlocui această valoare implicită furnizând o etichetă de limbă pentru cel de-al treilea argument al textului.
Sintaxă
Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )
- NumberOrDateTime - Obligatoriu. Numărul sau valoarea datei/orei de formatat.
- DateTimeFormat - Obligatoriu. Membru al enumerării DateTimeFormat.
- ResultLanguageTag - Opțional. Eticheta de limbă de utilizat pentru textul rezultatului. În mod implicit, este utilizată limba utilizatorului curent.
Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )
- Number - Obligatoriu. Numărul sau valoarea datei/orei de formatat.
- CustomFormat - Obligatoriu. Unul sau mai mulți substituenți incluși între ghilimele duble.
- ResultLanguageTag - Opțional. Eticheta de limbă de utilizat pentru textul rezultatului. În mod implicit, este utilizată limba utilizatorului curent.
Text( AnyValue )
- AnyValue - Obligatoriu. Valoare de convertit într-o reprezentare a textului. Se folosește un format implicit.
Text ( Untyped )
- Untyped - Obligatoriu. Obiect netipizat care reprezintă un șir. Valorile acceptabile depind de furnizorul netipificat. Pentru JSON, dacă obiectul netastat este un număr sau boolean, acesta va fi convertit în text.
Exemple
Dacă nu se specifică altfel, utilizatorul care rulează aceste formule se află în Statele Unite și a selectat engleza ca limbă. Funcția Language returnează "en-US".
Număr
| Formulă | Descriere | Rezultat |
|---|---|---|
| Text( 1234.59, "####.#" ) | Formatează numărul cu o zecimală. | "1234.6" |
| Text( 8.9, "#.000" ) | Umple porțiunea zecimală a numărului cu zerouri de final, dacă este necesar. | "8.900" |
| Text( 0.631, "0.#" ) | Umple întreaga porțiune a numărului cu zerouri inițiale, dacă este necesar. | "0.6" |
| Text( 12, "#.0#" ) Text( 1234.568, "#.0#" ) |
Umple porțiunea zecimală a numărului cu zerouri pentru o zecimală și include o a doua zecimală dacă este furnizată. | "12.0" "1234.57" |
| Text( 12000, "$ #,###" ) Text( 1200000, "$ #,###" ) |
Plasează un separator de mii la fiecare trei cifre și include un simbol monetar. | "$ 12,000" "$ 1,200,000" |
Dată/Oră
- La 2:37:47 PM în data de Monday, November 23, 2015
- Fusul orar Statele Unite, Pacific (UTC-8)
| Formulă | Descriere | Rezultat |
|---|---|---|
| Text( Now(), DateTimeFormat.LongDate ) | Formatează ca șir de dată lung, în limba și setările regionale ale utilizatorului curent. | "Luni 23 noiembrie 2015" |
| Text( Now(), DateTimeFormat.LongDateTime ) | Formatează ca șir de dată și oră lung, în limba și setările regionale ale utilizatorului curent., folosind formatul de 12 ore. | "Luni 23 noiembrie 2015 2:37:47 PM" |
| Text( Now(), DateTimeFormat.LongTime24 ) | Formatează ca șir de oră lung, folosind formatul de 24 de ore. | "14:37:47" |
| Text( Now(), DateTimeFormat.ShortDate ) | Formatează ca șir de dată scurt, în limba și setările regionale ale utilizatorului curent. | "11/23/2015" |
| Text( Now(), "d-mmm-yy" ) | Formatează cu ajutorul caracterelor substituentului:
|
"23-Nov-15" |
| Text(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") | Afișează o valoare a datei și orei Unix în format lizibil dacă înmulțiți valoarea sursă cu 1.000. | "Nov. 23, 2015 (02:47:37 PM)" |
Aplicații globale
| Formulă | Descriere | Rezultat |
|---|---|---|
| Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") | Arată un spațiu ca separator de grupare, virgula ca separator zecimal și € ca simbol monetar. | "1 234 567,89 €" |
| Text(1234567,89; "[$-fr-FR]# ###,## €") | Dacă datele sursă urmează particularizarea franceză de a folosi o virgulă ca separator zecimal, trebuie să modificați setările regionale în franceză și să separați argumentele cu punct și virgulă în loc de virgulă pentru a obține același rezultat ca mai sus. | "1 234 567,89 €" |
| Text( Date(2016,1,31), "dddd mmmm d" ) | Returnează ziua din săptămână, luna și ziua din lună în limba utilizatorului curent. Deoarece niciunul dintre substituenți nu depinde de limbă, nu este necesară o etichetă de limbă a textului de format. | "Sunday January 31" |
| Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) | Returnează ziua din săptămână, luna și ziua din lună în limba "es-ES". | "domingo enero 31" |
Convertirea valorilor în text
| Formulă | Descriere | Rezultat |
|---|---|---|
| Text( 1234567.89 ) | Convertește un număr într-un șir. Nu există separatoare de mii, nici control asupra numărului de cifre înainte sau după separatorul zecimal; pentru mai mult control, furnizați substituenți numerici ca al doilea argument. | "1234567.89" |
| Text( DateTimeValue( "01/04/2003" ) ) | Convertește o valoare dată/oră într-un șir de text. Pentru a controla conversia, furnizați fie un membru al enumerării DateTimeFormat, fie un șir de format particularizat. | "1/4/2003 12:00 AM" |
| Text( true ) | Convertește o valoare booleană într-un șir. | "true" |
| Text( GUID() ) | Convertește un GUID generat într-un șir. | "f8b10550-0f12-4f08-9aa3-bb10958bc3ff" |
| Left( Text( GUID() ), 4 ) | Returnează primele patru caractere ale unui GUID generat. | "2d9c" |