Jagamisviis:

Funktsioon Tekst

  • Artikkel

Kehtib: Lõuendirakendused Lõuendirakenduste Dataverse valemiveerud Mudelipõhised rakendused Power Platform CLI

Teisendab mistahes väärtuse ja vormindab tekstistringi arvu või kuupäeva/kellaaja väärtuse.

Kirjeldus

Funktsioon Text vormindab arvu või kuupäeva/kellaaja väärtuse, tuginedes ühele järgmistest argumentide tüüpidest.

  • Eelmääratud kuupäeva/kellaaja vorming, mille saate täpsustada loendiga DateTimeFormat. Kuupäevade ja kellaaegade puhul eelistatakse seda lähenemist, kuna see kohandub automaatselt iga kasutaja keele ja piirkonnaga.
  • Kohandatud vorming, mis koosneb kohatäidetest, mis määratleb näiteks selle, kas numbrid näitavad kümnendkohtade eraldajat ja kuupäevad näitavad kuu täisnumbrit, kuu lühendina või kuu numbrina. Power Apps toetab kohatäidete alamhulka, mida teeb Microsoft Excel. Selles stringis täpsustab keele kohatäide keele, milles teisi kohatäiteid tõlgendatakse. Kui kohandatud vorming sisaldab punkti (nt keelevormingu kohatäide), siis täpsustatakse, kas punkt on kümnendkoha eraldaja (ja-JP) või tuhandeliste eraldaja (es-ES).

Vt lisateavet kuupäevade ja kellaaegadega töötamise kohta.

Funktsioon Text saab vaikevormingu abil ka mis tahes andmetüübi tekstiesitluseks teisendada. Kasutage seda tekstiväliste väärtuste edastamiseks tekstipõhistele funktsioonidele, nagu Len, Right ja IsMatch.

Eelmääratletud kuupäeva/kellaaja vormingud

Nende näidete puhul on kasutatud kuupäev ja kellaaeg teisipäeva, 7. aprill 2020 8:26:59.180 PM, ajavööndis UTC-7 tundi.

Loetelu DateTimeFormat Kirjeldus Näited (kasutades väärtust en-US)
LongDate Neljakohaline aasta, kuu nimi, kuupäev ja nädalapäev. Selle kuu ja nädalapäeva nimesid ei saa lühendada. "Tuesday, April 7, 2020"
LongDateTime Neljakohaline aasta, kuu nimi, kuupäev ja nädalapäev, pluss tund (12-tunnine kell), minutid, sekundid ja AM/PM nimetus. Selle kuu ja nädalapäeva nimesid ei saa lühendada. "Tuesday, April 7, 2020 8:26:59 PM"
LongDateTime24 Neljakohaline aasta, kuu, kuupäev ja nädalapäev, pluss tund (24-tunnine kell), minutid, sekundid. Selle kuu ja nädalapäeva nimesid ei saa lühendada. "Tuesday, April 7, 2020 20:26:59"
LongTime Tund (12-tunnine kell), minutid, sekundid ja AM/PM nimetus. "8:26:59 PM"
LongTime24 Tund (24-tunnine kell), minutid, sekundid. "20:26:59"
ShortDate Neljakohaline aasta koos numbrina kuu ja päevaga. "4/7/2020"
ShortDateTime Neljakohaline aasta koos numbriga kuu ja kuupäevga, pluss tund (12-tunnine kell), minutid ja AM/PM nimetus. "4/7/2020 8:26 PM"
ShortDateTime24 Neljakohaline aasta koos numbriga kuu ja kuupäevga, pluss tund (24-tunnine kell) ja minutid . "4/7/2020 20:26"
ShortTime Tund (12-tunnine kell), minutid ja AM/PM nimetus. "8:26 PM"
ShortTime24 Tund (24-tunnine kell) ja minutid. "20:26"
UTC Kuupäeva/kellaaja väärtus teisendatakse UTC-ks vastavalt praeguse kasutaja ajavööndile ja vormindatakse vastavalt standardile ISO 8601. "2020-04-08T03:26:59.180Z"

Numbriline kohatäide

