Jagamisviis:

Text funktsioon

Kehtib järgmise kohta: Lõuendirakendused Copilot Studio töölauavood Dataverse formula columns Mudelipõhised rakendused Power Platform CLI Dataverse functions Power Pages

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 ühte järgmistest argumentidest.

  • 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.

Samuti Text saab funktsioon teisendada mis tahes andmetüübi tekstiesituseks, kasutades vaikevormingut. 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)
Pikk kuupäev Neljakohaline aasta, kuu nimi, kuupäev ja nädalapäev. Selle kuu ja nädalapäeva nimesid ei saa lühendada. "Teisipäev, 7. aprill 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. "Teisipäev, Aprill 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. "Teisipäev, 7. aprill 2020 20:26:59"
Kauaaegne Tund (12-tunnine kell), minutid, sekundid ja AM/PM nimetus. "08:26:59 PL"
LongTime24 Tund (24-tunnine kell), minutid, sekundid. "20:26:59"
Lühike kuupäev 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. "7.04.2020 08:26"
ShortDateTime24 Neljakohaline aasta koos numbriga kuu ja kuupäevga, pluss tund (24-tunnine kell) ja minutid . "4/7/2020 20:26"
Lühike aeg Tund (12-tunnine kell), minutid ja AM/PM nimetus. "8:26 PL"
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 (null) 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). Siiski ei tagastata lisanulle, Text kui arvul on komakohtadest kummalgi pool vähem numbreid kui vormingus on #-märke. 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.
, (koma) Kuvab rühmitamise eraldaja arvus, mida kasutatakse sageli tuhandetes. Text 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.

Kohatäide peab ilmuma vahetult pärast koodi h või hh või vahetult enne ss-koodi ; Text muul juhul tagastab kuu minutite asemel.
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. Text Muul juhul tagastatakse 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. Text tagastab "AM" või "a" keskööst keskpäevani ja "PL" või "p" keskööst keskööni.

Sõnasõnalised kohatäited

Saate kõik need tärgid oma vormingustringi lisada. Need kuvatakse nii Text nagu on. 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 teadlik. 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: Kuidas tuleks tegijate jaoks 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.
  • Tulemuse keel: Millises keeles peaks funktsiooni tulem kasutajate jaoks ilmuma? Kuude ja tööpäevade nimed peavad olema rakenduse kasutaja jaoks 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 Text( 1234, "", ) valemiribale või parempoolse paani vahekaardile Täpsemalt ja seejärel kerige läbi kolmanda argumendi jaoks soovitatud lokaatide loend.

Keele kohatäide

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

Kohatäide Kirjeldus
[$-LanguageTag] LanguageTag on keelemärgend, mis tagastatakse funktsioonist Language . 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.

[$-en-US] eeldatakse, kui seda kohatäidet pole rakenduse käitamise ajal olemas.

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

Tulem Text sisaldab kuude, tööpäevade ja AM/PM tähistuste tõlgitud stringe, samuti sobivaid rühma- ja kümnendkohtade eraldajaid.

Vaikimisi Text kasutab rakendust käitava kasutaja keelt. Funktsioon Language annab vastuseks praeguse kasutaja keelesildi. Selle vaikeväärtuse saate alistada, sisestades kolmanda argumendi keelesildi aadressile 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 ] )

  • Nõutav arv . 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.

Text ( Dünaamiline )

  • Dünaamiline – nõutav. Dünaamiline väärtus, mis tähistab stringi. Aktsepteeritavad väärtused sõltuvad tüüpimata pakkujast. Kui JSON-i puhul on dünaamiline väärtus arv või loogikaväärtus, 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
Text( 1234.59, "####.#" ) Vormindab arvu ühe kümnendkoha täpsusega. "1234.6"
Text( 8.9, "#.000" ) Paneb numbri komaosa vajaduse korral koos nullidega lõpus. "8.900"
Text( 0.631, "0.#" ) Paneb kogu numbri osa vajaduse korral koos nullidega alguses. "0.6"
Text( 12, "#.0#" )
Text( 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"
Text( 12000, "$ #,###" )
Text( 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. "Esmaspäev, November 23, 2015"
Text( Now(), DateTimeFormat.LongDateTime ) Vormindab pika kuupäeva ja kellaaja stringina praeguse kasutaja keeles ja lokaadis, kasutades 12-tunnist kella. "Esmaspäev, 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 – ühe- või kahekohaline kuu päev
  • - tulemusele kopeeritud sõnasõnalise märgina
  • mmm kuu kolmetähelise lühendi jaoks
  • - teise grammatilise märgina, mis kopeeritakse tulemusele
  • yy aasta kahekohalise lühendi puhul
 "23-Nov-15"
Text(1448318857*1000, "mmm. 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. "23. nov 2015 (02:47:37 PL)"

Globaalsed rakendused

Valem Kirjeldus Tulem
Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") Kuvab tühiku rühmitamise eraldajana, koma kümnendkoha eraldajana ja € valuutatähisena. "1 234 567,89 €"
Text(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
Text( 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"
Text( DateTimeValue( "01.04.2003" ) Teisendab kuupäeva/kellaaja väärtuse tekstistringiks. Teisenduse kontrollimiseks andke loendi DateTimeFormat või kohandatud vormingus stringi liige. "4.01.2003 12:00"
Text( tõene ) Teisendab loogilise väärtuse stringiks. "true"
Text( GUID() ) Teisendab loodud GUID väärtuse stringiks. "f8b10550-0f12-4f08-9aa3-bb10958bc3ff"
Left( Text( GUID() ), 4 ) Annab vastuseks loodud GUID neli esimest tärki. "2d9c"
  • Last updated on