Dela via

funktion Text

Gäller för: Arbetsyteappar Copilot Studio Desktop-flöden Dataverse-formelkolumner Modelldrivna appar Power Platform CLI Dataverse-funktioner Power Pages

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

Beskrivning

Funktionen Text formaterar ett tal eller ett datum/tid-värde baserat på någon av dessa typer av argument:

  • 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 också konvertera alla datatyper till en textrepresentation 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-uppräkning Beskrivning Exempel (med en-US)
LångDatum Fyrsiffrigt år, månadsnamn, dag i månaden och veckodag. Månadsnamn och veckodagar förkortas inte. "Tisdagen den 7 april 2020"
LongDateTime (på engelska) 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"
Lång tid Timma (12-timmarsformat), minuter, sekunder och tidsbeteckning. "20:26:59"
LongTime24 Timma (24-timmarsklocka) minuter, sekunder. "20:26:59"
Kortdags datum Fyrsiffrigt år med numerisk månad och dag i månaden. "2020-4-7"
ShortDateTime (KortDateTime) 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"
Korttid 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). Returnerar dock Text inte extra nollor när talet har färre siffror på vardera sidan av decimaltecknet än om 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.
, (kommatecken) Visar grupperingsavgränsaren i ett tal. Används ofta för tusentalsavgränsare. Text separerar grupper med kommatecken om formatet innehåller ett kommatecken som omges av taltecken (#) eller med 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).
yy Visar året med två siffror.
yyyy 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.

Den här platshållaren måste visas omedelbart efter h - eller hh-koden eller omedelbart före ss-koden . annars Text returnerar månaden i stä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. Annars Text returneras månaden i stä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 till 12:00 och "PM" eller "p" för tider från 12:00 till midnatt

Literal platshållare

Du kan inkludera vilket som helst av dessa tecken i din formatsträng. De visas i resultatet av Text som det är. 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

Funktionen Text ä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:

  • Språket för det anpassade formatet: 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.
  • Språket för resultatet: På vilket språk ska funktionsresultatet visas för användare? Namnen på månader och vardagar måste vara på rätt språk för appens användare, vilket du kan ange genom att lägga till ett tredje, valfritt argument i Text funktionen.

För båda anger du språket med hjälp av en språkkod. Om du vill se listan över språk som stöds skriver du Text( 1234, "", ) i formelfältet eller fliken Avancerat i den högra rutan och bläddrar sedan igenom listan med nationella inställningar 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 Språk . 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] antas om den här platshållaren inte finns när appen 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

Resultatet av Text inkluderar översatta strängar för månader, vardagar och AM/PM-beteckningar, samt lämpliga grupp- och decimalavgränsare.

Som standard Text använder språket för användaren som kör appen. Funktionen Language returnerar språktaggen för den aktuella användaren. Du kan åsidosätta det här standardvärdet genom att ange en språktagg för det tredje argumentet till Text.

Syntax

Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )

  • NumberOrDateTime – Obligatoriskt. Det tal eller för Date/Time-värde som ska formateras.
  • DateTimeFormat – obligatoriskt. 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 ] )

  • Nummer – 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 – Obligatoriskt. Värde som ska konverteras till en textrepresentation. Standardformatet används.

Text( Dynamisk )

  • Dynamisk – obligatoriskt. Dynamiskt värde som representerar en sträng. Acceptabla värden är beroende av leverantören utan angiven typ. För JSON konverteras det till text om det dynamiska värdet är ett tal eller booleskt värde.

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 ensiffrig eller tvåsiffrig dag i månaden
  • - som ett literalt tecken som kopieras till resultatet
  • mmm för en förkortning av månaden med tre bokstäver
  • - som ett annat litteralt tecken som kopieras till resultatet
  • yy för en tvåsiffrig förkortning av året
 "23-nov-15"
Text(1448318857*1000, "mmm. dd, åååå (hh:mm:ss AM/PM)") Visar ett Unix-datum-/tidsvärde i läsbart format om du multiplicerar källobjektet med 1 000. "23 november 2015 (02:47:37)"

Globala program

Formel Beskrivning Resultat
Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") Visar ett blanksteg som en grupperingsavgränsare, kommatecknet som ett 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. "Söndag 31 januari"
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. "2003-01-04 12:00"
Text(sant) 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"
  • Last updated on