Kohatäide Kirjeldus
0 (zero) Kuvatakse ebaolulised nullid, kui numbril on vähem numbreid kui vormingus on nulle. Kasutage näiteks vormingut #.00, kui soovite kuvada väärtuse 8.9 kujul 8.90.
# Järgib samu reegleid kui 0 (null). Kuid funktsioon Text ei anna vastuseks liigseid nulle, kui arvul on vähem kohti kümnendkoha kummalgi pool kui vormingus on sümboleid #. Näiteks kuvatakse väärtus 8.9 juhul, kui kohandatud vorming on #.## ja vormingu number on 8.9.
. (period) Kuvab arvu komakoha. Sõltub kohandatud vormingu keelest. Lisateavet leiate teemast Globaalsed rakendused.
, (comma) Kuvab rühmitamise eraldaja arvus, mida kasutatakse sageli tuhandetes. Funktsioon Tekst eraldab rühmad komadega, kui vorming sisaldab koma, mis on ümbritsetud numbrimärkidega (#) või nullidega. Sõltub kohandatud vormingu keelest. Lisateavet leiate teemast Globaalsed rakendused.

Kui numbril on komakohast paremal rohkem numbreid kui vormingus kohatäiteid on, ümardatakse number nii palju komakohta, kui kohatäiteid on. Kui kümnendkohast vasakul on rohkem numbreid kui kohatäiteid, kuvatakse lisanumbrid. Kui vorming sisaldab kümnendkohast vasakul ainult märke (#), algavad numbritele, mis on väiksemad kui 1, kümnendkohaga (näiteks .47).

Kuupäeva ja kellaaja kohatäited.

Kohatäide Kirjeldus
m Kuvab kuu numbrina ilma eesmise nullita.
mm Kuvab kuu numbrina koos eesmise nulliga, kui on kohaldatav.
mmm Kuvab kuu lühendina (Jan to Dec).
mmmm Kuvab kuu täisnimega (January to December).
d Kuvab päeva numbrina ilma eesmise nullita.
dd Kuvab päeva numbrina koos eesmise nulliga, kui on kohaldatav.
ddd Kuvab päeva lühendina (Sun to Sat).
dddd Kuvab päeva täisnimega (Sunday to Saturday).
yy Kuvab aasta kahekohalise arvuna.
yyyy Kuvab aasta neljakohalise arvuna.
h Kuvab tunni numbrina ilma eesmise nullita.
hh Kuvab tunni numbrina koos eesmise nulliga, kui on kohaldatav. Kui vorming sisaldab vormingut AM või PM, kuvatakse tund 12-tunnise kella põhjal. Vastasel juhul kuvatakse tund 24-tunnise kella põhjal.
m Kuvab minuti numbrina ilma eesmise nullita.

See kohatäide peab ilmuma kohe pärast koodi h või hh või vahetult enne koosi ss. Vastasel juhul annab funktsioon Text vastuseks minutite asemel kuu.
mm Kuvab minuti numbrina koos eesmise nulliga, kui on kohaldatav.

See kohatäide peab ilmuma kohe pärast kohatäidet h või hh või vahetult enne kohatäidet ss. Vastasel juhuk annab funktsioon Text vastuseks minutite asemel kuu.
s Kuvab sekundi numbrina ilma eesmise nullita.
ss Kuvab sekundi numbrina koos eesmise nulliga, kui on kohaldatav.
f Kuvab sekundi murdosa.
AM/PM, a/p Kuvab 12-tunnise kella põhjal tunni. Funktsioon Tekst annab kesktööst keskpäevani vastuseks „AM” või „a” ja keskpäevast keskööni „PM” või „p”.

Sõnasõnalised kohatäited

Saate kõik need tärgid oma vormingustringi lisada. Need kuvatakse funktsiooni Text vastusena. Täiendavad tärgid on reserveeritud tulevastele kohatäidetele, seega ei tohiks neid kasutada.

Tärk Kirjeldus
Mis tahes valuutatähis Dollari märk, sentide märk, euro märk jne.
+ Plussmärk
( Vasak sulg
: Koolon
^ Circumflex aktsent (katus)
' Ülakoma
{ Vasak looksulg
< Väiksem kui märk
= Võrdusmärk
- Miinusmärk
/ Kaldkriips
) Parem sulg
& Ampersand
~ Tilde
} Parem looksulg
> Suurem kui märk
  Tühik

Globaalsed rakendused

Funktsioon Text on globaalselt arusaadav. See teab, kuidas paljudes keeltes kuupäevi, kellaaegu, valuutasid ja numbreid õigesti välja kirjutada. Oma töö tegemiseks on sel vaja kahte teavet.

  • Kohandatud vormingu keel: kujundajatele, kuidas tuleks kohandatud vormingut tõlgendada? Eraldusmärkidel (. ja ,) on erinevates keeltes erinev tähendus. Kui määrate kohandatud vormingu, saate kaasata keele kohatäite või võtta vaikeväärtuse, mis vastab teie seadme jaoks määratud keelele. Veelgi lihtsam, saate kasutada ühte eelmääratletud kuupäeva/kellaaja vormingut, mis on keelest sõltumatu.
  • Vastuse keel: kasutajatele, millises keeles peaks funktsiooni vastus ilmuma? Kuude ja nädalapäevade nimed peavad olema rakenduse kasutajale sobivas keeles, mille saate määrata, lisades funktsioonile Text kolmanda, valikulise argumendi.

Nii saate keelt määrata ka keelesilti kasutades. Toetatud keelte loendi kuvamiseks tippige valemiribale või parempoolsel paanil vahekaardile Advanced väärtus Text( 1234, "", ) ja kerige läbi lokaatide nimekiri, mida on soovitatud kolmandale argumendile.

Keele kohatäide

Kohandatud vormingu keele määramiseks kasutage järgmist.

Kohatäide Kirjeldus
[$-LanguageTag] LanguageTag on keelesilt, mis on vastuseks funktsioonist Keel. See võib määrata ainult keele (nt [$-en] inglise keele jaoks) või määrata piirkonna (nt [$-en-GB], et tähistada Suurbritanniat).

Keele kohatäite võib ilmuda kõikjal kohandatud vormingus, kuid ainult üks kord.

Kui määrate kohandatud vormingu ilma keele kohatäiteta ja vorming on globaalsest vaatepunktist ebaselge, lisatakse teie praeguse keele silt automaatselt.

Eeldatakse väärtust [$-en-US], kui seda kohatäidet ei kuvata rakenduse käitamisel.

Märkus.

Tulevases versioonis võib selle kohatäite süntaks muutuda, et vältida segadust sarnase, kuid teistsuguse kohatäitega, mida Excel toetab.

Vastuse keelesilt

Funktsiooni Text vastus sisaldab kuude, nädalapäevade ja AM/PM nimetuste tõlgitud stringe ning sobiva rühma ja kümnendkoha eraldajaid.

Vaikimisi kasutab funktsioon Text rakendust käitava kasutaja keelt. Funktsioon Language annab vastuseks praeguse kasutaja keelesildi. Saate alistada selle vaikeväärtuse, tarnides tekstile kolmanda argumendi jaoks keelesildi funktsioonile Text.

Süntaks

Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )

  • NumberOrDateTime - Nõutav. Vormindatav arv või kuupäeva/kellaaja väärtus.
  • DateTimeFormat - Nõutav. Loendi DateTimeFormat liige.
  • ResultLanguageTag - Valikuline. Vastuse teksti jaoks kasutatav keelesilt. Vaikimisi kasutatakse praeguse kasutaja keelt.

Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )

  • Arv - Nõutav. Vormindatav arv või kuupäeva/kellaaja väärtus.
  • CustomFormat - Nõutav. Üks või mitu jutumärkides kohatäidet.
  • ResultLanguageTag - Valikuline. Vastuse teksti jaoks kasutatav keelesilt. Vaikimisi kasutatakse praeguse kasutaja keelt.

