Funktionen Text

  • Artikel

Gäller: Arbetsyteappar Arbetsyteappar Dataverse formelkolumner Modellbaserade appar Power Platform CLI

Konverterar ett värde och formaterar ett tal eller ett datum/tid-värde till en textsträng.

Beskrivning

Text-funktionen formaterar ett tal eller ett Date/Time-värde utifrån någon av följande argumenttyper:

  • Ett fördefinierat datum/tidsformat som du anger genom att använda DateTimeFormat-uppräkningen. När det gäller datum och tider prioriteras den här metoden eftersom den automatiskt anpassar sig till respektive användares språk och region.
  • Ett anpassat format som består av en sträng med platshållare som anger t.ex. om tal ska visa en decimalavgränsare och datum visar månadens fullständiga namn, månaden som en förkortning eller månaden som ett tal. Power Apps stöder en delmängd av platshållarna som Microsoft Excel gör. I den här strängen anger språkets platshållare vilket språk som de andra platshållarna ska tolkas på. Om det anpassade formatet innehåller en punkt är platshållaren för språkformat som anger om perioden är en decimal avgränsare (ja-JP) eller en tusentals avgränsare (es-ES).

Mer information finns i Arbeta med datum och tid.

Funktionen Text kan även konvertera valfri datatyp till en textåtergivning med ett standardformat. Använd den här om du vill skicka värden som inte är text till textbaserade funktioner som till exempel Len, Right och IsMatch.

Fördefinierade datum/tidsformat

För dessa exempel gäller datum och tid tisdagen den 7 april 2020 20:26:59.180, i tidszonen UTC-7 timmar.

DateTimeFormat enum Beskrivning Exempel (med en-US)
LongDate Fyrsiffrigt år, månadsnamn, dag i månaden och veckodag. Månadsnamn och veckodagar förkortas inte. "Tisdagen den 7 april 2020"
LongDateTime Fyrsiffrigt år, månadsnamn, dag i månaden och veckodag, plus timma (12-timmarsformat), minuter, sekunder och tidsbeteckning. Månadsnamn och veckodagar förkortas inte. "Tisdagen den 7 april 2020 20:26:59"
LongDateTime24 Fyrsiffrigt år, månad, dag i månaden och veckodag, plus timma (24-timmarsformat), minuter och sekunder. Månadsnamn och veckodagar förkortas inte. "Tisdagen den 7 april 2020 20:26:59"
LongTime Timma (12-timmarsformat), minuter, sekunder och tidsbeteckning. "20:26:59"
LongTime24 Timma (24-timmarsklocka) minuter, sekunder. "20:26:59"
ShortDate Fyrsiffrigt år med numerisk månad och dag i månaden. "2020-4-7"
ShortDateTime Fyrsiffrigt år med numerisk månad och dag i månaden, plus timma (12-timmarsformat), minuter och tidsbeteckning. "2020-4-7 20:26"
ShortDateTime24 Fyrsiffrigt år med numerisk månad och dag i månaden, plus timma (24-timmarsformat) och minuter. "2020-4-7 20:26"
ShortTime Timma (12-timmarsformat), minuter och tidsbeteckning. "20:26"
ShortTime24 Timma (24-timmarsklocka) och minuter. "20:26"
UTC Date/Time-värdena konverteras till UTC utifrån den aktuella användarens tidszon och formateras enligt ISO 8601-standarden. "2020-04-08T03:26:59.180Z"

Antal platshållare

