Textová funkcia
Vzťahuje sa na:
aplikácie plátna aplikácie plátna Dataverse stĺpce vzorcov aplikácie s podporou modelov Power Pages Power Platform CLI
Skonvertuje akúkoľvek hodnotu alebo naformátuje číslo alebo hodnotu dátumu a času na textový reťazec.
Popis
Funkcia Text formátuje číslo alebo hodnotu dátumu a času na základe jedného z týchto typov argumentov:
- Preddefinovaný formát dátumu a času, ktorý určíte pomocou enumerácie DateTimeFormat. Pre dátum a čas sa tento prístup uprednostňuje, pretože sa automaticky prispôsobí jazyku a regióne používateľa.
- Vlastný formát, ktorý obsahuje reťazec zástupných znakov, ktoré napríklad definujú, či čísla ukazujú oddeľovač desatinných miest a dátumy, zobrazujú celé meno mesiaca, mesiac ako skratku alebo mesiac ako číslo. Power Apps podporuje podmnožinu zástupných symbolov, ktoré robí Microsoft Excel. V tomto reťazci zástupný symbol jazyka určuje jazyk, v ktorom sa majú interpretovať ďalšie zástupné symboly. Ak napríklad vlastný formát obsahuje bodku, zástupný symbol jazykového formátu určuje, či je bodka oddeľovač desatinných miest (ja-JP) alebo oddeľovač tisícov (es-ES).
Ďalšie informácie nájdete v časti o práci s dátumami a časmi.
Funkcia Text môže tiež konvertovať akýkoľvek typ údajov na textovú reprezentáciu pomocou predvoleného formátu. Použite to na odovzdanie netextových hodnôt textovým funkciám, ako je napr Len, Right a IsMatch.
Preddefinované formáty dátumu a času
Pre tieto príklady je použitý dátum a čas utorok 7. apríla, 2020 8:26:59.180 PM, v časovom pásme UTC-7 hodín.
| Zoznam DateTimeFormat | Popis | Príklady (použitie en-US) |
|---|---|---|
| LongDate | Štvorčíselný rok, názov mesiaca, deň v mesiaci a deň v týždni. Názvy mesiacov a dní v týždni nie sú skrátené. | „Utorok 7. apríla 2020“ |
| LongDateTime | Štvormiestny rok, názov mesiaca, deň v mesiaci a deň v týždni, plus hodina (12-hodinový formát), minúty, sekundy a označenie dop/odp. Názvy mesiacov a dní v týždni nie sú skrátené. | „Utorok 7. apríla 2020 8:26:59 PM“ |
| LongDateTime24 | Štvormiestny rok, názov mesiaca, deň v mesiaci a deň v týždni, plus hodina (24-hodinový formát), minúty a sekundy. Názvy mesiacov a dní v týždni nie sú skrátené. | „Utorok 7. apríla 2020 20:26:59“ |
| LongTime | Hodina (12-hodinový formát), minúty, sekundy a označenie dop/odp. | „8:26:59 PM” |
| Dlho24 | Hodina (24-hodinový formát), minúty, sekundy. | „20:26:59” |
| ShortDate | Štvorciferný rok s číselným mesiacom a dňom v mesiaci. | „4/7/2020” |
| ShortDateTime | Štvorciferný rok s číselným mesiacom a dňom v mesiaci, plus hodina (12-hodinový formát), minúty a označenie dop/odp. | „4/7/2020 8:26 PM” |
| ShortDateTime24 | Štvorciferný rok s číselným mesiacom a dňom v mesiaci, plus hodina (24-hodinový formát) a minúty. | „4/7/2020 20:26” |
| ShortTime | Hodina (12-hodinový formát), minúty a označenie dop/odp. | „8:26 PM” |
| Krátkodobé 24 | Hodina (24-hodinový formát) a minúty. | „20:26” |
| UTC | Hodnota dátumu/času sa prevedie na UTC na základe časového pásma používateľa a naformátuje sa podľa štandardu ISO 8601. | „2020-04-08T03:26:59.180Z” |
Zástupné symboly čísiel
| Zástupný text | Popis |
|---|---|
| 0 (nula) | Zobrazí prebytočné nuly v prípade, že číslo má menej číslic, než je počet núl vo formáte. Použite napríklad formát #.00, ak chcete zobraziť 8.9 ako 8.90. |
| # | Platia tu rovnaké pravidlá ako pre 0 (nula). Text však nevráti nuly navyše, keď má formát menej číslic na niektorej zo strán desatinnej čiarky, než je symbolov vo formáte #. Napríklad 8.9 sa zobrazí, ak je vlastný formát #.## a číslo, ktoré sa má formátovať, je 8.9. |
| , (bodka) | Zobrazí oddeľovač desatinných miest v čísle. Závisí na jazyku vlastného formátu. Ďalšie podrobnosti nájdete v časti Globálne aplikácie. |
| , (čiarka) | Zobrazí oddeľovač skupín v čísle, často sa používa pre tisíce. Text oddeľuje skupiny čiarkami, ak formát obsahuje čiarku, ktorá je uzavretá znakmi čísla (#) alebo nulami. Závisí na jazyku vlastného formátu. Ďalšie podrobnosti nájdete v časti Globálne aplikácie. |
Ak má číslo napravo od desatinnej čiarky väčší počet čísel, než je počet zástupných symbolov vo formáte, číslo sa zaokrúhli na toľko desatinných miest, koľko je týchto zástupných symbolov. Ak je naľavo od desatinnej čiarky viac číslic než zástupných symbolov, číslice naviac sa zobrazia. Ak formát obsahuje naľavo od desatinnej čiarky iba symboly čísla (#), čísla menšie ako 1 budú začínať oddeľovačom desatinných miest (napríklad .47).
Zástupné symboly dátumu a času
| Zástupný text | Popis |
|---|---|
| m | Zobrazí mesiac ako číslo bez úvodnej nuly. |
| mm | Zobrazí mesiac ako číslo s úvodnou nulou (tam, kde je to vhodné). |
| mmm | Zobrazí mesiac ako skratku (jan až dec). |
| mmmm | Zobrazí mesiac ako úplný názov (január až december). |
| d | Zobrazí deň ako číslo bez úvodnej nuly. |
| dd | Zobrazí deň ako číslo s úvodnou nulou (tam, kde je to vhodné). |
| ddd | Zobrazí deň ako skratku (po až ne). |
| dddd | Zobrazí deň ako úplný názov (pondelok až nedeľa). |
| yy | Zobrazí rok ako dvojmiestne číslo. |
| yyyy | Zobrazí rok ako štvormiestne číslo. |
| h | Zobrazí hodinu ako číslo bez úvodnej nuly. |
| hh | Zobrazí hodinu ako číslo s úvodnou nulou (tam, kde je to vhodné). Ak formát obsahuje označenie AM alebo PM, hodina sa zobrazí v 12-hodinovom formáte. V opačnom prípade sa hodina zobrazí v 24-hodinovom formáte. |
| m | Zobrazí minútu ako číslo bez úvodnej nuly. Tento zástupný znak sa musí nachádzať ihneď za kódom h alebo hh alebo bezprostredne pred kódom ss. Inak funkcia Text vráti namiesto minút mesiac. |
| mm | Zobrazí minútu ako číslo s úvodnou nulou (tam, kde je to vhodné). Tento zástupný symbol sa musí nachádzať ihneď za zástupným symbolom h alebo hh alebo bezprostredne pred zástupným symbolom ss. V opačnom prípade funkcia Text vráti namiesto minút mesiac. |
| s | Zobrazí sekundu ako číslo bez úvodnej nuly. |
| ss | Zobrazí sekundu ako číslo s úvodnou nulou (tam, kde je to vhodné). |
| f | Zobrazí zlomky sekúnd. |
| AM/PM, a/p | Zobrazí hodinu v 12-hodinovom formáte. Text vracia „AM“ alebo „a“ pre časy od polnoci do poludnia a „PM“ alebo „p“ pre časy od poludnia do polnoci |
Explicitné zástupné symboly
Do reťazca formátu môžete zahrnúť ktorékoľvek z týchto znakov. Zobrazia sa vo výsledku funkcie Text. Ďalšie znaky sú vyhradené pre budúce zástupné symboly, takže by ste ich nemali používať.
| Znak | Popis |
|---|---|
| Ľubovoľný symbol meny | Znak dolára, znak eura atď. |
| + | Znamienko plus |
| ( | Ľavá zátvorka |
| : | Dvojbodka |
| ^ | Cirkumflex (znak vsuvky) |
| ' | Apostrof |
| { | Ľavá zložená zátvorka |
| < | Znak menšie ako |
| = | Znak rovnosti |
| - | Znamienko mínus |
| / | Lomka |
| ) | Pravá zátvorka |
| & | Ampersand |
| ~ | Vlnovka |
| } | Pravá zložená zátvorka |
| > | Znak väčšie ako |
| Znak medzery |
Globálne aplikácie
Funkcia Text je globálna. Pre širokú škálu jazykov vie, ako správne písať dátumy, časy, meny a čísla. Aby fungovala správne, potrebuje tieto dva druhy údajov:
- Jazyk vlastného formátu: Ako by mal byť pre tvorcov interpretovaný vlastný formát? Oddeľovacie znaky (. a ,) majú rôzny význam v rôznych jazykoch. Ak zadáte vlastný formát, môžete zahrnúť zástupný symbol jazyka alebo použiť predvolenú hodnotu, ktorá odráža jazyk, v ktorom je zariadenie nastavené. Ešte jednoduchšie môžete použiť jeden z preddefinovaných formátov dátumu a času, ktoré sú jazykovo agnostické.
- Jazyk výsledku: V akom jazyku by sa mal zobraziť výsledok funkcie pre používateľov? Mená mesiacov a pracovných dní musia byť pre používateľa aplikácie v príslušnom jazyku, ktorý môžete určiť pridaním tretieho voliteľného argumentu do funkcie Text.
Pri obidvoch jazykoch určíte jazyk pomocou a jazykovej značky. Ak chcete zobraziť zoznam podporovaných jazykov, zadajte do riadka vzorcov alebo na karte Rozšírené pravej tably zobrazenia vzorec Text( 1234, "", ) a prechádzajte zoznam miestnych nastavení navrhovaných pre tretí argument.
Zástupný symbol jazyka
Ak chcete určiť jazyk vlastného formátu, použite:
| Zástupný text | Popis |
|---|---|
| [$-LanguageTag] | LanguageTag je jazyková značka vrátená funkciou Jazyk . Môže mať tvar obsahujúci iba jazyk, napríklad [$-en] pre angličtinu, alebo môže uvádzať tiež oblasť, napríklad [$-en-GB], ktorá špecifikuje Veľkú Britániu. |
Zástupný symbol jazyka sa môže vyskytovať kdekoľvek vo vlastnom formáte, môže tam však byť iba raz.
Ak zadáte vlastný formát bez zástupného znaku jazyka a formát je z globálneho hľadiska nejednoznačný, automaticky sa vloží jazyková značka pre váš aktuálny jazyk.
[$-en-US] sa predpokladá, ak tento zástupný symbol nie je prítomný pri spustení vašej aplikácie.
Poznámka
V budúcej verzii sa syntax tohto zástupného symbolu môže zmeniť, aby nedochádzalo k zámenám s podobným zástupným symbolom podporovaným v programe Excel.
Značka jazyka výsledku
Vo výsledku funkcie Text sa zobrazujú preložené reťazce pre mesiace, dni v týždni a označenie dop/odp a tiež príslušné oddeľovače skupín a desatinných miest.
V predvolenom nastavení funkcia Text používa jazyk používateľa spustenej aplikácie. Funkcia Language vráti značku jazyka aktuálneho používateľa. Túto predvolenú hodnotu môžete prepísať zadaním značky jazyka pre tretí argument funkcie Text.
Syntax
Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )
- NumberOrDateTime – povinné. Číslo alebo hodnota dátumu a času, ktoré sa majú formátovať.
- DateTimeFormat – povinné. Člen enumerácie DateTimeFormat.
- ResultLanguageTag – voliteľné. Značka jazyka, ktorý sa má použiť pre výsledný text. V predvolenom nastavení sa použije jazyk aktuálneho používateľa.
Text( NumberOrDateTime, Vlastný formát [, ResultLanguageTag ] )
- Číslo – povinné. Číslo alebo hodnota dátumu a času, ktoré sa majú formátovať.
- CustomFormat – povinné. Jeden alebo viacero zástupných symbolov sa uzatvára do dvojitých úvodzoviek.
- ResultLanguageTag – voliteľné. Značka jazyka, ktorý sa má použiť pre výsledný text. V predvolenom nastavení sa použije jazyk aktuálneho používateľa.
Text( AkákoľvekHodnota )
- AnyValue – povinné. Hodnota pre prevod na textové znázornenie. Používa sa predvolený formát.
Text ( Nezadané )
- Nezadané – povinné. netypový objekt ktorý predstavuje reťazec. Prijateľné hodnoty závisia od netypového poskytovateľa. Ak je v prípade JSON netypový objekt číslo alebo boolovská hodnota, skonvertuje sa na text.
Príklady
Ak nie je stanovené inak, používateľ, ktorý spúšťa tieto vzorce, sa nachádza v Spojených štátoch a vybral si ako svoj jazyk angličtinu. Funkcia Language vráti „en-US“.
Číslo
| Vzorec | Popis | Výsledok |
|---|---|---|
| Text( 1234,59, "####.#" ) | Formátuje číslo s jedným desatinným miestom. | "1234.6" |
| Text( 8.9, "#.000" ) | V prípade potreby vyplní desatinnú časť čísla koncovými nulami. | „8.900” |
| Text( 0,631, "0.#" ) | V prípade potreby vyplní celú časť čísla úvodnými nulami. | „0.6” |
| Text( 12, "#.0#" ) Text( 1234.568, "#.0#" ) |
Vyplní desatinnú časť čísla nulami pre jedno desatinné číslo a zahrnie aj druhé desatinné číslo, ak je zadané. | „12.0” „1234.57” |
| Text( 12000, "$ #,###" ) Text( 1200000, "$ #,###" ) |
Umiestni po každých troch čísliciach oddeľovač tisícov a zahrnie symbol meny. | "$ 12,000" "$ 1,200,000" |
Dátum a čas
- Čas 2:37:47 PM a dátum Pondelok 23. novembra 2015
- Spojené štáty – tichomorské časové pásmo (UTC-8)
| Vzorec | Popis | Výsledok |
|---|---|---|
| Text( Now(), DateTimeFormat.LongDate ) | Formátuje text ako reťazec dlhého dátumu v jazyku a národnom prostredí aktuálneho používateľa. | „Pondelok, November 23, 2015” |
| Text( Now(), DateTimeFormat.LongDateTime ) | Formátuje text ako reťazec dlhého dátumu a času v jazyku a národnom prostredí aktuálneho používateľa. Používa 12-hodinový formát času. | „Pondelok, November 23, 2015 2:37:47 PM” |
| Text( Now(), DateTimeFormat.LongTime24 ) | Formátuje text ako reťazec dlhého času, používa 24-hodinový formát času. | „14:37:47” |
| Text( Now(), DateTimeFormat.ShortDate ) | Formátuje text ako reťazec krátkeho dátumu v jazyku a národnom prostredí aktuálneho používateľa. | „11/23/2015” |
| Text( Now(), "d-mmm-rr" ) | Formátuje text pomocou znakov zástupného symbolu:
|
„23-Nov-15” |
| Text(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") | Ak vynásobíte zdrojovú hodnotu číslom 1 000, zobrazí sa hodnota Unix pre dátum a čas vo formáte čitateľnom pre človeka. | „Nov. 23, 2015 (02:47:37 PM)” |
Globálne aplikácie
| Vzorec | Popis | Výsledok |
|---|---|---|
| Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") | Zobrazuje medzeru ako oddeľovač zoskupenia, čiarku ako oddeľovač desatinných miest a € ako symbol meny. | "1 234 567,89 €" |
| Text(1234567,89; "[$-fr-FR]# ###,## €") | Ak sa zdrojové údaje riadia francúzskym zvykom používať ako oddeľovač desatinných miest čiarku, musíte zmeniť miestne nastavenie na francúzske a oddeliť argumenty bodkočiarkou namiesto čiarky, aby ste dosiahli rovnaký výsledok ako vyššie. | "1 234 567,89 €" |
| Text( Date(2016,1,31), "dddd mmmm d" ) | Vráti deň v týždni, mesiac a deň v mesiaci v jazyku aktuálneho používateľa. Vzhľadom na to, že žiadny zo zástupných symbolov nie je závislý na jazyku, nie je potrebné použiť značku jazyka formátu textu. | "Nedeľa Január 31" |
| Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) | Vráti deň v týždni, mesiac a deň v mesiaci v jazyku es-ES. | "domingo enero 31" |
Prevod hodnôt na text
| Vzorec | Popis | Výsledok |
|---|---|---|
| Text( 1234567.89 ) | Konvertuje číslo na reťazec. Neexistujú žiadne tisíce oddeľovačov ani kontrola nad počtom číslic pred desatinnou čiarkou alebo za ňou; pre väčšiu kontrolu poskytnite ako druhý argument zástupné symboly pre číslo. | „1234567.89” |
| Text( DateTimeValue( "01/04/2003") ) | Skonvertuje hodnotu dátumu a času na reťazec textu. Ak chcete ovládať konverziu, zadajte buď číslo výčtu DateTimeFormat, alebo reťazec vlastného formátu. | „1/4/2003 12:00 AM” |
| Text (pravda) | Skonvertuje booleovskú hodnotu na reťazec. | "true" |
| Text( GUID() ) | Skonvertuje vygenerovanú hodnotu GUID na reťazec. | „f8b10550-0f12-4f08-9aa3-bb10958bc3ff” |
| Vľavo( Text( GUID() ), 4 ) | Vracia prvé štyri znaky vygenerovaného GUID. | „2d9c” |