Text( AnyValue )

  • AnyValue - Nõutav. Väärtus, mis teisendatakse tekstiesitluseks. Kasutatakse vaikevormingut.

Tekst ( Tüüpimata )

  • Tüüpimata – nõutav. Tüüpimata objekt, mis esindab stringi. Aktsepteeritavad väärtused sõltuvad tüüpimata pakkujast. JSON-i puhul, kui tippimata objekt on number või kahendobjekt, teisendatakse see tekstiks.

Näited

Neid valemeid käitav kasutaja asub USA-s ja on valinud keeleks inglise keele, kui pole teisiti märgitud. Funktsioon Language tagastatakse kui "en-US".

Number

Valem Kirjeldus Tulem
Tekst( 1234,59, „####.#” ) Vormindab arvu ühe kümnendkoha täpsusega. "1234.6"
Tekst( 8,9, „#.000” ) Paneb numbri komaosa vajaduse korral koos nullidega lõpus. "8.900"
Tekst( 0,631, „0.#” ) Paneb kogu numbri osa vajaduse korral koos nullidega alguses. "0.6"
Tekst( 12, „#.0#” )
Tekst( 1234,568, „#.0#” )		 Paneb numbri kümnendkoha täisarvuna ühe kümnendkoha täpsusega ja sisaldab teist kümnendkohta, kui see on saadaval. "12.0"
"1234.57"
Tekst( 12000, „$ #,###” )
Tekst( 1200000, „$ #,###” )		 Paneb tuhandeliste eraldaja iga kolme numbri järele ja sisaldab valuutatähist. „$ 12,000”
„$ 1,200,000”

Kuupäev/kellaaeg

  • Kell 2:37:47 PM ajal Monday, November 23, 2015
  • Ameerika Ühendriikide Vaikse ookeani ajavöönd (UTC-8)
Valem Kirjeldus Tulem
Text( Now(), DateTimeFormat.LongDate ) Vormindab pika kuupäeva stringina praeguse kasutaja keeles ja lokaadis. "Monday, November 23, 2015"
Text( Now(), DateTimeFormat.LongDateTime ) Vormindab pika kuupäeva ja kellaaja stringina praeguse kasutaja keeles ja lokaadis, kasutades 12-tunnist kella. "Monday, November 23, 2015 2:37:47 PM"
Text( Now(), DateTimeFormat.LongTime24 ) Vormindab pika aja stringina, kasutades 24-tunnist kella. "14:37:47"
Text( Now(), DateTimeFormat.ShortDate ) Vormindab lühikese kuupäeva stringina praeguse kasutaja keeles ja lokaadis. "11/23/2015"
Text( Now(), "d-mmm-yy" ) Kohatäitemärke kasutavad vormingud:
  • d on ühekohaline või kahekohaline kuupäev
  • - on sõnasõnaline tärk, mis on kopeeritud vastusele
  • mmm on kuu kolmetäheline lühend
  • - on veel üks sõnasõnaline tärk, mis on kopeeritud vastusele
  • yy on aasta kahekohaline lühend
 "23-Nov-15"
Tekst(1448318857*1000, „kkk. pp, aaaa (tt:mm:ss AM/PM)") Näitab, et UNIX-i kuupäeva/kellaaja väärtus on inimlikult loetavas vormingus, kui te korrutate allika väärtusega numbriga 1000. "Nov. 23, 2015 (02:47:37 PM)"

Globaalsed rakendused

Valem Kirjeldus Tulemus
Tekst(1234567,89, „[$-fr-FR]# ###,## ”, „fr-FR”) Kuvab tühiku rühmitamise eraldajana, koma kümnendkoha eraldajana ja € valuutatähisena. „1 234 567,89 €”
Tekst(1234567,89; „[$-fr-FR]# ###,## €”) Kui lähteandmed järgivad prantsuse kombeid kasutada komaeraldusena koma, peate ülaltoodud tulemuse saamiseks muutma lokaadi prantsuse keeleks ja eraldama argumendid koma asemel semikooloniga. „1 234 567,89 €”
Text( Date(2016,1,31), "dddd mmmm d" ) Annab vastuseks nädalapäeva, kuu ja kuupäeva praeguse kasutaja keeles. Kuna ükski kohatäidetest ei sõltu keelest, ei pea te vormindama teksti keelesilti. „Pühapäev, 31. jaanuar”
Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) Annab vastuseks nädalapäeva, kuu ja kuupäeva keeles "es-ES". „Pühapäev, 31. jaanuar”

Väärtuste teisendamine tekstiks

Valem Kirjeldus Tulem
Tekst( 1234567.89 ) Teisendab arvu stringiks. Tuhandeliste eraldajaid ega kontrollida numbrite arvu üle pole enne ega pärast kümnendkoha eraldajat; suurema kontrolli saamiseks lisage arvu kohatäited teise argumendina. "1234567.89"
Tekst( DateTimeValue( „01/04/2003” ) ) Teisendab kuupäeva/kellaaja väärtuse tekstistringiks. Teisenduse kontrollimiseks andke loendi DateTimeFormat või kohandatud vormingus stringi liige. "1/4/2003 12:00 AM"
Tekst( tõsi ) Teisendab loogilise väärtuse stringiks. "true"
Tekst( GUID() ) Teisendab loodud GUID väärtuse stringiks. "f8b10550-0f12-4f08-9aa3-bb10958bc3ff"
Vasak( Tekst( GUID() ), 4 ) Annab vastuseks loodud GUID neli esimest tärki. "2d9c"