Platshållare Beskrivning
0 (noll) Visar nollor utan betydelse om ett tal har färre siffror än det finns nollor i formatet. Använd t.ex. formatet #.00 om du vill visa 8,9 som 8,90.
# Följer samma regler som 0 (noll). Text returnerar dock inte extra nollor när talet har färre siffror på endera sidan av decimaltecknet än vad det finns #-symboler i formatet. 8,9 visas t.ex. om det anpassade formatet är #. ## och det tal som ska formateras är 8,9.
. (period) Visar decimaltecknet i ett tal. Beror på det anpassade formatets språk. Mer information finns i Globala program.
, (komma) Visar grupperingsavgränsaren i ett tal. Används ofta för tusentalsavgränsare. Text skiljer grupper åt med kommatecken om formatet innehåller ett kommatecken omgivet av siffror (#) eller nollor. Beror på det anpassade formatets språk. Mer information finns i Globala program.

Om ett tal har fler siffror till höger om decimaltecknet än det finns platshållare i formatet, så avrundas talet till så många decimaler som det finns platshållare för. Om det finns fler siffror till vänster om decimaltecknet än det finns platshållare, så visas de extra siffrorna. Om formatet enbart innehåller siffertecken (#) till vänster om decimaltecknet, så börjar tal som är mindre än 1 med ett decimaltecken. Exempel: .47.

Platshållare för datum och tid

Platshållare Beskrivning
m Månaden visas som ett tal utan inledande nolla.
mm Månaden visas som ett tal med en inledande nolla när så är lämpligt.
mmm Månaden visas som en förkortning (Jan till Dec).
mmmm Månaden visas som ett fullständigt namn (januari till december).
d Dagen visas som ett tal utan inledande nolla.
dd Dagen visas som ett tal med en inledande nolla när så är lämpligt.
ddd Visar dagen som en förkortning (Sun till Sat).
dddd Visar dagen fullständiga namn (Sunday till Saturday).
åå Visar året med två siffror.
åååå Visar året med fyra siffror.
h Visar timman som ett tal utan inledande nolla.
hh Timman visas som ett tal med en inledande nolla när så är lämpligt. Om formatet innehåller AM eller PM visas timman utifrån 12-timmarsklockan. I annat fall visas timman utifrån 24-timmarsformatet.
m Minuten visas som ett tal utan inledande nolla.

Denna platshållare måste visas omedelbart efter h eller hh-koden måste visas direkt efter ss, annars returnerar Text månaden istället för minuter.
mm Minuten visas som ett tal med en inledande nolla när så är lämpligt.

Denna platshållare måste visas omedelbart efter h eller hh-platshållaren eller omedelbart före ss-platshållaren. I annat fall returnerar Text månaden istället för minuter.
s Sekunden visas som ett tal utan inledande nolla.
ss Sekunden visas som ett tal med en inledande nolla när så är lämpligt.
f Visar fraktioner av sekunder.
AM/PM, a/p Visar timman utifrån en 12-timmarsklocka. Text returnerar "AM" eller "a" för tider från midnatt fram till lunchtid, och "PM" eller "p" för tider från tolv på dagen till midnatt

Literal platshållare

Du kan inkludera vilket som helst av dessa tecken i din formatsträng. De visas som de är i resultatet för Text. Ytterligare tecken är reserverade för framtida platshållare, så du bör inte använda dem.

Tecken Beskrivning
Vilken valutasymbol som helst Dollartecken, centtecken, eurotecken osv.
+ Plustecken
( Vänsterparentes
: Kolon
^ Cirkumflex linje (hatt)
' Apostrof
{ Vänster klammer
< Mindre än-tecken
= Lika med-tecken
- Minustecken
/ Snedstreck
) Högerparentes
& Et-tecken
~ Tilde
} Höger klammer
> Större än-tecken
  Blanksteg

Globala program

Textfunktionen är globalt medveten. Den kan skriva ut datum, tid, valutor och siffror i korrekt format för en mängd olika språk. För att klara av detta jobb måste den ha två typer av information:

  • Det anpassade formatets språk: Hur ska ett anpassat format tolkas för tillverkare? Avgränsningstecknen (. och ,) har olika funktioner på olika språk. Om du anger ett eget format kan du lägga till en platshållare för språk eller ange standardvärdet, vilket motsvarar det språk som enheten är inställd på. Du kan ännu enklare använda ett av de fördefinierade datum- och tidsformaten, som är språkoberoende.
  • Resultatets språk: För användare, på vilket språk ska funktionens resultatet visas? Namn på månader och veckodagar måste vara på lämpligt språk för användare av programmet, som du kan ange genom att lägga till ett tredje, valfritt argument i funktionen Text.

För båda anger du språket med hjälp av en språkkod. Om du vill se en lista över vilka språk som stöds så skriv Text( 1234, "", ) i formelfältet eller på fliken avancerad i det högra fönstret. Bläddra igenom listan över föreslagna platser som föreslås för det tredje argumentet.

Språkplatshållare

Om du vill ange språket för det anpassade formatet använder du:

Platshållare Beskrivning
[$-LanguageTag] LanguageTag är en språktagg som returneras från funktionen Language. Den kan ange enbart själva språket (t.ex. [$-en] för engelska) eller så kan den ange regionen (t.ex. [$-en-GB] som specificerar Storbritannien).

Språkplatshållaren kan visas var som helst i det anpassade formatet, men bara en gång.

Om du anger ett eget format utan språkplatshållare och formatet är tvetydigt från global synpunkt infogas språkkoden för det aktuella språket automatiskt.

[$-en-US] väljs automatiskt om platshållare saknas när programmet körs.

Kommentar

I kommande versioner kan syntaxen för platshållaren komma att ändras för att undvika förvirring med liknande, men olika, platshållare som stöds av Excel.

Resultatspråktagg

I resultatet för Text finns översatta strängar för månader, veckodagar och tidsbeteckning, liksom lämplig grupp och decimaltecken.

Som standard Text använder som standard samma språk som programmets användare. Funktionen Language returnerar språktaggen för den aktuella användaren. Du kan åsidosätta den här standardvärdet genom att tillhandahålla en språktagg för det tredje argumentet för Text.

Syntax

Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )

  • NumberOrDateTime – krävs. Det tal eller för Date/Time-värde som ska formateras.
  • DateTimeFormat – krävs. En medlem av DateTimeFormat-uppräkningen.
  • ResultLanguageTag – valfritt. Den språktagg som ska användas för restultattexten. Som standard används den aktuella användarens språk.

Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )

  • Number – obligatoriskt. Det tal eller för Date/Time-värde som ska formateras.
  • CustomFormat – obligatoriskt. En eller flera platshållare omgivna av dubbla citattecken.
  • ResultLanguageTag – valfritt. Den språktagg som ska användas för restultattexten. Som standard används den aktuella användarens språk.

