Funkcija besedila
Velja za:
Aplikacije delovnega območja Stolpci formule aplikacij Dataverse delovnega območja Aplikacije , Power Platform ki temeljijo na modelu CLI
Pretvori katerokoli vrednost in oblikuje število ali vrednost datuma/časa v niz besedila.
Opis
Funkcija Text oblikuje število ali vrednost datuma/časa na podlagi ene od teh vrst argumentov:
- Vnaprej določena oblika datuma/časa, ki jo določite z oštevilčenjem DateTimeFormat. To je prednostni način pri datumih in časih, saj se samodejno prilagodi jeziku in regiji posameznega uporabnika.
- Oblika zapisa po meri, ki sestavlja niz označb mest, ki na primer določajo, ali številke prikažejo decimalno ločilo in ali datumi prikažejo polno ime meseca, mesec kot okrajšavo ali mesec kot številko. Power Apps podpira isto podmnožico označb mest kot Microsoft Excel. V tem nizu označba mesta za jezik določa jezik, v katerem se bodo interpretirale ostale označbe mesta. Če oblika po meri vključuje piko, označba mesta za obliko zapisa jezika na primer določa, ali je pika decimalno ločilo (ja-JP) ali ločilo za tisočice (es-ES).
Če želite več informacij, glejte članek o delu z datumi in časi.
Funkcija Text lahko tudi pretvori katerokoli vrsto podatkov v ponazoritev besedila s privzeto obliko zapisa. Uporabite jo za posredovanje nebesedilnih vrednosti v funkcije, ki temeljijo na besedilu, kot so Len, Right in IsMatch.
Vnaprej določene oblike zapisa datuma/časa
V teh primerih se za datum in čas uporablja torek, 7. april 2020, 20:26:59.180 v časovnem pasu UTC-7.
| Enumerator DateTimeFormat | Opis | Primeri (uporablja se en-US) |
|---|---|---|
| LongDate | Štirimestno leto, ime meseca, dan v mesecu in dan v tednu. Imeni meseca in dneva v tednu nista okrajšani. | "Tuesday, April 7, 2020" |
| LongDateTime | Štirimestno leto, ime meseca, dan v mesecu in dan v tednu ter ura (12-urni zapis), minute, sekunde in oznaka AM/PM. Imeni meseca in dneva v tednu nista okrajšani. | "Tuesday, April 7, 2020 8:26:59 PM" |
| LongDateTime24 | Štirimestno leto, mesec, dan v mesecu in dan v tednu ter ura (24-urni zapis), minute in sekunde. Imeni meseca in dneva v tednu nista okrajšani. | "Tuesday, April 7, 2020 20:26:59" |
| LongTime | Ura (12-urni zapis), minute, sekunde in oznaka AM/PM. | "8:26:59 PM" |
| LongTime24 | Ura (24-urni zapis), minute in sekunde. | "20:26:59" |
| ShortDate | Štirimestno leto ter mesec in dan v mesecu v številski obliki. | "4/7/2020" |
| ShortDateTime | Štirimestno leto, mesec in dan v mesecu v številski obliki ter ura (12-urni zapis), minute in oznaka AM/PM. | "4/7/2020 8:26 PM" |
| ShortDateTime24 | Štirimestno leto, mesec in dan v mesecu v številski obliki ter ura (24-urni zapis) in minute. | "4/7/2020 20:26" |
| ShortTime | Ura (12-urni zapis), minute in oznaka AM/PM. | "8:26 PM" |
| ShortTime24 | Ura (24-urni zapis) in minute. | "20:26" |
| UTC | Vrednost datuma/časa se pretvori v UTC na podlagi časovnega pasu trenutnega uporabnika in se oblikuje v skladu s standardom ISO 8601. | "2020-04-08T03:26:59.180Z" |
Številske označbe mest
| Označba mesta | Opis |
|---|---|
| 0 (nič) | Prikaže nepomembne ničle, če ima število manj številk, kot je ničel v obliki zapisa. Uporabite na primer obliko zapisa #.00, če želite prikazati 8.9 kot 8.90. |
| # | Sledi istim pravilom kot 0 (nič). Vendar pa funkcija Text ne vrne dodatnih ničel, če ima število manj številk na katerikoli strani decimalnega ločila, kot je simbolov # v obliki zapisa. 8.9 se na primer prikaže, če je oblika zapisa po meri #.## in številka za oblikovanje 8.9. |
| , (pika) | Prikaže decimalno piko v številu. Označba mesta je odvisna od jezika oblike zapisa po meri; za več informacij glejte globalne aplikacije. |
| , (vejica) | Prikaže ločilo skupin v številu; pogosto se uporablja za tisočice. Funkcija Text loči skupine z vejicami, če oblika zapisa vsebuje vejico, ki je obdana s številskimi znaki (#) ali z ničlami. Označba mesta je odvisna od jezika oblike zapisa po meri; za več informacij glejte globalne aplikacije. |
Če ima število za decimalnim ločilom več številk, kot je označb mesta v obliki zapisa, se število zaokroži na toliko decimalnih mest, kot je označb mest. Če je pred decimalnim ločilom več številk, kot je označb mest, so dodatne številke prikazane. Če oblika zapisa vsebuje le številske znake (#) pred decimalnim ločilom, se številke, ki so manjše od 1, začnejo z decimalnim ločilom (na primer .47).
Označbi mest za datum in čas
| Označba mesta | Opis |
|---|---|
| m | Prikaže mesec kot številko brez vodilne ničle. |
| mm | Prikaže mesec kot številko z vodilno ničlo, ko je to ustrezno. |
| mmm | Prikaže mesec kot kratico (Jan do Dec). |
| mmmm | Prikaže mesec kot polno ime (januar do december). |
| dni | Prikaže dan kot številko brez vodilne ničle. |
| dd | Prikaže dan kot številko z vodilno ničlo, ko je to ustrezno. |
| ddd | Prikaže dan kot kratico (ned do sob). |
| dddd | Prikaže dan kot polno ime (nedelja do sobota). |
| yy | Prikaže leto kot dvomestno številko. |
| yyyy | Prikaže leto kot štirimestno številko. |
| h | Prikaže uro kot številko brez vodilne ničle. |
| hh | Prikaže uro kot številko z vodilno ničlo, ko je to ustrezno. Če oblika zapisa vsebuje AM ali PM, je ura prikazana na podlagi 12-urnega zapisa. V nasprotnem primeru je ura prikazana na podlagi 24-urnega zapisa. |
| m | Prikaže minute kot številko brez vodilne ničle. Ta označba mesta mora biti prikazana neposredno za kodo h ali hh oziroma neposredno pred kodo ss; v nasprotnem primeru funkcija Text vrne mesec namesto minut. |
| mm | Prikaže minute kot številko z vodilno ničlo, ko je to ustrezno. Ta označba mesta mora biti prikazana neposredno za označbo mesta h ali hh oziroma neposredno pred označbo mesta ss. V nasprotnem primeru funkcija Text vrne mesec namesto minut. |
| s | Prikaže sekunde kot številko brez vodilne ničle. |
| ss | Prikaže sekunde kot številko z vodilno ničlo, ko je to ustrezno. |
| f | Prikaže delčke sekund. |
| AM/PM, a/p | Prikaže uro na podlagi 12-urnega zapisa. Funkcija Text vrne »AM« ali »a« za čas od polnoči do poldneva in »PM« ali »p« za čas od poldneva do polnoči |
Dobesedne označbe mest
V niz oblike zapisa lahko vključite kateregakoli od spodnjih znakov. V rezultatu funkcije Text bodo prikazani takšni, kot so. Dodatni znaki so rezervirani za prihodnje označbe mest, zato jih ne smete uporabljati.
| Znak | Opis |
|---|---|
| Katerikoli simbol valute | Znak za dolar, znak za cente, znak za evro itd. |
| + | Znak plus |
| ( | Levi oklepaj |
| : | Dvopičje |
| ^ | Cirkumfleks (strešica) |
| ' | Apostrof |
| { | Levi zaviti oklepaj |
| < | Znak »manj kot« |
| = | Enačaj |
| - | Znak minus |
| / | Poševnica |
| ) | Desni oklepaj |
| & | Znak »in« |
| ~ | Tilda |
| } | Desni zaviti oklepaj |
| > | Znak »večje kot« |
| Presledek |
Globalne aplikacije
Funkcija Text deluje globalno. Zna pravilno zapisati datume, čas, valute in številke za številne jezike. Za to potrebuje dva podatka:
- Jezik oblike zapisa po meri: za ustvarjalce; kako se mora interpretirati oblika zapisa po meri? Ločili (. in ,) imata v različnih jezikih različne pomene. Če določite obliko zapisa po meri, lahko vključite označbo mesta za jezik ali uporabite privzeto vrednost, ki odraža jezik, na katerega je nastavljena vaša naprava. Lahko pa uporabite eno od vnaprej določenih oblik zapisa datuma/časa, pri katerih jezik ni znan.
- Jezik rezultata: za uporabnike; v katerem jeziku bo prikazan rezultat funkcije? Imena mesecev in dni v tednu morajo biti v ustreznem jeziku za uporabnika aplikacije, ki ga lahko določite tako, da v funkcijo Text dodate tretji izbirni argument.
Pri obeh določite jezik z uporabo jezikovne oznake. Če si želite ogledati seznam podprtih jezikov, vnesite Text( 1234, "", ) v vnosno vrstico ali zavihek Napredno v desnem podoknu in se nato pomaknite po seznamu območnih nastavitev, predlaganih za tretji argument.
Označba mesta za jezik
Če želite določiti jezik oblike zapisa po meri, uporabite:
| Označba mesta | Opis |
|---|---|
| [$-LanguageTag] | LanguageTag je jezikovna oznaka, ki jo vrne funkcija Language. Določi lahko samo jezik (na primer [$-en] za angleščino) ali tudi regijo (na primer [$-en-GB], da točneje določi Veliko Britanijo). |
Označba mesta za jezik se lahko prikaže kjerkoli v obliki zapisa po meri, vendar le enkrat.
Če določite obliko zapisa po meri brez označbe mesta za jezik in je oblika zapisa nejasna z globalnega vidika, se samodejno vstavi jezikovna oznaka za vaš trenutni jezik.
Če ta označba mesta ni navedena pri zagonu aplikacije, se uporabi [$-en-US].
opomba,
V prihodnji različici se bo sintaksa te označbe mesta morda spremenila, da preprečimo zamenjavo s podobno, vendar drugo označbo mesta, ki jo podpira Excel.
Jezikovna oznaka rezultata
Rezultat funkcije Text vključuje prevedene nize za mesece, dneve v tednu in oznake AM/PM ter ustrezna ločila skupin in decimalna ločila.
Funkcija Text privzeto uporablja jezik uporabnika, ki uporablja aplikacijo. Funkcija Language vrne jezikovno oznako za trenutnega uporabnika. To privzeto vrednost lahko preglasite tako, da v funkcijo Text vnesete jezikovno oznako za tretji argument.
Sintaksa
Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )
- NumberOrDateTime – obvezno. Številka ali vrednost datuma/časa za oblikovanje.
- DateTimeFormat – obvezno. Član oštevilčenja DateTimeFormat.
- ResultLanguageTag – neobvezno. Jezikovna oznaka za besedilo rezultata. Privzeto se uporabi jezik trenutnega uporabnika.
Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )
- Number – obvezno. Številka ali vrednost datuma/časa za oblikovanje.
- CustomFormat – obvezno. Ena ali več označb mest v dvojnih narekovajih.
- ResultLanguageTag – neobvezno. Jezikovna oznaka za besedilo rezultata. Privzeto se uporabi jezik trenutnega uporabnika.
Text( AnyValue )
- AnyValue – obvezno. Vrednost za pretvorbo v ponazoritev besedila. Uporabi se privzeta oblika zapisa.
Text ( Ni vrste )
- Untyped – obvezno. Predmet brez vrste ki predstavlja niz. Sprejemljive vrednosti so odvisne od ponudnika brez vrste. Če je za JSON nevnesen predmet število ali logična vrednost, bo pretvorjen v besedilo.
Primeri
Če ni določeno drugače, se uporabnik, ki uporablja te formule, nahaja v ZDA in je za svoj jezik izbral angleščino. Funkcija Language vrne »en-US«.
Število
| Formula | Opis | Rezultat |
|---|---|---|
| Text( 1234.59, "####.#" ) | Oblikuje število z enim decimalnim mestom. | "1234.6" |
| Text( 8.9, "#.000" ) | Po potrebi razširi decimalni del števila s končnimi ničlami. | "8.900" |
| Text( 0.631, "0.#" ) | Po potrebi razširi celi del števila z vodilnimi ničlami. | "0.6" |
| Text( 12, "#.0#" ) Text( 1234.568, "#.0#" ) |
Razširi decimalni del števila z ničlami za eno decimalno mesto in vključi še eno decimalno mesto, če je navedeno. | "12.0" "1234.57" |
| Text( 12000, "$ #,###" ) Text( 1200000, "$ #,###" ) |
Vstavi ločilo za tisočice na vsake tri številke in vključi simbol valute. | "$ 12,000" "$ 1,200,000" |
Datum/ura
- Ob 14:37:47 v ponedeljek, 23. novembra 2015
- Pacifiški časovni pas (ZDA) (UTC-8)
| Formula | Opis | Rezultat |
|---|---|---|
| Text( Now(), DateTimeFormat.LongDate ) | Oblikuje dolg datumski niz v jeziku in območnih nastavitvah trenutnega uporabnika. | "Monday, November 23, 2015" |
| Text( Now(), DateTimeFormat.LongDateTime ) | Oblikuje dolg niz datuma in časa v jeziku in območnih nastavitvah trenutnega uporabnika v 12-urnem zapisu. | "Monday, November 23, 2015 2:37:47 PM" |
| Text( Now(), DateTimeFormat.LongTime24 ) | Oblikuje dolg časovni niz v 24-urnem zapisu. | "14:37:47" |
| Text( Now(), DateTimeFormat.ShortDate ) | Oblikuje kratek datumski niz v jeziku in območnih nastavitvah trenutnega uporabnika. | "11/23/2015" |
| Text( Now(), "d-mmm-yy" ) | Za oblikovanje uporabi znake označbe mesta:
|
"23-Nov-15" |
| Text(1448318857*1000, "mmm. dd, llll (uu:mm:ss AM/PM)") | Prikaže vrednost datuma in časa Unix v za človeka berljivi obliki zapisa, če prvotno vrednost pomnožite s 1000. | "Nov. 23, 2015 (02:47:37 PM)" |
Globalne aplikacije
| Formula | Description | Rezultat |
|---|---|---|
| Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") | Prikaže presledek kot ločilo skupin, vejico kot decimalno ločilo in € kot simbol valute. | "1 234 567,89 €" |
| Text(1234567,89; "[$-fr-FR]# ###,## €") | Če izvorni podatki sledijo francoski uporabi vejice kot decimalnega ločila, morate spremeniti svoje območne nastavitve v francoščino in ločiti argumente s podpičjem, namesto z vejico, da dobite enak rezultat kot zgoraj. | "1 234 567,89 €" |
| Text( Date(2016,1,31), "dddd mmmm d" ) | Vrne dan v tednu, mesec in dan v mesecu v jeziku trenutnega uporabnika. Ker nobena od označb mest ni odvisna od jezika, jezikovna oznaka za besedilo ni potrebna. | "Nedelja, 31. januar" |
| Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) | Vrne dan v tednu, mesec in dan v mesecu v jeziku »es-ES«. | "domingo enero 31" |
Pretvarjanje vrednosti v besedilo
| Formula | Opis | Rezultat |
|---|---|---|
| Text( 1234567.89 ) | Pretvori število v niz. Ni ločil za tisočice ali nadzora nad številom mest pred ali za decimalnim ločilom; za boljši nadzor vnesite številske označbe mest kot drugi argument. | "1234567.89" |
| Text( DateTimeValue( "01/04/2003" ) ) | Pretvori vrednost datuma/časa v niz besedila. Če želite nadzirati pretvorbo, navedite člana oštevilčenja »DateTimeFormat« ali niz v obliki zapisa po meri. | "1/4/2003 12:00 AM" |
| Text( true ) | Pretvori logično vrednost v niz. | "true" |
| Text( GUID() ) | Pretvori ustvarjeno vrednost GUID v niz. | "f8b10550-0f12-4f08-9aa3-bb10958bc3ff" |
| Left( Text( GUID() ), 4 ) | Vrne prve štiri znake ustvarjene vrednosti GUID. | "2d9c" |