Jegyzet
Az oldalhoz való hozzáférés engedélyezést igényel. Próbálhatod be jelentkezni vagy könyvtárat váltani.
Az oldalhoz való hozzáférés engedélyezést igényel. Megpróbálhatod a könyvtár váltását.
A következőkre vonatkozik:
Vászonalapú alkalmazások Copilot Studio Desktop folyamatok Dataverse képletoszlopok Modellalapú alkalmazások Power Platform CLI Dataverse-függvények Power Pages
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 az alábbi típusú argumentumok valamelyike alapján formáz egy számot vagy dátum/idő értéket:
- 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 bármilyen adattípust átalakíthat szövegábrázolássá alapértelmezett formátum használatával. 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" |
| Régi | Óra (12 órás formátum), perc, másodperc és de./du. megjelölés. | "8:26:59 du." |
| Hosszú idő24 | Óra (24 órás formátum), perc, másodperc. | "20:26:59" |
| RövidDátum | 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. | "2020.04.07. 20:26" |
| 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" |
| Rövid idő | Óra (12 órás formátum), perc és de./du. megjelölés. | "20:26" |
| Rövididő24 | Ó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. Azonban nem ad vissza plusz nullákat, Text ha a számnak kevesebb számjegye van a tizedesvessző mindkét oldalán, mint a formátum # szimbólumai. 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. Text Vesszővel választja el a csoportokat, ha a formátum számjelek (#) vagy nullák által zárt vesszőt tartalmaz. 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. Ennek a helyőrzőnek közvetlenül a h vagy hh kód után vagy közvetlenül az ss-kód előtt kell megjelennie ; Text ellenkező esetben perc helyett a hónapot adja vissza. |
| 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. Text Ellenkező esetben perc helyett a hónapot adja vissza. |
| 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. Text "AM" vagy "a" értéket ad vissza éjféltől délig, míg a "PM" vagy a "p" értéket déltől éjfélig |
Literálok helyőrzői
A formázó sztring az alábbi karakterek bármelyikét tartalmazhatja. Ezek az eredményként Text jelennek meg. 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 tisztában van vele. 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 nyelve: A készítők számára hogyan kell értelmezni az egyéni formátumot? 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 nyelve: A felhasználók számára milyen nyelven jelenjen meg a függvény eredménye? A hónapok és a hétköznapok neveinek az alkalmazás felhasználójának megfelelő nyelven kell lenniük, amelyet megadhat egy harmadik, nem kötelező argumentum hozzáadásával a Text függvényhez.
Mindkettő esetén a nyelvet egy nyelvi címke segítségével adhatja meg. A támogatott nyelvek listájának megtekintéséhez írja be Texta (1234, "", ) szöveget a szerkesztőlécre vagy a jobb oldali panel Speciális lapjára, majd görgessen végig a harmadik argumentumhoz javasolt területi beállítások listáján.
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 által visszaadott nyelvi cí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.
[$-hu-HU] akkor feltételezi, ha ez 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
Az eredmény Text magában foglalja a hónapokra, hétköznapokra és AM/PM-megjelölésekre fordított sztringeket, valamint a megfelelő csoport- és tizedeselválasztókat.
Alapértelmezés szerint Text 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. Ezt az alapértelmezett értéket felülbírálhatja úgy, hogy megad egy nyelvi címkét a harmadik argumentumhoz Text.
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 ] )
- Szám - 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 ( Dinamikus )
- Dinamikus – Kötelező. Egy sztringet jelképező dinamikus érték. Az elfogadható értékek a típus nélküli szolgáltatótól függőek. JSON esetén, ha a dinamikus érték szám vagy logikai érték, akkor a rendszer szöveggé alakítja.
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( 12000000, "$ #,###" ) |
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-yyy" ) | 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 | Ismertetés | Eredmény |
|---|---|---|
| Text(1234567.89, "[$-fr-FR]# ##,## €", "fr-FR") | A szóközt csoportosítási elválasztóként, a vesszőt tizedesjelként, pénznemszimbólumként € jeleníti meg. | "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. | "Vasárnap január 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. | "2003.01.04. 12:00" |
| Text( igaz ) | 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" |