Text( AnyValue )

  • AnyValue – krävs. Värde som ska konverteras till en textrepresentation. Standardformatet används.

Text ( Utan typ )

  • Utan typ – Obligatoriskt. Objekt utan angiven typ som representerar en sträng. Acceptabla värden är beroende av leverantören utan angiven typ. För JSON om det typlösa objektet är ett nummer eller boolesk konverteras det till text.

Exempel

Om inget annat anges finns användaren som kör dessa formler i USA och har valt engelska som sitt språk. Funktionen Language returnerar "en-US".

Antal

Formel Beskrivning Resultat
Text( 1234.59, "####.#" ) Formaterar talet med en decimal. "1234.6"
Text( 8.9, "#.000" ) Fyller ut talets decimaldel med efterföljande nollor, om så behövs. "8.900"
Text( 0.631, "0.#" ) Fyller ut talets heltalsdel med inledande nollor, om så behövs. "0.6"
Text( 12, "#.0#" )
Text( 1234.568, "#.0#" )		 Fyller ut talets decimaldel med nollor för en decimal, och inkluderar en andra decimal om sådan anges. "12.0"
"1234.57"
Text( 12000, "$ #,###" )
Text( 1200000, "$ #,###" )		 Placerar en tusentalsavgränsare efter var tredje siffra, och inkluderar en valutasymbol. "$ 12,000"
"$ 1,200,000"

Datum/tid

  • Kl. 2:37:47 PM, måndag 23 november 2015
  • United States Pacific Time Zone (UTC-8)
Formel Beskrivning Resultat
Text (Now(), DateTimeFormat.LongDate) Formateras som en lång datumsträng på den aktuella användarens språk och nationella inställningar. "Måndag, 23 november 2015"
Text (Now(), DateTimeFormat.LongDateTime) Formateras som en lång datum- och tidssträng på den aktuella användarens språk och nationella inställningar, och med en 12-timmarsformat. "Måndag, 23 november 2015 2:37:47 PM"
Text (Now(), DateTimeFormat.LongTime24) Formateras som en lång tidssträng i 24-timmarsformat. "14:37:47"
Text (Now(), DateTimeFormat.ShortDate) Formateras som en kort datumsträng på den aktuella användarens språk och nationella inställningar. "2015-11-23"
Text( Now(), "d-mmm-yy" ) Format som använder platshållartecken:
  • d för en en- eller tvåsiffrig dag i månaden
  • - som ett enkelt tecken kopierat till resultatet
  • mmm för en trebokstavsförkortning av månaden
  • - som ett annat enkelt tecken kopierat till resultatet
  • yy för en tvåsiffrig förkortning av året
 "23-nov-15"
Text(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") Visar ett Unix-datum-/tidsvärde i läsbart format om du multiplicerar källobjektet med 1 000. "Nov. 23, 2015 (02:47:37 PM)"

Globala program

Formel Beskrivning Resultat
Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") Visar ett blanksteg som en grupp avgränsare, komma som decimaltecken och € som valutasymbol. "1 234 567,89 €"
Text(1234567,89; "[$-fr-FR]# ###,## €") Om källinformationen följer den franska anpassade delen av att använda ett komma som decimaltecken måste du ändra språket till franska och åtskilja argumenten med ett semikolon i stället för ett kommatecken för att uppnå samma resultat som ovan. "1 234 567,89 €"
Text( Date(2016,1,31), "dddd mmmm d" ) Returnerar veckodag, månad och dagen i månaden på den aktuella användarens språk. Eftersom ingen av platshållarna är språkberoende behövs det inte någon språktagg för formattexten. "Sunday January 31"
Text (Date(2016,1,31), "dddd mmmm d", "es-ES") Returnerar veckodag, månad och dagen i månaden på språket "es-ES". "domingo enero 31"

Konvertera värden till text

Formel Beskrivning Resultat
Text( 1234567.89 ) Konverterar ett tal till en sträng. Det finns inga tusentals avgränsare eller kontroll över antalet siffror före eller efter decimaltecknet. Om du vill ha mer kontroll anger du platshållare för telefonnummer som det andra argumentet. "1234567.89"
Text( DateTimeValue( "01/04/2003" ) ) Konverterar ett datum/tid-värde till en textsträng. Om du vill kontrollera konverteringen anger du antingen en medlem av uppräkningen DateTimeFormat eller en sträng med anpassade format. "1/4/2003 12:00 AM"
Text( true ) Konverterar ett booleskt värde till en sträng. "true"
Text( GUID() ) Konverterar ett genererat GUID-värde till en sträng. "f8b10550-0f12-4f08-9aa3-bb10958bc3ff"
Left( Text( GUID() ), 4 ) Returnerar de första fyra tecknen i ett genererat GUID. "2d9c"