Teksto funkcija
Taikoma:
Drobės programos Drobės programos Dataverse formulių stulpeliai Modeliu pagrįstos programos Power Pages Power Platform CLI
Konvertuoja bet kokią vertę ir formatuoja skaičių arba datos/laiko vertę į teksto eilutę.
Aprašas
Textfunkcija formatuoja skaičių arba datos/laiko vertę pagal vieną iš šių argumentų tipų:
- Iš anksto nustatytas datos/laiko formatas, kurį nurodote naudodami DateTimeFormat išvardijimą. Datų ir laiko požiūriu šiam požiūriui teikiama pirmenybė, nes jis automatiškai prisitaiko pagal kiekvienam vartotojo kalbą ir regioną.
- Pasirinktinis formatas, kurį sudaro apibrėžiančių vietos rezervavimo ženklų eilutė, pavyzdžiui, ar skaičiai rodo dešimtainį skyriklį, o datos rodo visą mėnesio pavadinimą, mėnesį kaip santrumpą arba mėnesį kaip skaičių. „Power Apps” palaiko vietos rezervavimo ženklų poaibį , kaip ir „Microsoft Excel”. Šioje eilutėje kalbos rezervavimo ženklas nurodo kalbą, kuria galima interpretuoti kitus vietos rezervavimo ženklus. Jei pasirinktiniame formate yra laikotarpis, pvz., kalbos formato rezervavimo ženklas nurodo, ar laikotarpis yra dešimtainis skyriklis (ja-JP), ar tūkstančio skyriklis (es-ES).
Norėdami gauti daugiau informacijos, žr. Darbas su datomis ir laikais.
Textfunkcija taip pat gali konvertuoti bet kokį duomenų tipą į teksto vaizdavimą naudodami numatytąjį formatą. Naudokite šią funkciją norėdami perduoti neteksto reikšmes tekstinėms funkcijoms, pvz., Len, Rightir IsMatch.
Iš anksto nustatyti datų/laiko formatai
Šių pavyzdžių data ir laikas yra 2020 m. balandžio 7 d., antradienis, 20:26:59.180 val., laiko juostoje UTC-7 valandas.
| DateTimeFormat išvardijimas | Aprašas | Pavyzdžiai (naudojant en-US) |
|---|---|---|
| LongDate | Keturių skaitmenų metai, mėnesio pavadinimas, mėnesio diena ir savaitės diena. Mėnesio ir savaitės dienos pavadinimai netrumpinami. | „2020 m. balandžio 7 d., antradienis” |
| LongDateTime | Keturių skaitmenų metai, mėnesio pavadinimas, mėnesio diena ir savaitės diena, plius valanda (12 valandų laikrodis), minutės, sekundės ir iki pietų/po pietų laiko paskyrimas. Mėnesio ir savaitės dienos pavadinimai netrumpinami. | „2020 m. balandžio 7 d., antradienis, 20:26:59 val.” |
| LongDateTime24 | Keturių skaitmenų metai, mėnesio pavadinimas, mėnesio diena ir savaitės diena, plius valanda (24 valandų laikrodis), minutės, sekundės. Mėnesio ir savaitės dienos pavadinimai netrumpinami. | „2020 m. balandžio 7 d., antradienis, 20:26:59 val.” |
| LongTime | Valanda (12 valandų laikrodis), minučių, sekundžių ir iki pietų/po pietų žymėjimas. | „20:26:59 val.” |
| LongTime24 | Valanda (24 valandų laikrodis), minutės, sekundės. | „20:26:59” |
| ShortDate | Keturių skaitmenų metai su skaitiniu mėnesiu ir mėnesio diena. | „2020-04-07” |
| ShortDateTime | Keturių skaitmenų metai su skaitiniu mėnesiu ir mėnesio diena, plius valanda (12 valandų laikrodis), minutės ir iki pietų/po pietų laiko paskyrimas. | „2020-04-07 20:26 val.” |
| ShortDateTime24 | Keturių skaitmenų metai su skaitiniu mėnesiu ir mėnesio diena, plius valanda (24 valandų laikrodis) ir minutės. | „2020-04-07 20:26 val. “ |
| ShortTime | Valanda (12 valandų laikrodis), minutės ir iki pietų/po pietų paskyrimas. | „20:26 val.” |
| ShortTime24 | Valanda (24 valandų laikrodis) ir minutės. | „20:26“ |
| UTC | Datos/laiko vertė konvertuojama į UTC remiantis dabartine vartotojo laiko juosta ir formatuojama pagal ISO 8601 standartą. | "2020-04-08T 03:26:59.180Z" |
Vietos rezervavimo ženklų skaičius
| Vietos rezervavimo ženklas | Aprašas |
|---|---|
| 0 (zero) | Rodo nereikšmingus nulius, jei skaičius turi mažiau skaitmenų nei yra nulių formate. Pavyzdžiui, naudokite formatą #.00, jei norite rodyti 8,9 kaip 8,90. |
| # | Laikosi tokių pačių taisyklių kaip ir 0 (nulis). Tačiau Textnegrąžina papildomų nulių, kai skaičius turi mažiau skaitmenų bet kurioje dešimtainės dalies pusėje, nei yra simbolių # formate. Pavyzdžiui, 8.9 rodomas, jei pasirinktinis formatas yra #.##, o skaičius, kurį norite formatuoti, yra 8,9. |
| . (period) | Rodo dešimtainį skyriklį skaičiuje. Priklauso nuo pasirinktinio formato kalbos; daugiau informacijos rasite „Visuotinės programos”. |
| , (comma) | Rodo grupavimo skyriklį skaičiuje, dažnai naudojamą tūkstančiams. Textatskiria grupes kableliais, jei formate yra kablelis, apsuptas skaičiaus ženklais ( #) arba nuliais. Priklauso nuo pasirinktinio formato kalbos; daugiau informacijos rasite „Visuotinės programos”. |
Jei skaičius turi daugiau skaitmenų į dešinę nuo dešimtainio taško nei yra vietos rezervavimo ženklų formate, skaičius suapvalinamas iki tiek dešimtainių skilčių, kiek yra vietos rezervavimo ženklų. Jei yra daugiau skaitmenų į kairę nuo dešimtainio taško nei yra vietos rezervavimo ženklų, rodomi papildomi skaitmenys. Jei formate yra tik skaitmenų ženklai (#) į kairę nuo dešimtainio taško, skaičiai mažesni už 1 prasideda dešimtainiu tašku kableliu (pavyzdžiui, .47).
Datos ir laiko vietos rezervavimo ženklai.
| Vietos rezervavimo ženklas | Aprašas |
|---|---|
| m | Rodo mėnesį kaip skaičių be pirmutinio nulio. |
| mm | Rodo mėnesį kaip skaičių su pirmutiniu nuliu, kai reikia. |
| mmm | Rodo mėnesį kaip santrumpą ( Janiki Dec). |
| mmmm | Rodo mėnesį pilnu pavadinimu (nuo Januaryiki December). |
| d. | Rodo dieną kaip skaičių be pirmutinio nulio. |
| dd | Rodo dieną kaip skaičių su pirmutiniu nuliu, kai reikia. |
| ddd | Rodo dieną kaip santrumpą ( Suniki Sat). |
| dddd | Rodo dieną pilnu pavadinimu (nuo Sundayiki Saturday). |
| yy | Rodo metus kaip dviejų skaitmenų skaičių. |
| yyyy | Rodo metus kaip keturių skaitmenų skaičių. |
| h | Rodo valandą kaip skaičių be pirmutinio nulio. |
| hh | Rodo valandą kaip skaičių be pirmutinio nulio, kai reikia. Jei formate yra AM arba PM, valanda rodoma pagal 12 valandų laikrodį. Priešingu atveju valandos rodomos remiantis 24 valandų laikrodžiu. |
| m | Rodo minutę kaip skaičių be pirmutinio nulio. Šis vietos rezervavimo ženklas turi būti rodomas iškart po harba hh kodo arba prieš pat ss kodą; priešingu atveju Text grąžina mėnesį vietoj minučių. |
| mm | Rodo minutę kaip skaičių su pirmutiniu nuliu, kai reikia. Ši vietos rezervavimo ženklas turi būti rodomas iškart poh arba hhvietos rezervavimo ženklo arba iškart prieš ssvietos rezervavimo ženklą. Priešingu atveju Textgrąžina mėnesį vietoj minučių. |
| s | Rodo sekundę kaip skaičių be pirmutinio nulio. |
| ss | Rodo sekundę kaip skaičių su pirmutiniu nuliu, kai reikia. |
| f | Rodo sekundžių dalis. |
| AM/PM, a/p | Rodo valandą pagal 12 valandų laikrodį. Textgrąžina į „iki pietų” arba „a” laiku nuo vidurnakčio iki vidurdienio, o „po pietų” arba "p" laiku nuo vidurdienio iki vidurnakčio |
Pažodiniai vietos rezervavimo ženklai
Į formato eilutę galite įtraukti bet kurį iš šių simbolių. Jie bus rodomi Text rezultate tokie kokie yra. Papildomi simboliai rezervuojami būsimiems vietos rezervavimo ženklams, tad jų neturėtumėte naudoti.
| Ženklas | Aprašas |
|---|---|
| Bet kuris valiutos simbolis | Dolerio ženklas, centų ženklas, euro ženklas ir pan. |
| + | Pliuso ženklas |
| ( | Kairysis skliaustas |
| : | Dvitaškis |
| ^ | Stogelio ženklas (intarpas) |
| ' | Apostrofas |
| { | Kairysis išlenktas skliaustelis |
| < | Kairysis mažiau nei ženklas |
| = | Lygybės ženklas |
| - | Minuso ženklas |
| / | Pasvirasis brūkšnys |
| ) | Dešinysis skliaustas |
| & | Ampersendas |
| ~ | Riestinis kirtis |
| } | Dešinysis išlenktas skliaustelis |
| > | Daugiau nei ženklas |
| Tarpo simbolis |
Visuotinės programos
Text funkcija yra visuotinai pagrįsta. Daugelyje kalbų ji žino, kaip tinkamai užrašyti datas, laiką, valiutas ir skaičius. Norint atlikti savo darbą, reikia turėti du informacijos fragmentus:
- The language of the custom format: formuotojams, kaip reikia interpretuoti pasirinktinį formatą? Atskyrimo ženklai (. ir ,) turi skirtingas reikšmes įvairiose kalbose. Jei nurodysite pasirinktinį formatą, galite įtraukti kalbos vietos rezervavimo ženklą arba panaudoti numatytąją vertę, atspindinčią kalbą, kuri nustatyta jūsų įrenginyje. Dar paprasčiau, galite naudoti vieną iš anksto nustatytų datos/laiko formatų, kurie yra kalbiškai agnostiški.
- The language of the result:Vartotojams, kokia kalba turi būti rodoma funkcija? Mėnesių ir šiokiadienių pavadinimai turi būti pateikti atitinkama vartotojo kalba, kurią galite nurodyti įtraukdami trečią, pasirenkamą argumentą į Textfunkciją.
Abiem atvejais nurodote kalbą naudodami kalbos žymą. Norėdami peržiūrėti palaikomų kalbų sąrašą, įveskite Text( 1234, "", ) formulės juostoje arba Advancedskirtuke dešinėje ir slinkite per lokalių sąrašą, parekomenduotą trečiam argumentui.
Kalbos vietos rezervavimo ženklas
Norėdami nurodyti pasirinktinio formato kalbą, naudokite:
| Vietos rezervavimo ženklas | Aprašas |
|---|---|
| [$-LanguageTag] | LanguageTag yra kalbos žyma, grąžinta iš Language funkcijos. Jis gali nurodyti tik kalbą (pvz., [$-en]anglų k.) arba regioną (pvz., [$-en-GB], kad toliau būtų nurodyta Didžioji Britanija). |
Kalbos vietos rezervavimo ženklas gali būti bet kur pasirinktiniame formate, bet tik kartą.
Jei nurodote pasirinktinį formatą be kalbos vietos rezervavimo ženklo, o formatas yra dviprasmiškas visuotiniu požiūriu, jūsų dabartinės kalbos žyma bus įterpta automatiškai.
[$-lt-US]daroma prielaida, kad paleidus programą, šios vietos rezervavimo ženklas nerodomas.
Pastaba.
Būsimose versijose šio rezervavimo ženklo sintaksė gali pasikeisti, kad būtų painiojimo su panašiu, bet kitu „Excel” palaikomu vietos rezervavimo ženklu.
Rezultato kalbos žyma
Text rezultate yra mėnesių, darbo dienų ir iki pietų/po pietų paskyrimų, o taip pat atitinkamų grupių ir dešimtainių skyrikliai.
Pagal numatytuosius nustatymus Textnaudoja vartotojo, leidžiančio programą, kalbą. Language funkcija pateikia dabartinio vartotojo kalbos žymą. Galite perrašyti šią numatytąją reikšmę pateikdami kalbos žymą trečiam argumentui pagal Text.
Sintaksė
Text ( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )
- NumberOrDateTime - Būtinas. Skaičius arba datos/laiko vertės pagal formatą.
- DateTimeFormat - Būtinas. DateTimeFormat išvardijimo narys.
- ResultLanguageTag - Pasirinktinas. Kalbos žyma, kurią naudosite rezultato tekstui. Pagal numatytuosius nustatymus, naudojama dabartinio vartotojo kalba.
Text ( NumberOrDateTime, CustomFormat [, ResultLanguageTag] )
- Number - Būtinas. Skaičius arba datos/laiko vertės pagal formatą.
- CustomFormat - Būtinas. Vienas ar daugiau vietos rezervavimo ženklų, esančių dvigubose kabutėse.
- ResultLanguageTag - Pasirinktinas. Kalbos žyma, kurią naudosite rezultato tekstui. Pagal numatytuosius nustatymus, naudojama dabartinio vartotojo kalba.
Text ( AnyValue)
- AnyValue - Būtinas. Vertė, kurią reikia konvertuoti į tekstinį pristatymą. Naudojamas numatytasis formatas.
Tekstas ( netipinis )
- Untyped – būtina. Netipinis objektas nurodantis eilutę. Reikšmių neįrašymo reikšmės priklauso nuo paslaugų teikėjų, kurių rašymo tipas neįraštas. JSON , jei neapibrėžto tipo objektas yra skaičius arba Bulio logikos, jis bus konvertuotas į tekstą.
Pavyzdžiai
Jei nenurodyta kitaip, šias formules valdantis vartotojas yra Jungtinėse Valstijose ir pasirinko anglų kaip savo kalbą. Language funkcija grąžina „en-US”.
Numeris
| Formulė | Aprašas | Rezultatas |
|---|---|---|
| Tekstas( 1234.59, "####.#" ) | Formatuoja skaičių pagal vieną dešimtainę vietą. | „1234.6” |
| Tekstas( 8.9, "#.000" ) | Jei reikia, išplečia dešimtainę skaičiaus dalį su galiniais nuliais. | „8,900” |
| Tekstas( 0.631, "0.#" ) | Jei reikia, papildo visą skaičiaus dalį nuliais priekyje. | „0,6” |
|
Tekstas( 12, "#.0#" ) Tekstas( 1234.568, "#.0#" ) |
Jei yra, papildo skaičiaus dešimtainę dalį nuliais vienai dešimtainei vietai ir įtraukia antrą dešimtainę vietą. | „12,0” „1234,57” |
|
Tekstas( 12000, "$ #,###" ) Tekstas( 1200000, "$ #,###" ) |
Įdeda tūkstančių skyriklį kas tris skaitmenis ir įtraukia valiutos simbolį. | "$ 12,000" "$ 1,200,000" |
Data / laikas
- 14:37:47 val. laiku 2015 m. lapkričio 23 d., pirmadienis
- Jungtinių Amerikos Valstijų Ramiojo vandenyno laiko juosta (UTC-8)
| Formulė | Aprašas | Rezultatas |
|---|---|---|
| Text( Now(), DateTimeFormat.LongDate ) | Formatuoja ilgą datos eilutę dabartinio vartotojo kalba ir lokalėje. | „2015 m. lapkričio 23 d., pirmadienis” |
| Text( Now(), DateTimeFormat.LongDateTime ) | Formatuoja datą pilnu formatu ir laiko eilutę dabartinio vartotojo kalba ir lokalėje naudojant 12 valandų laikrodį. | „2015 m. lapkričio 23 d., pirmadienis. 14:37:47 val.” |
| Text( Now(), DateTimeFormat.LongTime24 ) | Formatuoja kaip laiko pilnu formatu eilutę, naudojant 24 valandų laikrodį. | „14:37:47” |
| Text( Now(), DateTimeFormat.ShortDate ) | Formatuoja kaip datą trumpuoju formatu eilutę dabartinio vartotojo kalba ir lokalėje. | „2015-11-23” |
| Text( Now(), "d-mmm-yy" ) | Formatuoja naudojant vietos rezervavimo ženklo simbolius:
|
„2015-lapkr-23” |
| Tekstas(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") | Rodo „Unix” datos-laiko vertę žmogui nuskaitomu formatu, jei šaltinio vertę padauginate iš 1 000. | "2015 m. lapkr. 23 d. (14:47:37 val.) " |
Visuotinės programos
| Formulė | Aprašą | Rezultatas |
|---|---|---|
| Tekstas(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") | Rodo tarpą kaip grupavimo skyriklį, kablelį kaip dešimtainį skyriklį ir € kaip valiutos simbolį. | "1 234 567,89 €" |
| Tekstas(1234567,89; "[$-fr-FR]# ###,## €") | Jei šaltinio duomenys atitinka prancūzų įprotį naudoti kablelį kaip dešimtainį skyriklį, savo lokalę turite pakeisti į prancūzišką ir atskirti argumentus kabliataškiu, o ne kableliu, kad gautumėte tą patį rezultatą kaip nurodyta aukščiau. | "1 234 567,89 €" |
| Text( Date(2016,1,31), "dddd mmmm d" ) | Grąžina savaitės dieną, mėnesį ir mėnesio dieną dabartinio vartotojo kalba. Kadangi nė vienas vietos rezervavimo ženklas nepriklauso nuo kalbos, nereikia naudoti formato teksto kalbos žymos. | "Sekmadienis Sausio 31" |
| Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) | Grąžina savaitės dieną, mėnesį ir mėnesio dieną „es-ES” kalba. | "domingo enero 31" |
Verčių konvertavimas į tekstą
| Formulė | Aprašas | Rezultatas |
|---|---|---|
| Tekstas( 1234567.89 ) | Konvertuoja skaičių į eilutę. Nėra tūkstančių skyriklių arba skaitmenų skaičiaus kontrolės prieš dešimtainį skyriklį arba po jo; jei reikia daugiau kontrolės, kaip antrąjį argumentą patiekite skaičių vietos rezervavimo ženklus. | „1234567,89” |
| Tekstas( DateTimeValue( "01/04/2003" ) ) | Konvertuoja datos/laiko vertę į teksto eilutę. Norėdami kontroliuoti konvertavimą, nurodykite arba „DatosLaikoFormatas” išvardijima arba pasirinktinio formato eilutės narį. | „2003-01-04 12:00 val.” |
| Tekstas( teisinga ) | Konvertuoja Bulio logikos vertę į eilutę. | „true” |
| Tekstas( GUID() ) | Konvertuoja sugeneruotą GUID vertę į eilutę. | „f8b10550-0f12-4f08-9aa3-bb10958bc3ff” |
| Kairėje( Tekstas( GUID() ), 4 ) | Grąžina pirmuosius keturis sugeneruoto GUID simbolius. | „2d9c” |