Tekstna funkcija
Odnosi se na:
Aplikacije od gotovih gradivnih elemenata Stupci Dataverse formula aplikacija Aplikacije Power Platform stvorene prema modelu CLI
Pretvara bilo koju vrijednost i oblikuje broj ili datum/vrijeme u tekstni niz.
Opis
Funkcija Text oblikuje broj ili vrijednost datum/vrijeme na temelju jedne od sljedećih vrsta argumenata:
- Unaprijed definirani oblik datum/vrijeme koji zadajete pomoću enumeracije DateTimeFormat. Za datume i vremena, ovaj je pristup poželjan jer se automatski prilagođava jeziku i regiji svakog korisnika.
- Prilagođeni format, koji sadrži niz rezerviranih mjesta koja definiraju, na primjer, hoće li se u brojevima prikazati decimalni razdjelnik, a u datumima pun naziv mjeseca, mjesec kao kratica ili mjesec kao broj. Power Apps podržava podskup rezerviranih mjesta iz programa Microsoft Excel. U ovom nizu, rezervirano mjesto jezika određuje jezik kojim će se tumačiti ostala rezervirana mjesta. Ako prilagođeni oblik uključuje neko razdoblje, na primjer, rezervirano mjesto za jezični oblik određuje je li razdoblje decimalni razdjelnik (ja-JP) ili razdjelnik tisuća (es-ES).
Za dodatne informacije pogledajte rad s datumima i vremenima.
Funkcija Text također može pretvoriti bilo koju vrstu podataka u tekst koristeći zadani oblik. Upotrijebite ovo kako biste proslijedili vrijednosti koje nisu oblika teksta u funkcije za rad s tekstom poput Len, Right i IsMatch.
Unaprijed definirani oblici datum/vrijeme
U ovim primjerima koriste se datum i vrijeme utorak, 7. travnja 2020. 8:26:59.180 popodne, u vremenskoj zoni UTC-7.
| Enumeracija DateTimeFormat | Opis | Primjeri (za regiju en-US) |
|---|---|---|
| LongDate | Četveroznamenkasta godina, naziv mjeseca, dan u mjesecu i dan u tjednu. Nazivi mjeseca i dana u tjednu nisu skraćeni. | „Tuesday, April 7, 2020” |
| LongDateTime | Četveroznamenkasta godina, naziv mjeseca, dan u mjesecu i dan u tjednu, kao i sati (12-satni prikaz), minute, sekunde i oznaka AM/PM. Nazivi mjeseca i dana u tjednu nisu skraćeni. | „Tuesday, April 7, 2020 8:26:59 PM” |
| LongDateTime24 | Četveroznamenkasta godina, mjesec, dan u mjesecu i dan u tjednu, kao i sati (24-satni prikaz), minute i sekunde. Nazivi mjeseca i dana u tjednu nisu skraćeni. | „Tuesday, April 7, 2020 20:26:59” |
| LongTime | Sati (12-satni prikaz), minute, sekunde i oznaka AM/PM. | „8:26:59 PM” |
| LongTime24 | Sati (24-satni prikaz), minute, sekunde. | „20:26:59” |
| ShortDate | Četveroznamenkasta godina s brojkom mjeseca i danom u mjesecu. | „4/7/2020” |
| ShortDateTime | Četveroznamenkasta godina s brojkom mjeseca i danom u mjesecu, kao i sati (12-satni prikaz), minute i oznaka AM/PM. | „4/7/2020 8:26 PM” |
| ShortDateTime24 | Četveroznamenkasta godina s brojkom mjeseca i danom u mjesecu, kao i sati (24-satni prikaz) i minute. | „4/7/2020 20:26” |
| ShortTime | Sati (12-satni prikaz), minute i oznaka AM/PM. | „8:26 PM” |
| ShortTime24 | Sati (24-satni prikaz) i minute. | „20:26” |
| UTC | Vrijednost datum/vrijeme pretvorena u UTC na temelju vremenske zone trenutačnog korisnika i oblikovana u skladu s ISO 8601 standardom. | „2020-04-08T03:26:59.180Z” |
Rezervirana mjesta za brojke
| Rezervirano mjesto | Opis |
|---|---|
| 0 (nula) | Prikazuje neznačajne nule ako neki broj ima manje znamenki nego što ima nula u tom obliku. Na primjer, koristite oblik #.00 želite li prikazati 8.9 kao 8.90. |
| # | Slijedi ista pravila kao 0 (nula). Međutim, Text ne vraća dodatne nule kada broj ima manje znamenki s neke strane decimalnog razdjelnika nego što ima simbola # u tom obliku. Na primjer, prikazuje se 8.9 ako je prilagođeni oblik #.##, a broj za oblikovanje 8.9. |
| , (točka) | Prikazuje decimalnu točku u nekom broju. Ovisi o jeziku prilagođenog oblika; za više pojedinosti vidjeti globalne aplikacije. |
| , (zarez) | Prikazuje razdjelnik grupiranja u broju, koji se često koristi u tisućama. Funkcija Text razdvaja grupe zarezima ako oblik sadrži zarez koji je okružen brojevnim znakovima (#) ili nulama. Ovisi o jeziku prilagođenog oblika; za više pojedinosti vidjeti globalne aplikacije. |
Ako broj ima više znamenki desno od decimalne točke nego što ima rezerviranih mjesta u tom obliku, broj se zaokružuje na onoliko decimalnih mjesta koliko ima rezerviranih mjesta. Ako je lijevo od decimalne točke više znamenki nego što ima rezerviranih mjesta, prikazuju se dodatne znamenke. Ako format sadrži samo brojevne znakove (#) lijevo od decimalne točke, brojevi manji od 1 počinju decimalnom točkom (na primjer, .47).
Rezervirana mjesta za datum i vrijeme
| Rezervirano mjesto | Opis |
|---|---|
| m | Prikazuje mjesec kao broj bez vodeće nule. |
| mm | Prikazuje mjesec kao broj s vodećom nulom kad je to prikladno. |
| mmm | Prikazuje mjesec kao kraticu (od Jan do Dec). |
| mmmm | Prikazuje mjesec kao pun naziv (od January do December). |
| d | Prikazuje dan kao broj bez vodeće nule. |
| dd | Prikazuje dan kao broj s vodećom nulom kad je to prikladno. |
| ddd | Prikazuje dan kao kraticu (od Sun do Sat). |
| dddd | Prikazuje dan kao pun naziv (od Sunday do Saturday). |
| yy | Prikazuje godinu kao dvoznamenkasti broj. |
| yyyy | Prikazuje godinu kao četveroznamenkasti broj. |
| h | Prikazuje sate kao broj bez vodeće nule. |
| hh | Prikazuje sate kao broj s vodećom nulom kad je to prikladno. Ako oblik sadrži AM ili PM, prikazani su sati na temelju 12-satnog prikaza. U suprotnom, sati se prikazuju na temelju 24-satnog prikaza. |
| m | Prikazuje minute kao broj bez vodeće nule. Ovo rezervirano mjesto mora se pojaviti odmah nakon oznake h ili hh ili neposredno prije oznake ss; u suprotnom, funkcija Text vraća mjesec umjesto minuta. |
| mm | Prikazuje minute kao broj s vodećom nulom kad je to prikladno. Ovo rezervirano mjesto mora se pojaviti odmah nakon rezerviranog mjesta h ili hh ili neposredno prije rezerviranog mjesta ss. U suprotnom, Text vraća mjesec umjesto minuta. |
| s | Prikazuje sekunde kao broj bez vodeće nule. |
| ss | Prikazuje sekunde kao broj s vodećom nulom kad je to prikladno. |
| f | Prikazuje djeliće sekunde. |
| AM/PM, a/p | Prikazuje sate na temelju 12-satnog prikaza. Text vraća „AM” ili „a” za vrijeme od ponoći do podneva, a „PM” ili „p” za vrijeme od podneva do ponoći |
Znakovna rezervirana mjesta
U string oblika možete unijeti bilo koji od ovih znakova. Oni će se pojaviti u rezultatu funkcije Text kakvi jesu. Dodatni znakovi rezervirani su za buduća rezervirana mjesta, tako da ih ne biste trebali koristiti.
| Znak | Opis |
|---|---|
| Bilo koji simbol valute | Znak dolara, znak centa, znak eura itd. |
| + | Znak plus |
| ( | Lijeva obična zagrada |
| : | Dvotočka |
| ^ | Cirkumfleks (karet) |
| ' | Apostrof |
| { | Lijeva vitičasta zagrada |
| < | Znake manje |
| = | Znak jednako |
| - | Znak minus |
| / | Kosa crta |
| ) | Desna obična zagrada |
| & | Ampersend |
| ~ | Tilda |
| } | Desna vitičasta zagrada |
| > | Znak veće |
| Razmak |
Globalne aplikacije
Funkcija Text globalno je prilagođena. U širokom spektru jezika zna kako pravilno napisati datume, vremena, valute i brojeve. Da bi radila pravilno, treba dvije informacije:
- Jezik prilagođenog oblika: Autori žele znati – kako treba tumačiti neki prilagođeni oblik? Znakovi razdjelnika (. i ,) imaju različita značenja na različitim jezicima. Ako odredite neki prilagođeni oblik, možete unijeti rezervirano mjesto za jezik ili uzeti zadanu vrijednost koja odražava jezik postavljen na vašem uređaju. Još je lakše koristiti jedan od unaprijed definiranih oblika datum/vrijeme koji su neovisni o jeziku.
- Jezik rezultata: Korisnici žele znati – na kojem se jeziku trebaju pojaviti rezultati funkcije? Nazivi mjeseca i dana u tjednu moraju biti na jeziku koji odgovara korisniku aplikacije, što možete odrediti dodavanjem trećeg, neobveznog argumenta u funkciji Text.
U oba slučaja, jezik određujete pomoću jezične oznake. Da biste vidjeli popis podržanih jezika, upišite Text( 1234, "", ) u traku za formule ili na karticu Napredno desnog okna, a zatim prođite kroz popis regionalnih shema predloženih za treći argument.
Rezervirano mjesto za jezik
Da biste odredili jezik prilagođenog oblika, koristite:
| Rezervirano mjesto | Opis |
|---|---|
| [$-LanguageTag] | LanguageTag jezična je oznaka koju vraća funkcija Language. Može odrediti samo jezik (kao što je [$-en] za engleski jezik) ili može odrediti regiju (kao što je [$-en-GB] da dodatno precizira Veliku Britaniju). |
Rezervirano mjesto za jezik može se pojaviti bilo gdje u prilagođenom obliku, ali samo jednom.
Ako odredite prilagođeni oblik bez rezerviranog mjesta za jezik, a oblik je s globalnog stajališta nejasan, automatski se umeće jezična oznaka za vaš trenutačni jezik.
[$-en-US] se pretpostavlja ako ovo rezervirano mjesto nije prisutno pri pokretanju vaše aplikacije.
Napomena
U nekoj budućoj verziji, sintaksa ovog rezerviranog mjesta može se promijeniti kako bi se izbjegla zbrka sa sličnim, ali ipak različitim rezerviranim mjestima koje podržava program Excel.
Oznaka jezika rezultata
Rezultat funkcije Text sadrži prevedene nizove za mjesece, dane u tjednu i AM/PM oznake, kao i odgovarajući razdjelnik grupiranja i decimalni razdjelnik.
Prema zadanim postavkama, funkcija Text koristi jezik korisnika koji pokreće aplikaciju. Funkcija Language vraća jezičnu oznaku za trenutačnog korisnika. Možete nadjačati ovu zadanu vrijednost unosom jezične oznake za treći argument u funkciji Text.
Sintaksa
Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )
- NumberOrDateTime – obavezno. Broj ili vrijednost datum/vrijeme koji se oblikuje.
- DateTimeFormat – obavezno. Član enumeracije DateTimeFormat.
- ResultLanguageTag – neobavezno. Jezična oznaka koja će se koristiti za tekst rezultata. Prema zadanim postavkama, koristi se jezična postavka trenutačnog korisnika.
Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )
- Number – obavezno. Broj ili vrijednost datum/vrijeme koji se oblikuje.
- CustomFormat – obavezno. Jedno ili više rezerviranih mjesta u navodnicima.
- ResultLanguageTag – neobavezno. Jezična oznaka koja će se koristiti za tekst rezultata. Prema zadanim postavkama, koristi se jezična postavka trenutačnog korisnika.
Text( AnyValue )
- AnyValue – obavezno. Vrijednost koju treba pretvoriti u tekst. Koristi se zadani oblik.
Tekst ( Netipiziran )
- Untyped – obavezno. Netipizirani objekt koji predstavlja niz. Prihvatljive vrijednosti ovise o netipiziranom davatelju. Za JSON, ako je netipizirani objekt broj ili boole, pretvorit će se u tekst.
Primjeri
Osim ako je drugačije navedeno, korisnik koji koristi ove formule nalazi se u Sjedinjenim Američkim Državama i kao svoj jezik odabrao je engleski. Funkcija Language vraća „en-US”.
Broj
| Formula | Opis | Rezultat |
|---|---|---|
| Text( 1234.59, "####.#" ) | Oblikuje broj s jednim decimalnim mjestom. | „1234.6” |
| Text( 8.9, "#.000" ) | Dopunjava decimalni dio broja završnim nulama, ako je potrebno. | „8.900” |
| Text( 0.631, "0.#" ) | Dopunjava cjelobrojni dio broja vodećim nulama, ako je potrebno. | „0.6” |
| Text( 12, "#.0#" ) Text( 1234.568, "#.0#" ) |
Dopunjava decimalni dio broja nulom za prvo decimalno mjesto i prikazuje drugo decimalno mjesto ako postoji. | „12.0” „1234.57” |
| Text( 12000, "$ #,###" ) Text( 1200000, "$ #,###" ) |
Smješta razdjelnik tisuća na svake tri znamenke i stavlja simbol valute. | "$ 12,000" "$ 1,200,000" |
Date/Time
- U 2:37:47 PM dana Monday, November 23, 2015
- Sjedinjene Države, pacifička vremenska zona (UTC-8)
| Formula | Opis | Rezultat |
|---|---|---|
| Text( Now(), DateTimeFormat.LongDate ) | Oblikuje se kao dugačak niz datuma na jeziku i regionalnoj shemi trenutačnog korisnika. | „Monday, November 23, 2015” |
| Text( Now(), DateTimeFormat.LongDateTime ) | Oblikuje se kao dugačak niz datuma i vremena na jeziku i regionalnoj shemi trenutačnog korisnika, uz 12-satni prikaz. | „Monday, November 23, 2015 2:37:47 PM” |
| Text( Now(), DateTimeFormat.LongTime24 ) | Oblikuje se kao dugačak vremenski niz, uz 24-satni prikaz. | „14:37:47” |
| Text( Now(), DateTimeFormat.ShortDate ) | Oblikuje se kao kratak niz datuma na jeziku i regionalnoj shemi trenutačnog korisnika. | „11/23/2015” |
| Text( Now(), "d-mmm-yy" ) | Oblikuje se pomoću znakova rezerviranog mjesta:
|
„23-Nov-15” |
| Text(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") | Prikazuje Unix vrijednost datum/vrijeme u ljudski čitljivom obliku ako pomnožite izvornu vrijednost s 1000. | „Nov. 23, 2015 (02:47:37 PM)” |
Globalne aplikacije
| Formula | Opis | Rezultat |
|---|---|---|
| Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") | Prikazuje razmak kao razdjelnik grupiranja, zarez kao decimalni razdjelnik i € kao simbol valute. | "1 234 567,89 €" |
| Text(1234567,89; "[$-fr-FR]# ###,## €") | Ako izvorni podatci slijede francuski običaj korištenja zareza kao decimalnog razdjelnika, morate promijeniti regionalnu shemu na francusku i razdvojiti argumente točkom sa zarezom umjesto zarezom kako biste dobili isti rezultat kao gore. | "1 234 567,89 €" |
| Text( Date(2016,1,31), "dddd mmmm d" ) | Vraća dan u tjednu, mjesec i dan u mjesecu na jeziku trenutačnog korisnika. Budući da nijedno od rezerviranih mjesta ne ovisi o jeziku, nema potrebe za jezičnom oznakom za oblik teksta. | "Sunday January 31" |
| Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) | Vraća dan u tjednu, mjesec i dan u mjesecu na jeziku „es-ES”. | "domingo enero 31" |
Pretvaranje vrijednosti u tekst
| Formula | Opis | Rezultat |
|---|---|---|
| Text( 1234567.89 ) | Pretvara broj u niz. Ne postoji razdjelnici tisuća niti kontrola nad brojem znamenki prije ili nakon decimalnog razdjelnika; za veću kontrolu, kao drugi argument navedite rezervirana mjesta brojeva. | „1234567.89” |
| Text( DateTimeValue( "01/04/2003" ) ) | Pretvara vrijednost datum/vrijeme u tekstni niz. Da biste kontrolirali pretvorbu, navedite ili člana enumeracije DateTimeFormat ili niz prilagođenog oblika. | „1/4/2003 12:00 AM” |
| Text( true ) | Pretvara Booleovu vrijednost u niz. | „true” |
| Text( GUID() ) | Pretvara generiranu vrijednost GUID u niz. | „f8b10550-0f12-4f08-9aa3-bb10958bc3ff” |
| Left( Text( GUID() ), 4 ) | Vraća prva četiri znaka generiranog GUID-a. | „2d9c” |