Szöveg függvény
A következőkre vonatkozik:
Vászonalapú alkalmazások Vászonalapú alkalmazások képletoszlopai Modellvezérelt alkalmazások Dataverse Power Platform CLI
Bármilyen értéket konvertál, és egy szám- vagy dátum-/időértéket szöveges sztringgé formáz.
Ismertetés
A Text függvény egy számot vagy egy dátum- és időértéket formáz az alábbi argumentumtípusok egyike alapján:
- Előre definiált dátum-/időformátum, amely a DateTimeFormat típusú enumerálással adható meg. Ez a módszer javasolt a dátumok és az időpontok esetében, mivel az argumentumtípus automatikusan igazodik az egyes felhasználók nyelvéhez és régiójához.
- Egyéni formátum, amely egy olyan helyőrzőből álló karakterláncot tartalmaz, amely például azt határozza meg, hogy a számok tizedesjel-e, és a dátumok a hónap teljes nevét, a hónapot rövidítésként vagy a hónapot számként jelenítik meg. A Power Apps a helyőrzők egy részhalmazát támogatja az Microsoft Excel tekintetében. Ebben a karakterláncban a nyelvi helyőrző a többi helyőrző értelmezésének nyelvét határozza meg. Ha az egyéni formátum egy időszakot tartalmaz, a nyelv-formázás helyőrző például azt adja meg, hogy a vessző tizedesjegy elválasztó (ja-JP) vagy ezres elválasztó-e (es-ES).
További információk a dátumok és időpontok használatáról.
A Text függvény az adattípusokat az alapértelmezett formátum használatával átalakíthatja szöveges ábrázolásra is. Ezzel a nem szöveges értékeket lehet átadni a szövegen alapuló függvényeknek, például Len, Right és IsMatch.
Előre definiált dátum-/időformátumok
Ezeknél a példáknál a dátum és idő 2020. április 7., kedd, 2020 8:26:59.180 du., az UTC -7 időzónában.
| DateTimeFormat enum | Ismertetés | Példák (az en-US használatával) |
|---|---|---|
| LongDate | Év négy karakterrel, hónap neve, a hónap napja és a hét napja. A hónap nevét és a hét napját a rendszer nem rövidíti. | "Kedd, 2020. április 7." |
| LongDateTime | Év négy karakterrel, hónap neve, a hónap napja, a hét napja, óra (12 órás formátum), perc, másodperc, valamint de./du. megjelölés. A hónap nevét és a hét napját a rendszer nem rövidíti. | "Kedd, 2020. április 7. 8:26:59 du." |
| LongDateTime24 | Év négy karakterrel, hónap, a hónap napja, a hét napja, óra (24 órás formátum), perc és másodperc. A hónap nevét és a hét napját a rendszer nem rövidíti. | "Kedd, 2020. április 7. 20:26:59" |
| LongTime | Óra (12 órás formátum), perc, másodperc és de./du. megjelölés. | "8:26:59 du." |
| LongTime24 | Óra (24 órás formátum), perc, másodperc. | "20:26:59" |
| ShortDate | Négyjegyű év számjeggyel írt hónappal és a hónap napjával. | "4/7/2020" |
| ShortDateTime | Négyjegyű év számjegyes hónappal és a hónap napjával, óra (12 órás formátum), perc, másodperc, valamint de./du. megjelölés. | "4/7/2020 8:26 PM" |
| ShortDateTime24 | Négyjegyű év számjegyes hónappal és a hónap napjával, óra (24 órás formátum), perc és másodperc. | "4/7/2020 20:26" |
| ShortTime | Óra (12 órás formátum), perc és de./du. megjelölés. | "8:26 PM" |
| ShortTime24 | Óra (24 órás formátum) és perc. | "20:26" |
| UTC | Az aktuális felhasználó időzónája alapján a rendszer a dátum- és időértéket az UTC időzónára alakítja át, illetve az értékeket az ISO 8601 szabványnak megfelelően formázza. | "2020-04-08T03:26:59.180Z" |
Számok helyőrzői
| Helyőrző | Ismertetés |
|---|---|
| 0 (nulla) | Jelentés nélküli nullákat jelenít meg, ha a szám kevesebb számjegyet tartalmaz a formátumban lévő nullákhoz képest. Például használja a #.00 formátumot, ha 8,9 helyett a 8,90 értéket szeretné megjeleníteni. |
| # | A 0 (nulla) formátumra vonatkozó szabályokat követi. A Text függvény azonban nem jelenít meg további nullákat, ha a szám a tizedesjel bármelyik oldalán a formátumban lévő # szimbólumok számánál kevesebb számjegyet tartalmaz. Például 8,9 jelenik meg, ha az egyéni formátum #,## és a formázandó szám 8,9. |
| . (vessző) | A szám tizedesjelének megjelenítése. Az egyéni formátum nyelvétől függ – további információkat a globális alkalmazásokkal foglalkozó témakörben talál. |
| , (vessző) | A gyakran az ezresértékek elválasztására szolgáló csoportosítási elválasztót jeleníti meg egy számban. A Text függvény az egyes csoportokat vesszővel választja el, ha a formátum vesszőt tartalmaz, és azt számjelek (#) vagy nullák veszik körül. Az egyéni formátum nyelvétől függ – további információkat a globális alkalmazásokkal foglalkozó témakörben talál. |
Ha egy szám a formátumban található helyőrzők számánál több számjegyet tartalmaz a tizedesjeltől jobbra, akkor a rendszer a helyőrzők számának megfelelő számú tizedesjegyre kerekíti a számot. Ha a helyőrzők számánál több számjegy szerepel a tizedesjeltől balra, a rendszer megjeleníti a további számjegyeket. Ha a formátum a tizedesjeltől balra kizárólag kettős kereszteket (#) tartalmaz, akkor a megjelenített 1-nél kisebb számok tizedesjellel kezdődnek (például ,47).
Dátumok és időpontok helyőrzői
| Helyőrző | Ismertetés |
|---|---|
| m | Bevezető nullát nem tartalmazó számként jeleníti meg a hónapot. |
| mm | Adott esetben bevezető nullát tartalmazó számként jeleníti meg a hónapot. |
| mmm | Rövidítésként jeleníti meg a hónapot (jan. – dec.). |
| mmmm | Teljes névvel jeleníti meg a hónapot (január – december). |
| d | Bevezető nullát nem tartalmazó számként jeleníti meg a napot. |
| dd | Adott esetben bevezető nullát tartalmazó számként jeleníti meg a napot. |
| ddd | Rövidítéssel jeleníti meg a napot (H – V). |
| dddd | Teljes névvel jeleníti meg a napot (hétfő – vasárnap). |
| yy | Kétjegyű számmal jeleníti meg az évet. |
| yyyy | Négyjegyű számmal jeleníti meg az évet. |
| h | Bevezető nullát nem tartalmazó számként jeleníti meg az órát. |
| hh | Adott esetben bevezető nullát tartalmazó számként jeleníti meg az órát. Ha a formátum tartalmazza a AM vagy a PM megjelölést, a rendszer az órát 12 órás formátumban jeleníti meg. Ellenkező esetben az óra 24 órás formátumban jelenik meg. |
| m | Bevezető nullát nem tartalmazó számként jeleníti meg a percet. A helyőrzőnek közvetlenül a h vagy a hh kód után vagy közvetlenül az ss kód előtt kell szerepelnie, különben a Text függvény a perc helyett a hónap értékét adja eredményül. |
| mm | Adott esetben bevezető nullát tartalmazó számként jeleníti meg a percet. Ennek a helyőrzőnek közvetlenül a h vagy a hh helyőrző után vagy közvetlenül az ss helyőrző előtt kell szerepelnie. Ellenkező esetben a Text függvény a perc helyett a hónap értékét adja eredményül. |
| s | Bevezető nullát nem tartalmazó számként jeleníti meg a másodpercet. |
| ss | Adott esetben bevezető nullát tartalmazó számként jeleníti meg a másodpercet. |
| f | A másodpercek törtrészét jeleníti meg. |
| AM/PM, a/p | 12 órás formátumban jeleníti meg az órát. A Text függvény a „De.” vagy a „de” értékeket az éjfél és dél közötti időtartam, míg a „Du.” vagy a „du” értékeket a dél és éjfél közötti időtartam jelölésére használja |
Literálok helyőrzői
A formázó sztring az alábbi karakterek bármelyikét tartalmazhatja. Ezek megjelennek a Text függvény eredményében. A rendszer további karaktereket tart fenn jövőbeli helyőrzők számára, így azokat nem lehet használni.
| Karakter | Ismertetés |
|---|---|
| Bármely pénznem szimbóluma | Dollárjel, cent jele, euró jele, stb. |
| + | Pluszjel |
| ( | Bal oldali kerek zárójel |
| : | Kettőspont |
| ^ | Kalap jel |
| ' | Aposztróf |
| { | Bal oldali kapcsos zárójel |
| < | Kisebb jel |
| = | Egyenlőségjel |
| - | Mínuszjel |
| / | Perjel |
| ) | Jobb oldali kerek zárójel |
| & | És-jel |
| ~ | Tilde |
| } | Jobb oldali kapcsos zárójel |
| > | Nagyobb jel |
| Szóköz karakter |
Globális alkalmazások
A Text függvény globálisan környezetérzékeny. Számos különböző nyelven képes megfelelően megjeleníteni dátumokat, időpontokat, pénznemeket és számokat. Ehhez kétféle információra van szüksége:
- Az egyéni formátum nyelvére: az egyéni formátum értelmezési módja készítők számára. Az elválasztó karakterek (. és ,) különböző jelentéssel bírnak az egyes nyelveken. Ha egyéni formátumot ad meg, felvehet egy nyelvi helyőrzőt, vagy megadhatja az alapértelmezett értéket, amely azt a nyelvet tükrözi, amelyre a készüléket beállította. Még egyszerűbb, ha az egyik előre definiált dátum- és időformátumot használja, amelyek a nyelv agnosztikusak.
- Az eredmény nyelvére: A függvény eredménye a felhasználók számára milyen nyelven jelenjen meg? A hónapok és hétköznapok nevének az alkalmazás felhasználója számára megfelelő nyelven kell lennie, amelyet a Text függvényhez egy harmadik, nem kötelező argumentum hozzáadásával adhat meg.
Mindkettő esetén a nyelvet egy nyelvi címke segítségével adhatja meg. Megtekintheti a támogatott nyelvek listáját, ha beírja a Text( 1234, "", ) karakterláncot a szerkesztőlécen vagy a Speciális lapon a jobb oldali ablaktáblában, majd végiggörgeti a harmadik argumentum javasolt területi beállításainak listáját.
Nyelv helyőrzője
Az alábbiak használatával adhatja meg az egyéni formátum nyelvét:
| Helyőrző | Ismertetés |
|---|---|
| [$-LanguageTag] | A LanguageTag a Language függvény eredményeként kapott nyelvcímke. Tartalmazhatja egyszerűen a nyelvet (például [$-en] az angol nyelv esetében), vagy szerepelhet benne a régió is (például [$-en-GB] Nagy-Britannia pontosabb meghatározásához). |
A nyelvi helyőrző bárhol megjelenhet az egyéni formátumban, de csak egyszer.
Ha nyelvi helyőrző nélküli egyéni formátumot ad meg, és a formátum globális szempontból nem egyértelmű, a rendszer automatikusan beszúrja az aktuális nyelvhez tartozó nyelvi címkét.
A rendszer az [$-en-US] értéket használja alapértelmezettként, ha a helyőrző nincs jelen az alkalmazás futtatásakor.
Feljegyzés
A jövőbeli verziókban a helyőrző szintaxisa változhat, hogy ne lehessen összekeverni egy, az Excel által támogatott hasonló, de eltérő helyőrzővel.
Az eredmény nyelvcímkéje
A Text függvény eredményében a hónapok, a napok, a de. / du. megjelölés, illetve a megfelelő csoportosítási elválasztó és a tizedesjel lefordított sztringje jelenik meg.
Alapértelmezés szerint a Text függvény az alkalmazást futtató felhasználó nyelvét használja. A Language függvény az aktuális felhasználóhoz tartozó nyelvcímkét adja eredményül. Felülbírálhatja ezt az alapértelmezett értéket, ha megadja a nyelvcímkét a Text függvény harmadik argumentumában.
Szintaxis
Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )
- NumberOrDateTime – Kötelező. A formázandó szám vagy dátum- és időérték.
- DateTimeFormat – Kötelező. A DateTimeFormat enumerálás egy tagja.
- ResultLanguageTag – Nem kötelező. Az eredmény szövegéhez használandó nyelvcímke. Alapértelmezés szerint a rendszer az aktuális felhasználó nyelvét használja.
Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )
- Number – Kötelező. A formázandó szám vagy dátum- és időérték.
- CustomFormat – Kötelező. Egy vagy több helyőrző dupla idézőjelek között.
- ResultLanguageTag – Nem kötelező. Az eredmény szövegéhez használandó nyelvcímke. Alapértelmezés szerint a rendszer az aktuális felhasználó nyelvét használja.
Text( AnyValue )
- AnyValue – Kötelező. A szöveges ábrázolásra való konvertálásra szolgáló érték. Alapértelmezett formátum használatos.
Text ( Untyped )
- Untyped – Kötelező megadni. Típus nélküli objektum, amely egy sztringet jelöl. Az elfogadható értékek a típus nélküli szolgáltatótól függőek. JSON esetén, ha a nem típusos objektum szám vagy logikai érték, a rendszer szöveggé konvertálja.
Példák
Ha nincs másként megadva, az alábbi képleteket futtató felhasználó tartózkodási helye a Magyarország, és a felhasználó a magyar nyelvet használja saját nyelvként. A Language függvény a „hu-HU” értéket adja vissza.
Szám
| Képlet | Ismertetés | Eredmény |
|---|---|---|
| Text( 1234.59, "####.#" ) | Egy tizedesjeggyel formázza a számot. | "1234.6" |
| Text( 8.9, "#.000" ) | Szükség esetén záró nullákkal tölti fel a szám tizedesjegyeit. | "8.900" |
| Text( 0.631, "0.#" ) | Szükség esetén bevezető nullákkal tölti fel a szám egész részét. | "0.6" |
| Text( 12, "#.0#" ) Text( 1234.568, "#.0#" ) |
Nullával tölti fel a szám tört részének első tizedesjegyét, és feltüntet egy második tizedesjegyet, ha az meg van adva. | "12.0" "1234.57" |
| Text( 12000, "$ #,###" ) Text( 1200000, "$ #,###" ) |
Ezreselválasztót használ három számjegyenként, és feltünteti a pénznem szimbólumát. | "$ 12,000" "$ 1,200,000" |
Dátum/idő
- 2:37:47 du., 2015. november 23. hétfő
- Amerikai Egyesült Államok, csendes-óceáni időzóna (UTC-8)
| Képlet | Ismertetés | Eredmény |
|---|---|---|
| Text( Now(), DateTimeFormat.LongDate ) | A formázás hosszú dátum típusú sztringgel történik az aktuális felhasználó nyelve és területi beállítása szerint. | „2015. november 23. hétfő” |
| Text( Now(), DateTimeFormat.LongDateTime ) | A formázás hosszú dátum és időpont típusú sztringgel történik az aktuális felhasználó nyelve és területi beállítása szerint (12 órás formátumban). | „2015. november 23. hétfő, 2:37:47 du.” |
| Text( Now(), DateTimeFormat.LongTime24 ) | A formázás hosszú időpont típusú sztringgel történik (24 órás formátumban). | "14:37:47" |
| Text( Now(), DateTimeFormat.ShortDate ) | A formázás rövid dátum típusú sztringgel történik az aktuális felhasználó nyelve és területi beállítása szerint. | "11/23/2015" |
| Text( Now(), "d-mmm-yy" ) | A formázás helyőrző karakterekkel történik:
|
"23-Nov-15" |
| Text(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") | A UNIX-dátum-időértéket jeleníti meg az ember által olvasható formátumban, ha 1 000-ig szorozza meg a forrás értékét. | „2015. nov. 23. 02:47:37 du.” |
Globális alkalmazások
| Képlet | Description | Result |
|---|---|---|
| Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") | Egy szóközt jelenít meg csoportosítási elválasztóként, a vesszőt decimális elválasztóként használja és az € a pénznem szimbóluma. | "1 234 567,89 €" |
| Text(1234567,89; "[$-fr-FR]# ###,## €") | Ha a forrásadatok a francia szokást követik és a tizedesjegy vessző, akkor a területi beállítását franciára kell változtatni, és az argumentumokat vessző helyett pontosvesszővel kell elválasztani, hogy ugyanazt az eredményt kapja meg. | "1 234 567,89 €" |
| Text( Date(2016,1,31), "dddd mmmm d" ) | Az aktuális felhasználó nyelvén jeleníti meg a nap nevét, a hónapot és a hónap napját. Mivel a helyőrzők mindegyike nyelvtől független, nincs szükség szövegformázó nyelvcímkére. | "Sunday January 31" |
| Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) | A nap nevét, a hónapot és a hónap napját az „es-ES” nyelvbeállítás alapján jeleníti meg. | "domingo enero 31" |
Értékek szöveggé alakítása
| Képlet | Ismertetés | Eredmény |
|---|---|---|
| Text( 1234567.89 ) | Egy számot sztringgé alakít. A tizedesjel előtt vagy után nincs több ezres elválasztó és nem szabályozható a számjegyek száma. A további szabályozás érdekében a számok helyőrzőjét második argumentumként adja meg. | "1234567.89" |
| Text( DateTimeValue( "01/04/2003" ) ) | A dátum- és időértéket szöveges sztringgé alakítja át. Az átalakítás szabályozásához adja meg a DateTimeFormat enumerálás egy tagját, vagy egy egyéni formázású karakterláncot. | "1/4/2003 12:00 AM" |
| Text( true ) | Sztringgé alakít egy logikai értéket. | "true" |
| Text( GUID() ) | Sztringgé alakít egy GUID-értéket. | „f8b10550-0f12-4f08-9aa3-bb10958bc3ff” |
| Left( Text( GUID() ), 4 ) | Egy generált GUID első négy karakterét adja eredményül. | "2d9c" |