Kopīgot, izmantojot

Text funkcija

Attiecas uz: Audekla programmas Copilot Studio Darbvirsmas plūsmas Dataverse formulas kolonnas Modeļa vadītas programmas Power Platform CLI Dataverse funkcijas Power Pages

Pārvērš jebkuru vērtību un formatē skaitļa vai datuma/laika vērtību uz teksta virkni.

Apraksts

Funkcija Text formatē skaitli vai datuma/laika vērtību, pamatojoties uz vienu no šiem argumentu tipiem:

  • 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ī pārvērst jebkuru datu tipu par teksta attēlojumu, 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). Tomēr Text neatgriež papildu nulles, ja skaitlim ir mazāk ciparu abās decimāldaļas pusēs nekā formātā ir # simboli. 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. Text Atdala grupas ar komatiem, ja formātā ir komats, kas ietverts ar ciparu zīmēm (#) vai nullēm. 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 jābūt tūlīt pēc h vai hh koda vai tieši pirms ss koda; pretējā gadījumā Text 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ā Text 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. Text atgriež "AM" vai "a" laikiem no pusnakts līdz pusdienlaikam un "PM" vai "p" laikiem no pusdienlaika līdz pusnaktij

Literāļa vietturi

Formāta virknē varat iekļaut jebkuru no šīm rakstzīmēm. Tie parādīsies tā Text , kā tas 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 globāli informēta. 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 būtu jāinterpretē pielāgots formāts? 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: Lietotājiem kādā valodā jāparādās funkcijas rezultātam? Mēnešu un darba dienu nosaukumiem ir jābūt programmas lietotājam atbilstošā valodā, ko var 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, ierakstiet Text( 1234, "", ) formulu joslā vai labās puses rūts cilnē Papildu un pēc tam ritiniet trešajam argumentam ieteikto 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.

[$-lv-US] tiek pieņemts, ja šis vietturis nav pieejams programmas palaišanas laikā.

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

Rezultāts Text ietver tulkotās virknes mēnešiem, darba dienām un AM/PM apzīmējumiem, kā arī atbilstošos grupu un decimāldaļu atdalītājus.

Pēc noklusējuma Text izmanto tā lietotāja valodu, kurā darbojas programma. Funkcija Language atgriež pašreizējā lietotāja valodas tagu. Šo noklusējuma vērtību var ignorēt, ievadot valodas tagu trešajam argumentam .Text

Sintakse

Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )

  • NumberOrDateTime - nepieciešams. Skaitļa vai datuma/laika vērtība, ko formatēt.
  • DateTimeFormat - nepieciešams. DateTimeFormat uzskaitījuma dalībnieks.
  • ResultLanguageTag - pēc izvēles. Valodas tags, ko izmantot rezultāta tekstam. Pēc noklusējuma tiek izmantota pašreizējā lietotāja valoda.

Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )

  • Skaits - nepieciešams. Skaitļa vai datuma/laika vērtība, ko formatēt.
  • CustomFormat - nepieciešams. Viens vai vairāki vietturi ir ietverti pēdiņās.
  • ResultLanguageTag - pēc izvēles. Valodas tags, ko izmantot rezultāta tekstam. Pēc noklusējuma tiek izmantota pašreizējā lietotāja valoda.

Text( Jebkura vērtība )

  • AnyValue - Obligāts. Vērtība, kuru konvertēt teksta reprezentācijā. Tiek izmantots noklusējuma formāts.

Text ( Dinamisks )

  • Dinamisks - obligāts. Dinamiskā vērtība, kas apzīmē virkni. Atkarīgās vērtības ir atkarīgas no netipa nodrošinātāja. Ja JSON dinamiskā vērtība ir skaitlis vai Būla vērtība, tā tiks pārvērsta 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
Text( 1234.59, "####.#" ) Formatē skaitli ar vienu decimāldaļas vietu. "1234.6"
Text( 8.9, "#.000" ) Ja nepieciešams, papildina skaitļa decimāldaļu ar nullēm pēc. "8.900"
Text( 0.631, "0.#" ) Ja nepieciešams, papildina visu skaitli ar nullēm pirms. "0.6"
Text( 12, "#.0#" )
Text( 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"
Text( 12000, "$ #,###" )
Text( 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
Text( Tagad(), DateTimeFormat.LongDate ) Formatē kā garu datuma virkni pašreizējā lietotāja valodā un lokalizācijā. "Pirmdiena, 2015. gada 23. novembris"
Text( Tagad(), 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"
Text( Tagad(), DateTimeFormat.LongTime24 ) Formatē kā garu laika virkni, izmantojot 24 stundu pulksteni. "14:37:47"
Text( Now(), DateTimeFormat.ShortDate ) Formatē kā īsu datuma virkni pašreizējā lietotāja valodā un lokalizācijā. "11/23/2015"
Text( Tagad(), "d-mmm-gg" ) Formāti, izmantojot viettura rakstzīmes:
  • d viencipara vai divciparu mēneša dienai
  • - kā burtisks raksturs, kas kopēts uz rezultātu
  • mmm mēneša trīs burtu saīsinājumam
  • - kā vēl viens burtisks raksturs, kas kopēts uz rezultātu
  • yy — gada divciparu saīsinājums
 "23-Nov-15"
Text(1448318857*1000, "mmm. dd, gggg (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. "2015. gada 23. novembris (02:47:37)"

Globālās programmas

Formula Apraksts Rezultāts
Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") Parāda atstarpi kā grupēšanas atdalītāju, komatu kā decimāldaļu atdalītāju un € kā valūtas simbolu. "1 234 567,89 €"
Text(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( Datums(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"
Text( Datums(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
Text( 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"
Text( 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. "04.01.2003. 12:00"
Text( patiess ) Konvertē Būla vērtību virknē. "true"
Text( GUID() ) Konvertē ģenerēto GUID vērtību virknē. "f8b10550-0f12-4f08-9aa3-bb10958bc3ff"
Pa kreisi( Text( GUID() ), 4 ) Atgriež ģenerētā GUID pirmās četras rakstzīmes. "2d9c"
  • Last updated on