Funktionen Text
Gælder for:
Lærredapps Formelkolonner Dataverse for lærredapps CLI Modelbaserede apps Power Pages Power Platform CLI
Konverterer værdier og formaterer et tal eller en dato/klokkeslætsværdi til en tekststreng.
Beskrivelse
Funktionen Text formaterer et tal eller en dato/klokkeslætsværdi, der er baseret på en af disse argumenttyper:
- Et foruddefineret dato/klokkeslætsformat, du angiver ved hjælp af optællingen DateTimeFormat. Denne fremgangsmåde foretrækkes til datoer og klokkeslæt, da den automatisk tilpasses de enkelte brugeres sprog og område.
- Et brugerdefineret format, som består af en streng af pladsholdere, der definerer, om tal viser decimalseparatoren og datoer, som f.eks. angiver månedens fulde navn, måned som en forkortelse eller måneden som et tal. Power Apps understøtter et delsæt af de pladsholdere, som Microsoft Excel gør. I denne streng angiver sprog-pladsholderen det sprog, de andre pladsholdere skal fortolkes på. Hvis det brugerdefinerede format indeholder et punktum, angives det f.eks., om den sprogformaterede pladsholder, der angiver, om perioden er decimalseparator (ja-JP) eller en tusindtalsseparator (es-ES).
Se Arbejde med datoer og klokkeslæt for at få flere oplysninger.
Funktionen Text kan også konvertere enhver datatype til en tekstrepræsentation ved hjælp af et standardformat. Brug denne funktion til at overføre ikke-tekstbaserede værdier til tekstbaserede funktioner, f.eks.Len, Right og IsMatch.
Foruddefinerede dato/klokkeslætsformater
I forbindelse med disse eksempler er dato og klokkeslæt tirsdag d. 7 2020 8:26:59.180 PM i tidszonen UTC-7 timer.
| DateTimeFormat-optælling | Beskrivelse | Eksempler (brug af en-US) |
|---|---|---|
| Lang dato | År med fire cifre, månedsnavn, dag i måneden og ugedag. Navnene på måneden og ugedag forkortes ikke. | "Tirsdag, 7. april, 2020" |
| LongDateTime | År med fire cifre, månedsnavn, dag i måneden og dag i ugen plus time (12-timers ur), minutter, sekunder og AM/PM-angivelse. Navnene på måneden og ugedag forkortes ikke. | "Tuesday, April 7, 2020 8:26:59 PM" |
| LongDateTime24 | År med fire cifre, måned, dag i måneden og dag i ugen plus time (24-timers ur), minutter og sekunder. Navnene på måneden og ugedag forkortes ikke. | "Tuesday, April 7, 2020 20:26:59" |
| Longtime | Time (12-timers ur), minutter, sekunder og AM/PM-angivelse. | "8:26:59 PM" |
| LongTime24 | Time (24-timers ur), minutter, sekunder. | "20:26:59" |
| ShortDate | Fircifret årstal med numerisk måned og dag i måneden. | "4/7/2020" |
| ShortDateTime | Fircifret år med numerisk måned, dag i måneden og ugedag plus time (12-timers ur), minutter, og AM/PM-angivelse. | "4/7/2020 8:26 PM" |
| ShortDateTime24 | Fircifret år med numerisk måned, dag i måneden og ugedag plus time (24-timers ur) og minutter. | "4/7/2020 20:26" |
| ShortTime | Time (12-timers ur), minutter og AM/PM-angivelse. | "8:26 PM" |
| ShortTime24 | Time (24-timers ur) og minutter. | "20:26" |
| UTC | Dato/klokkeslætsværdien konverteres til UTC på basis af den aktuelle brugers tidszone og formateres i henhold til ISO 8601-standarden. | "2020-04-08T03:26:59.180Z" |
Antal pladsholdere
| Pladsholder | Beskrivelse |
|---|---|
| 0 (nul) | Viser insignifikante nuller, hvis et tal har færre cifre, end der er nuller i formatet. Brug f.eks. formatet #.00, hvis du vil have vist 8,9 som 8,90. |
| # | Følger de samme regler som 0 (nul). Text returnerer imidlertid ikke ekstra nuller, når tallet har færre cifre på hver side af decimaltegnet, end der er #-symboler i formatet. 8,9 vises f.eks., hvis det brugerdefinerede format er #,##, og det tal, der skal formateres, er 8,9. |
| . (punktum) | Viser decimaltegnet i et tal. Afhænger af sproget i det brugerdefinerede format skal du se Globale apps for at få flere oplysninger. |
| , (komma) | Viser grupperingsseparatoren i et tal, der ofte bruges til tusinder. Tekst adskiller grupper med kommaer, hvis formatet indeholder et komma, der er omgivet af taltegn (#) eller nuller. Afhænger af sproget i det brugerdefinerede format skal du se Globale apps for at få flere oplysninger. |
Hvis et tal har flere cifre til højre for decimaltegnet, end der er pladsholdere i formatet, afrundes tallet til det antal decimalpladser, der er pladsholdere til. Hvis der er flere cifre til venstre for decimaltegnet, end der er pladsholdere, vises de overskydende cifre. Hvis formatet kun indeholder nummertegn (#) til venstre for decimaltegnet, starter tal, der er mindre end 1, med et decimaltegn (f.eks. ,47).
Pladsholdere for dato og klokkeslæt
| Pladsholder | Beskrivelse |
|---|---|
| m | Viser måneden som et tal uden et foranstillet nul. |
| Mm | Viser måneden som et tal med et foranstillet nul, hvor det er relevant. |
| Mmm | Viser måneden som en forkortelse (Jan til Dec). |
| Mmmm | Viser måneden som et fuldt navn (Januar til December). |
| d | Viser dagen som et tal uden et foranstillet nul. |
| Dd | Viser dagen som et tal med et foranstillet nul, hvor det er relevant. |
| Ddd | Viser dagen som en forkortelse (Søn til Lør). |
| dddd | Viser dagen som et fuldt navn (Søndag til Lørdag). |
| Åå | Viser året som et tocifret tal. |
| åååå | Viser året som et fircifret tal. |
| h | Viser timen som et tal uden et foranstillet nul. |
| Hh | Viser timen som et tal med et foranstillet nul, hvor det er relevant. Hvis formatet indeholder AM eller PM, vises timen på basis af 12-timers uret. Ellers vises timen på basis af 24-timers systemet. |
| m | Viser minuttet som et tal uden et foranstillet nul. Denne pladsholder skal angives umiddelbart efter koden h eller hh hh eller umiddelbart før koden ss ss, ellers returnerer Text måneden i stedet for minutter. |
| Mm | Viser minuttet som et tal med et foranstillet nul, hvor det er relevant. Denne pladsholder skal vises umiddelbart efter pladsholderen h eller hh eller umiddelbart før pladsholderen ss. Ellers returnerer Text måneden i stedet for minutter. |
| s | Viser sekundet som et tal uden et foranstillet nul. |
| ß | Viser sekundet som et tal med et foranstillet nul, hvor det er relevant. |
| f | Viser sekunder som brøkdele. |
| AM / PM, a / p | Viser timen på basis af et 12-timers ur. Tekst returnerer "AM" eller "a" for klokkeslæt fra midnat til middag og "PM" eller "p" for klokkeslæt fra kl. 12 til midnat |
Pladsholdere for konstantværdier
Du kan medtage et hvilket som helst af disse tegn i en formatstreng. De vises i resultatet af Text som de er. Ekstra tegn er reserveret til fremtidige pladsholdere, så du bør ikke bruge dem.
| Tegn | Beskrivelse |
|---|---|
| Et hvilket som helst valutasymbol | Dollartegn, centtegn, eurotegn osv. |
| + | Plustegn |
| ( | Venstre parentes |
| : | Kolon |
| ^ | Cirkumfleks |
| ' | Apostrof |
| { | Krøllet venstreparentes |
| < | Mindre end-tegn |
| = | Lighedstegn |
| - | Minustegn |
| / | Skråstreg |
| ) | Højre parentes |
| & | &-tegn |
| ~ | Tilde |
| } | Krøllet højreparentes |
| > | Større end-tegn |
| Mellemrumstegn |
Globale apps
Funktionen Text er følsom over for den geografiske placering. For en lang række sprog ved den, hvordan datoer, klokkeslæt, valutaer og tal skrives korrekt. Den skal have to oplysninger for at kunne det:
- Sproget i det brugerdefinerede format: Hvordan skal et brugerdefineret format fortolkes for udviklere? Separatortegnene (. og ,) har forskellige betydninger på forskellige sprog. Hvis du angiver et brugerdefineret format, kan du medtage en pladsholder for et sprog eller benytte standardværdien, som afspejler det sprog, enheden er indstillet til. Du kan også bruge et af de foruddefinerede dato- og klokkeslætsformater, som er sprogafhængige.
- Sproget i resultatet: Hvilket sprog skal funktionsresultatet vises på for brugerne? Navne på måneder og ugedage skal være på det relevante sprog for brugeren af appen, som du kan angive ved at tilføje et tredje, valgfrit argument til funktionen Text.
For begge skal du angive sproget vha. en sprogkode. Se listen over understøttede sprogtyper Text( 1234, "", ) i formelsøjlen eller fanen Avanceret i højre rude, og rul gennem listen over de landestandarder, der foreslås til det tredje argument.
Pladsholder for sprog
Hvis du vil angive sproget for det brugerdefinerede format, skal du bruge:
| Pladsholder | Beskrivelse |
|---|---|
| [$-SprogTag] | LanguageTag er et sprogmærke, der returneres fra funktionen Sprog . Den kan angive blot sproget, f.eks. [$-en] for engelsk, eller den kan også omfatte området, (som f.eks. [$-en-GB], der yderligere angiver Storbritannien). |
Sprogpladsholderen kan placeres overalt i det brugerdefinerede format, men kun én gang.
Hvis du angiver et brugerdefineret format uden en pladsholder for et sprog, og formatet ikke er entydigt i forhold til det globale udgangspunkt, indsættes den sprogkode, der bruges på det aktuelle sprog, automatisk.
[$-da-DK] antages, hvis denne pladsholder ikke findes, når din app køres.
Bemærk
I en kommende version ændres syntaksen muligvis for denne pladsholder for at undgå forveksling med en lignende, men anderledes, pladsholder, som Excel understøtter.
Resultatsprogkode
Resultatet af Text omfatter oversatte strenge for måneder, ugedage, og AM/PM-angivelser samt de relevante gruppe- og decimalseparatorer.
Text bruger som standard sproget for den bruger, der kører appen. Funktionen Language returnerer sprogkoden for den aktuelle bruger. Du kan tilsidesætte denne standardværdi ved at angive en sprogkode for det tredje argument til Text.
Syntaks
Tekst(NumberOrDateTime,DateTimeFormatEnum [, ResultLanguageTag ] )
- NumberOrDateTime – påkrævet. Tallet eller den dato/klokkeslætsværdi, der skal formateres.
- DateTimeFormat – Påkrævet. Et medlem af optællingen DateTimeFormat.
- ResultLanguageTag - Valgfrit. Den sprogkode, der skal bruges til resultatteksten. Som standard bruges den aktuelle brugers sprog.
Tekst(NumberOrDateTime,CustomFormat [, ResultLanguageTag ] )
- Antal - Påkrævet. Tallet eller den dato/klokkeslætsværdi, der skal formateres.
- CustomFormat – påkrævet. En eller flere pladsholdere omsluttet af dobbelte anførselstegn.
- ResultLanguageTag - Valgfrit. Den sprogkode, der skal bruges til resultatteksten. Som standard bruges den aktuelle brugers sprog.
Tekst( AnyValue )
- AnyValue - påkrævet. Værdi, der skal konverteres til en tekstrepræsentation. Der bruges et standardformat.
Tekst ( Ikke indtastet )
- Ikke indtastet - Påkrævet. objekt uden type , der repræsenterer en streng. Acceptable værdier afhænger af udbyderen af objektet uden type. Hvis det ikke-indtastede objekt i forbindelse med JSON er et tal eller en boolesk værdi, konverteres det til tekst.
Eksempler
Medmindre andet er angivet, befinder den bruger, der kører disse formler, sig i USA og har valgt engelsk som sprog. Funktionen Language returnerer "en-US".
Antal
| Formel | Beskrivelse | Resultat |
|---|---|---|
| Tekst( 1234.59, "####.#" ) | Formater tallet med én decimalplads. | "1234.6" |
| Tekst( 8.9, "#.000" ) | Udfylder om nødvendigt tallets decimaldel med efterstillede nuller. | "8.900" |
| Tekst( 0,631, "0.#" ) | Udfylder om nødvendigt tallets decimaldel med foranstillede nuller. | "0.6" |
| Tekst( 12, "#.0#" ) Tekst( 1234.568, "#.0#" ) |
Udfylder tallets decimaldel med nuller for én decimalplads og medtager en anden decimalplads, hvis angivet. | "12.0" "1234.57" |
| Tekst( 12000, "$ #,###" ) Tekst( 1200000, "$ #,###" ) |
Placerer en tusindtalsseparator for hvert tredje ciffer og medtager et valutasymbol. | "$ 12,000" "$ 1,200,000" |
Dato og klokkeslæt
- Kl. 2:37:47 PM mandag d. 23. november 2015
- USA Pacific Time (UTC-8)
| Formel | Beskrivelse | Resultat |
|---|---|---|
| Tekst( Nu(), DateTimeFormat.LongDate ) | Formater som en lang datostreng på/med den aktuelle brugers sprog og landestandard. | "Monday, November 23, 2015" |
| Tekst( Now(), DateTimeFormat.LongDateTime ) | Formateres som en lang dato/klokkeslætsstreng på/med den aktuelle brugers sprog og landestandard på basis af et 12-timers ur. | "Monday, November 23, 2015 2:37:47 PM" |
| Tekst( Now(), DateTimeFormat.LongTime24 ) | Formateres som en lang klokkeslætstreng på basis af et 24-timers ur. | "14:37:47" |
| Tekst( Now(), DateTimeFormat.ShortDate ) | Formateres som en kort datostreng på/med den aktuelle brugers sprog og landestandard. | "11/23/2015" |
| Tekst( Now(), "d-mmm-yy" ) | Formateres ved hjælp af pladsholdertegn:
|
"23-Nov-15" |
| Tekst(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") | Viser en UNIX-dato/klokkeslætsværdi i formatet, der kan læses af mennesker, hvis du multiplicerer kildeværdien med 1.000. | "Nov. 23, 2015 (02:47:37 PM)" |
Globale apps
| Formel | Beskrivelse | Resultat |
|---|---|---|
| Tekst(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") | Viser et mellemrum som en grupperingsseparator, kommaet som en decimalseparator og € som valutasymbol. | "1 234 567,89 €" |
| Tekst(1234567,89; "[$-fr-FR]# ###,## €") | Hvis kildedataene følger den franske praksis med at bruge semikolon som decimalseparator, skal du ændre landestandarden til fransk og adskille argumenterne med et semikolon i stedet for et komma for at opnå samme resultat som ovenfor. | "1 234 567,89 €" |
| Tekst ( Dato (2016,1,31), "dddd mmmm d" ) | Returnerer ugedagen, måneden og dagen i måneden på den aktuelle brugers sprog. Da ingen af pladsholderne er sprogafhængige, er der ingen grund til at bruge en sprogkode til formatering af teksten. | "Søndag den 31. januar" |
| Tekst ( Dato (2016,1,31), "dddd mmmm d", "es-ES" ) | Returnerer ugedagen, måneden og dagen i måneden på sproget "es-ES". | "domingo enero 31" |
Konvertere værdier til tekst
| Formel | Beskrivelse | Resultat |
|---|---|---|
| Tekst( 1234567.89 ) | Konverterer et tal til en streng. Der er ingen tusindtalsseparator eller kontrol over antallet af cifre før eller efter decimalseparatoren. Du kan få mere kontrol ved at angive talpladsholdere som det andet argument. | "1234567.89" |
| Text( DateTimeValue( "01/04/2003" ) ) | Konverterer en dato/klokkeslætsværdi til en tekststreng. Hvis du vil styre konverteringen, skal du angive et medlem af DateTimeFormat-optællingen eller en streng med brugerdefineret format. | "1/4/2003 12:00 AM" |
| Tekst( true ) | Konverterer en boolesk værdi til en streng. | "sand" |
| Tekst( GUID() ) | Konverterer en genereret GUID-værdi til en streng. | "f8b10550-0f12-4f08-9aa3-bb10958bc3ff" |
| Venstre( Tekst( GUID() ), 4 ) | Returnerer de første fire tegn i et oprettet GUID. | "2d9c" |