Teksta funkcija
Attiecas uz:
Audekla programmām Audekla programmu Dataverse formulu kolonnas Modeļa vadītas programmas Power Platform CLI
Pārvērš jebkuru vērtību un formatē skaitļa vai datuma/laika vērtību uz teksta virkni.
Apraksts
Text funkcija formatē skaitli vai datuma/laika vērtību, pamatojoties uz kādu no šāda veida argumentiem:
- Iepriekš definēts datuma/laika formāts, kas tiek norādīts, izmantojot uzskaitījumu DateTimeFormat. Datumiem un laikiem šī pieeja ir vēlama, jo tā automātiski pielāgojas katra lietotāja valodai un reģionam.
- Pielāgots formāts, kas sastāv no vietturu virknes, kuri definē, piemēram, to, vai skaitļi rāda decimāldaļu atdalītāju un vai datumi rāda mēneša pilno nosaukumu, mēnesi kā saīsinājumu vai mēnesi kā skaitli. Power Apps atbalsta vietturu apakškopu, kuru atbalsta Microsoft Excel. Šajā virknē valodas vietturis norāda valodu, kādā interpretēt citus vietturus. Ja pielāgotajā formātā ir iekļauts, piemēram, punkts, valodas formāta vietturis norāda, vai punkts ir decimāldaļu atdalītājs (ja-JP) vai tūkstošdaļu atdalītājs (es-ES).
Skatiet sadaļu darbs ar datumiem un laikiem, lai iegūtu papildinformāciju.
Funkcija Text var arī konvertēt jebkuru datu veidu teksta reprezentācijā, izmantojot noklusējuma formātu. Izmantojiet to, lai izlaistu vērtības, kas nav teksta vērtības, teksta funkcijās, piemēram, Len, Right un IsMatch.
Iepriekš definēti datuma/laika formāti
Attiecībā uz šiem piemēriem, izmantotais datums un laiks ir otrdiena, 7. aprīlis, 2020. gads, 8:26:59. 180 PM laika zonā UTC-7.
| DateTimeFormat uzskaitījums | Apraksts | Piemēri (ar en-US) |
|---|---|---|
| LongDate | Četrciparu gads, mēneša nosaukums, mēneša diena un nedēļas diena. Mēneša un nedēļas dienas nosaukums nav saīsināts. | "Otrdiena, 2020. gada 7. aprīlis" |
| LongDateTime | Četrciparu gads, mēneša nosaukums, mēneša diena un nedēļas diena, plus stunda (12 stundu pulkstenis), minūtes, sekundes un AM/PM apzīmējums. Mēneša un nedēļas dienas nosaukums nav saīsināts. | "Otrdiena, 2020. gada 7. aprīlis 8:26:59 PM" |
| LongDateTime24 | Četrciparu gads, mēnesis, mēneša diena un nedēļas diena, plus stunda (24 stundu pulkstenis), minūtes un sekundes. Mēneša un nedēļas dienas nosaukums nav saīsināts. | "Otrdiena, 2020. gada 7. aprīlis 20:26:59" |
| LongTime | Stunda (12 stundu pulkstenis), minūtes, sekundes un AM/PM apzīmējums. | "8:26:59 PM" |
| LongTime24 | Stunda (24 stundu pulkstenis), minūtes, sekundes. | "20:26:59" |
| ShortDate | Četrciparu gads ar mēneša skaitli un mēneša dienu. | "4/7/2020" |
| ShortDateTime | Četrciparu gads ar mēneša skaitli un mēneša dienu, plus stunda (12 stundu pulkstenis), minūtes, sekundes un AM/PM apzīmējums. | "4/7/2020 8:26 PM" |
| ShortDateTime24 | Četrciparu gads ar mēneša skaitli un mēneša dienu, plus stunda (24 stundu pulkstenis) un minūtes. | "4/7/2020 20:26" |
| ShortTime | Stunda (12 stundu pulkstenis), minūtes un AM/PM apzīmējums. | "8:26 PM" |
| ShortTime24 | Stunda (24 stundu pulkstenis) un minūtes. | "20:26" |
| UTC | Datuma/laika vērtība tiek konvertēta uz UTC laiku, pamatojoties uz pašreizējā lietotāja laika joslu un tiek formatēta atbilstoši ISO 8601 standartam. | "2020-04-08T03:26:59.180Z" |
Skaitļu vietturi
| Vietturis | Apraksts |
|---|---|
| 0 (nulle) | Parāda nenozīmīgas nulles, ja skaitlī ir mazāk ciparu, nekā formālā ir nuļļu. Piemēram, izmantojiet formātu #.00, ja vēlaties rādīt 8.9 kā 8.90. |
| # | Tiek ievērotas tās pašas kārtulas, kuras ievēro 0 (nulle). Taču Teksts neatgriež papildu nulles, ja skaitlim abos decimāldaļskaitļos ir mazāk rakstzīmju, nekā tajā ir # simbolu. Piemēram, 8.9 tiek parādīts, ja pielāgotais formāts ir #.## un skaitļa formāts ir 8.9. |
| . (punkts) | Rāda decimāldaļu atdalītāju skaitlī. Atkarībā no pielāgotā formāta valodas, papildu informāciju skatiet rakstā globālās programmas. |
| , (komats) | Parāda grupēšanas atdalītāju skaitlī, ko bieži izmanto tūkstošiem. Teksts atdala grupas ar komatiem, ja formāts satur komatu, kuru ietver numura zīmes (#) vai nulles. Atkarībā no pielāgotā formāta valodas, papildu informāciju skatiet rakstā globālās programmas. |
Ja skaitlī ir vairāk ciparu pa labi no decimālzīmes, nekā formātā ir vietturi, skaitlis tiek noapaļots uz tik daudzām decimālvietām, cik daudz ir vietturu. Ja pa kreisi no decimālzīmes ir vairāk ciparu nekā vietturu, tiek parādīti papildu cipari. Ja skaitlī ir tikai skaitļa zīmes (#) pa kreisi no decimālzīmes, skaitļi, kas mazāki par 1, sākas ar decimālzīmi (piemēram, .47).
Datuma un laika vietturi
| Vietturis | Apraksts |
|---|---|
| m | Parāda mēnesi kā skaitli bez nulles pirms. |
| mm | Rāda mēnesi kā skaitli ar nulli pirms, ja nepieciešams. |
| mmm | Parāda mēnesi kā saīsinājumu (noJan līdz Dec). |
| mmmm | Parāda mēnesi kā pilno nosaukumu (nojanvāra līdz decembrim). |
| d | Parāda dienu kā skaitli bez nulles pirms. |
| dd | Rāda dienu kā skaitli ar nulli pirms, ja nepieciešams. |
| ddd | Parāda dienu kā saīsinājumu (noPirmd līdz Otrd). |
| dddd | Parāda dienu kā pilnu nosaukumu (nosvētdienas līdz sestdienai). |
| yy | Parāda gadskaitli divciparu skaitļa veidā. |
| yyyy | Parāda gadskaitli četrciparu skaitļa veidā. |
| h | Parāda stundu kā skaitli bez nulles pirms. |
| hh | Rāda stundu kā skaitli ar nulli pirms, ja nepieciešams. Ja formātā iekļauts AM vai PM, stundas tiek rādītas pēc 12 stundu pulksteņa. Pretējā gadījumā stundas tiek parādītas pēc 24 stundu pulksteņa. |
| m | Parāda minūti kā skaitli bez nulles pirms. Šim vietturim ir jāatrodas uzreiz pēc h vai hh koda vai tieši pirms ss koda; pretējā gadījumā Teksts atgriež mēnesi, nevis minūtes. |
| mm | Rāda minūti kā skaitli ar nulli pirms, ja nepieciešams. Šim vietturim ir jāatrodas uzreiz pēc h vai hh viettura vai tieši pirms ss viettura. Pretējā gadījumā Teksts atgriež mēnesi, nevis minūtes. |
| s | Parāda sekundi kā skaitli bez nulles pirms. |
| ss | Rāda sekundi kā skaitli ar nulli pirms, ja nepieciešams. |
| f | Rāda sekunžu daļskaitļus. |
| AM/PM, a/p | Rāda stundas pēc 12 stundu pulksteņa. Teksts atgriež "AM" vai "a" laikam no pusnakts līdz pusdienlaikam un "PM" vai "p" laikam no pusdienlaika līdz pusnaktij |
Literāļa vietturi
Formāta virknē varat iekļaut jebkuru no šīm rakstzīmēm. Tie tiks parādīti Teksta rezultātā tādi, kādi tie ir. Papildu rakstzīmes ir rezervētas turpmākiem vietturiem, tāpēc jums tās nevajadzētu lietot.
| Rakstzīme | Apraksts |
|---|---|
| Jebkuras valūtas simbols | Dolāra zīme, centu zīme, eiro zīme u.c. |
| + | Pluszīme |
| ( | Kreisās iekavas |
| : | Kols |
| ^ | Diakritiskais akcents (jumtiņa rakstzīme) |
| ' | Apostrofs |
| { | Kreisās figūriekavas |
| < | Zīme Mazāks par |
| = | Vienādības zīme |
| - | Mīnusa zīme |
| / | Slīpsvītra |
| ) | Labās iekavas |
| & | Zīme Un |
| ~ | Tilde |
| } | Labās figūriekavas |
| > | Zīme Lielāks par |
| Atstarpes rakstzīme |
Globālās programmas
Funkcija Text ir piemērojama globāli. Tā zina, kā plašā valodu klāstā pareizi rakstīt datumus, laiku, valūtas un skaitļus. Lai veiktu savu darbu, tai ir nepieciešama divu veidu informācija:
- Pielāgotā formāta valoda: Kā veidotājiem vajadzētu interpretēt pielāgoto formātu? Atdalītāja rakstzīmēm (.un ,) ir atšķirīga nozīme dažādās valodās. Ja konkretizējat pielāgotu formātu, varat iekļaut valodas vietturi vai paņemt noklusējuma vērtību, kura atspoguļo valodu, uz kuru ir iestatīta jūsu ierīce. Vēl vienkāršāk, varat izmantot kādu no iepriekšdefinētajiem datuma/laika formātiem, kas ir neatkarīgs no valodas.
- Rezultāta valoda: Kādā valodā vajadzētu parādīties funkcijas rezultātam lietotājiem? Mēnešu un darbdienu nosaukumiem ir jābūt atbilstošā valodā programmas lietotājam, ko varat norādīt, funkcijai Text pievienojot trešo, neobligāto argumentu.
Abos gadījumos valodu konkretizē, izmantojot valodas tagu. Lai skatītu atbalstīto valodu sarakstu, formulas joslā vai labās rūts cilnē Papildu ievadiet Text( 1234, "", ) un pēc tam ritiniet trešajam argumentam ierosināto lokalizāciju sarakstu.
Valodas vietturis
Lai norādītu pielāgotā formāta valodu, izmantojiet:
| Vietturis | Apraksts |
|---|---|
| [$-LanguageTag] | LanguageTag ir valodas tags, kas tiek atgriezts no funkcijas Language. Tas var konkretizēt tikai valodu (piemēram, [$-en] angļu valodai) vai tas var arī konkretizēt reģionu (piemēram, [$-en-GB] lai tālāk konkretizētu Lielbritāniju). |
Valodas vietturis var tikt parādīts jebkurā pielāgotā formātā, bet tikai vienreiz.
Ja norādāt pielāgotu formātu bez valodas viettura un formāts nav viennozīmīgs globālā aspektā, jūsu pašreizējās valodas tags tiks ievadīts automātiski.
[$-en-US] tiek pieņemts, ja šī viettura nav, kad programma tiek palaista.
Note
Nākamajā versijā šī viettura sintakse var mainīties, lai izvairītos no sajaukšanas ar līdzīgiem, bet atšķirīgiem vietturiem, ko atbalsta programma Excel.
Rezultāta valodas tags
Teksta rezultāts ietver tulkotas virknes mēnešiem, darbdienām un AM/PM apzīmējumiem, kā arī atbilstošos grupas un decimāldaļu atdalītājus.
Pēc noklusējuma Tekstā tiek izmantota tā lietotāja valoda, kurš darbina programmu. Funkcija Language atgriež pašreizējā lietotāja valodas tagu. Šo noklusējuma vērtību var ignorēt, nosūtot trešā argumenta valodas tagu funkcijai Teksts.
Sintakse
Teksts( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )
- NumberOrDateTime — Obligāti. Skaitļa vai datuma/laika vērtība, ko formatēt.
- DateTimeFormat — Obligāti. DateTimeFormat uzskaitījuma dalībnieks.
- ResultLanguageTag — Nav obligāti. Valodas tags, ko izmantot rezultāta tekstam. Pēc noklusējuma tiek izmantota pašreizējā lietotāja valoda.
Teksts( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )
- Skaitlis — Obligāti. Skaitļa vai datuma/laika vērtība, ko formatēt.
- CustomFormat — Obligāti. Viens vai vairāki vietturi ir ietverti pēdiņās.
- ResultLanguageTag — Nav obligāti. Valodas tags, ko izmantot rezultāta tekstam. Pēc noklusējuma tiek izmantota pašreizējā lietotāja valoda.
Teksts( AnyValue )
- AnyValue — Obligāti. Vērtība, kuru konvertēt teksta reprezentācijā. Tiek izmantots noklusējuma formāts.
Teksts ( nav ievadīts )
- Nav ievadīts — nepieciešams. Netipēts objekts, kas apzīmē virkni. Atkarīgās vērtības ir atkarīgas no netipa nodrošinātāja. JSON gadījumā, ja neierakstītais objekts ir skaitlis vai būla, tas tiks pārvērsts par tekstu.
Piemēri
Ja vien nav norādīts citādi, lietotājs, kas izmanto šīs formulas, atrodas Amerikas Savienotajās Valstīs un ir atlasījis angļu valodu. Language funkcija atgriež "en-US".
Numurs
| Formula | Apraksts | Rezultāts |
|---|---|---|
| Teksts( 1234.59, "####.#" ) | Formatē skaitli ar vienu decimāldaļas vietu. | "1234.6" |
| Teksts( 8.9,"#.000" ) | Ja nepieciešams, papildina skaitļa decimāldaļu ar nullēm pēc. | "8.900" |
| Teksts( 0.631, "0.#" ) | Ja nepieciešams, papildina visu skaitli ar nullēm pirms. | "0.6" |
| Teksts( 12, "#.0#" ) Teksts( 1234.568, "#.0#" ) |
Papildina skaitļa decimāldaļu ar nullēm vienai decimālvietai un ietver otro decimālvietu, ja tā tiek nodrošināta. | "12.0" "1234.57" |
| Teksts( 12000, "$ #,###" ) Teksts( 1200000, "$ #,###" ) |
Novieto tūkstošu atdalītāju ik pēc trim cipariem un ietver valūtas simbolu. | "12,000 $" "1,200,000 $" |
Datums/laiks
- 2:37:47 PMpirmdien, 2015. gada 23. novembrī
- Amerikas Savienoto Valstu Klusā okeāna laika josla (UTC-8)
| Formula | Apraksts | Rezultāts |
|---|---|---|
| Teksts( Now(), DateTimeFormat.LongDate ) | Formatē kā garu datuma virkni pašreizējā lietotāja valodā un lokalizācijā. | "Pirmdiena, 2015. gada 23. novembris" |
| Teksts( Now(), DateTimeFormat.LongDateTime ) | Formatē kā garu datuma un laika virkni pašreizējā lietotāja valodā un lokalizācijā, izmantojot 12 stundu pulksteni. | "Pirmdiena, 2015. gada 23. novembris 2:37:47 PM" |
| Teksts( Now(), DateTimeFormat.LongTime24 ) | Formatē kā garu laika virkni, izmantojot 24 stundu pulksteni. | "14:37:47" |
| Teksts( Now(), DateTimeFormat.ShortDate ) | Formatē kā īsu datuma virkni pašreizējā lietotāja valodā un lokalizācijā. | "11/23/2015" |
| Text( Now(), "d-mmm-yy" ) | Formāti, izmantojot viettura rakstzīmes:
|
"23-Nov-15" |
| Teksts(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") | Rāda Unix datuma-laika vērtību cilvēkam lasāmā formāta, ja reizināt avota vērtību ar 1000. | "Nov. 23, 2015 (02:47:37 PM)" |
Globālās programmas
| Formula | Apraksts | Rezultāts |
|---|---|---|
| Teksts(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") | Rāda atstarpi kā grupas atdalītāju, komatu kā decimāldaļu atdalītāju un € kā valūtas simbolu. | "1 234 567,89 €" |
| Teksts(1234567,89; "[$-fr-FR]# ###,## ") | Ja avota dati ievēro Francijas tradīciju par decimāldaļu atdalītāju izmantot komatu, jums ir jāmaina savu lokalizāciju uz Franču un jāatdala argumenti ar semikolu, nevis komatu, lai iegūtu tādu pašu rezultātu kā augstāk. | "1 234 567,89 €" |
| Text( Date(2016,1,31), "dddd mmmm d" ) | Atgriež mēneša dienu, mēnesi un mēneša dienu pašreizējā lietotāja valodā. Tā kā neviens no vietturiem nav atkarīgs no valodas, nav vajadzības formatēt teksta valodas tagu. | "Svētdiena, 31. janvāris" |
| Teksts( Date(2016,1,31), "dddd mmmm d", "es-ES" ) | Atgriež mēneša dienu, mēnesi un mēneša dienu "es-ES" valodā. | "domingo enero 31" |
Vērtību konvertēšana tekstā
| Formula | Apraksts | Rezultāts |
|---|---|---|
| Teksts( 1234567.89 ) | Konvertē skaitli virknē. Pirms vai pēc decimāldaļu atdalītāja nav tūkstošu atdalītāju vai kontroles pār cipariem; lai iegūtu vairāk kontroles, nodrošiniet skaitļu vietturus kā otro argumentu. | "1234567.89" |
| Teksts(DateTimeValue( "01/04/2003" ) ) | Konvertē datuma/laika vērtību teksta virknē. Lai kontrolētu šo konvertēšanu, nodrošiniet vai nu DateTimeFormat uzskaitījuma dalībnieku vai pielāgota formāta virkni. | "1/4/2003 12:00 AM" |
| Teksts( true ) | Konvertē Būla vērtību virknē. | "true" |
| Text( GUID() ) | Konvertē ģenerēto GUID vērtību virknē. | "f8b10550-0f12-4f08-9aa3-bb10958bc3ff" |
| Left( Text( GUID() ), 4 ) | Atgriež ģenerētā GUID pirmās četras rakstzīmes. | "2d9c" |