Teksta funkcija pakalpojumā Power Apps

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.98.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 (no Jan līdz Dec).
mmmm Parāda mēnesi kā pilno nosaukumu (no janvā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 (no Pirmd līdz Otrd).
dddd Parāda dienu kā pilnu nosaukumu (no svē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.

Piezīme

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 — Neobligā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 — Neobligā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.

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 PM pirmdien, 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:
  • d viencipara vai divciparu mēneša dienai
  • - kā literālā rakstzīme, kas iekopēta rezultātā
  • mmm mēneša trīsburtu saīsinājumam
  • - kā vēl viena literālā rakstzīme, kas iekopēta rezultātā
  • yy gada divciparu saīsinājumam
"23-Nov-15"
Text(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ētdienaJanuary31  "
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"
Teksts( GUID() ) Konvertē ģenerēto GUID vērtību virknē. "f8b10550-0f12-4f08-9aa3-bb10958bc3ff"
Pa kreisi( Teksts( GUID() ), 4 ) Atgriež ģenerētā GUID pirmās četras rakstzīmes. "2d9c"

Piezīme

Kādas ir jūsu dokumentācijas valodas preferences? Aizpildiet īsu aptauju. (ņemiet vērā, ka aptauja ir angļu valodā)

Aptaujai būs nepieciešamas aptuveni septiņas minūtes. Nekādi personas dati netiks vākti (paziņojums par konfidencialitāti).