Text-funksjon
Gjelder:
Lerretsapper Lerretsapper Dataverse-formelkolonner Modelldrevne apper Power Platform CLI
Konverterer en hvilken som helst verdi og formaterer et tall eller en verdi for dato/klokkeslett til en tekststreng.
Beskrivelse
Text-funksjonen formaterer et tall eller en verdi for dato/klokkeslett som er basert på én av disse typene argumenter:
- Et forhåndsdefinert dato/klokkeslett-format, som du angir ved hjelp av opplistingen for DateTimeFormat. Denne fremgangsmåten foretrekkes for datoer og klokkeslett, da den automatisk justeres til hver brukers språk og område.
- Et egendefinert format som består av en streng med plassholdere som definerer for eksempel om tall viser desimalskilletegn og datoer viser det fullstendige navnet på måneden, måneden som en forkortelse eller måneden som et tall. Power Apps støtter et delsett av plassholderne som Microsoft Excel støtter. I denne strengen angir plassholderen for språk hvilket språk de andre plassholderne skal tolkes på. Hvis det egendefinerte formatet inneholder et punktum, angir for eksempel plassholderen for språkformat om perioden er et desimalskilletegn (ja-JP) eller et tusenskilletegn (es-ES).
Hvis du vil ha mer informasjon, kan du se arbeide med datoer og klokkeslett.
Text-funksjonen kan også konvertere en hvilken som helst datatype til en tekstrepresentasjon ved hjelp av et standardformat. Bruk denne til å sende ikke-tekstverdier til tekstbaserte funksjoner, for eksempel Len, Right og IsMatch.
Forhåndsdefinerte formater for dato/klokkeslett
I disse eksemplene er dato og klokkeslett tirsdag 7. april 2020 8:26:59.180 PM, i tidssonen UTC-7 timer.
| DateTimeFormat-opplisting | Beskrivelse | Eksempler (ved hjelp av en-US) |
|---|---|---|
| LongDate | Firesifret år, månedsnavn, dag i måneden og dagen i uken. Navnet på måneden og dagen i uken forkortes ikke. | "Tirsdag 7. april 2020" |
| LongDateTime | Firesifret år, månedsnavn, dag i måneden og dag i uken, pluss time (12-timers klokke), minutter, sekunder og AM/PM-betegnelse. Navnet på måneden og dagen i uken forkortes ikke. | "Tirsdag 7. april 2020 8:26:59 PM" |
| LongDateTime24 | Firesifret år, måned, dag i måneden og dag i uken, pluss time (24-timers klokke), minutter og sekunder. Navnet på måneden og dagen i uken forkortes ikke. | "Tirsdag 7. april 2020 20:26:59" |
| LongTime | Time (12-timers klokke), minutter, sekunder og AM/PM-betegnelse. | "8:26:59 PM" |
| LongTime24 | Time (24-timers klokke), minutter og sekunder. | "20:26:59" |
| ShortDate | Firesifret år med numerisk måned og dag i måneden. | "4/7/2020" |
| ShortDateTime | Firesifret år med numerisk måned og dag i måneden, pluss time (12-timers klokke), minutter og AM/PM-betegnelse. | "4/7/2020 8:26 PM" |
| ShortDateTime24 | Firesifret år med numerisk måned og dag i måneden, pluss time (24-timers klokke) og minutter. | "4/7/2020 20:26" |
| ShortTime | Time (12-timers klokke), minutter og AM/PM-betegnelse. | "8:26 PM" |
| ShortTime24 | Time (24-timers klokke) og minutter. | "20:26" |
| UTC | Verdien for dato/klokkeslett konverteres til UTC basert på tidssonen til den gjeldende brukeren, og blir formatert i henhold til ISO 8601-standarden. | "2020-04-08T03:26:59.180Z" |
Plassholdere for tall
| Plassholder | Beskrivelse |
|---|---|
| 0 (null) | Viser ubetydelige nuller hvis et tall har færre sifre enn det er nuller i formatet. For eksempel kan du bruke formatet #,00 hvis du vil vise 8,9 som 8,90. |
| # | Følger de samme reglene som 0 (null). Text returnerer imidlertid ikke ekstra nuller når tallet har færre sifre på hver side av desimaltegnet enn det er #-symboler i formatet. For eksempel vises 8,9 hvis det egendefinerte formatet er #,## og tallet som skal formateres, er 8,9. |
| . (punktum) | Viser desimaltegnet i et tall. Avhengig av språket til det egendefinerte formatet, se globale apper for mer informasjon. |
| , (komma) | Viser skilletegnet for grupperinger i et tall, som ofte brukes for tusener. Text skiller grupper med komma hvis formatet inneholder et komma som er omsluttet av nummertegn (#) eller av nuller. Avhengig av språket til det egendefinerte formatet, se globale apper for mer informasjon. |
Tallet blir avrundet til så mange desimaler som det er plassholdere hvis et tall har flere sifre til høyre for desimaltegnet enn det er plassholdere i formatet. De ekstra sifrene vises hvis det er flere sifre til venstre for desimaltegnet enn det er plassholdere. Tall som er mindre enn 1, starter med et desimaltegn (for eksempel ,47) hvis formatet bare inneholder nummertegn (#) til venstre for desimaltegnet.
Plassholdere for dato og klokkeslett
| Plassholder | Beskrivelse |
|---|---|
| m | Viser måneden som et tall uten foranstilt null. |
| mm | Viser måneden som et tall med foranstilt null når det passer. |
| mmm | Viser måneden som en forkortelse (jan. til des.). |
| mmmm | Viser måneden med fullt navn (januar til desember). |
| d | Viser dagen som et tall uten foranstilt null. |
| dd | Viser dagen som et tall med foranstilt null når det passer. |
| ddd | Viser dagen som en forkortelse (sø. til lø.). |
| dddd | Viser dagen med fullt navn (søndag til lørdag). |
| åå | Viser året som et tosifret tall. |
| åååå | Viser året som et firesifret tall. |
| t | Viser timen som et tall uten foranstilt null. |
| hh | Viser timen som et tall med foranstilt null når det passer. Hvis formatet inneholder AM eller PM, blir timen vist basert på 12-timersklokken. Ellers vises timen basert på 24-timersklokken. |
| m | Viser minuttet som et tall uten foranstilt null. Denne plassholderen må vises umiddelbart etter h- eller hh-koden, eller rett før ss-koden, hvis ikke returnerer Text måneden i stedet for minutter. |
| mm | Viser minuttet som et tall med foranstilt null når det passer. Denne plassholderen må stå umiddelbart etter h- eller hh-plassholderen eller umiddelbart foran ss-plassholderen. Ellers returnerer Text måneden i stedet for minutter. |
| s | Viser sekundet som et tall uten foranstilt null. |
| ss | Viser sekundet som et tall med foranstilt null når det passer. |
| f | Viser deler av sekunder. |
| AM/PM, a/p | Viser timen basert på en 12-timersklokke. Text returnerer "AM" eller "a" for klokkeslett fra midnatt til midt på dagen og "PM" eller "p" for klokkeslett fra midt på dagen frem til midnatt |
Litterale plassholdere
Du kan inkludere hvilke som helst av disse tegnene i formatstrengen. De vil vises i resultatet av Text i nåværende tilstand. Ekstra tegn er reservert for fremtidige plassholdere, så du bør ikke bruke dem.
| Tegn | Beskrivelse |
|---|---|
| Alle valutasymboler | Dollartegn, centtegn, eurotegn og så videre. |
| + | Plusstegn |
| ( | Venstre parentes |
| : | Kolon |
| ^ | Circumflekstegn |
| ' | Apostrof |
| { | Venstre klammeparentes |
| < | Mindre enn-tegn |
| = | Likhetstegn |
| - | Minustegn |
| / | Skråstrek |
| ) | Høyre parentes |
| & | Ampersand (og-tegn) |
| ~ | Tilde |
| } | Høyre klammeparentes |
| > | Større enn-tegn |
| Mellomromstegn |
Globale apper
Text-funksjonen er globalavhengig. Den vet hvordan det skal skrives ut datoer, klokkeslett, valuta og tall for en lang rekke språk. Den er avhengig av to typer informasjon for å fungere:
- Språket for det egendefinerte formatet: Hvordan skal et egendefinert format tolkes av opprettere? Skilletegnene (. og ,) har ulike betydninger på forskjellige språk. Hvis du angir et egendefinert format, kan du inkludere en plassholder for språk eller ta med standardverdien, som gjenspeiler språket enheten er angitt for. Du kan også bruke et av de forhåndsdefinerte formatene for dato/klokkeslett, som er språkagnostiske.
- Språket for resultatet: Hvilket språk bør funksjonsresultatet vises på for brukere? Navn på måneder og ukedager må være på det riktige språket for brukeren av appen, som du kan angi ved å legge til et tredje, valgfritt argument i Text-funksjonen.
For begge kan du angi språket ved hjelp av en språkkode. Hvis du vil se listen over støttede språk, kan du skrive inn Text( 1234, "", ) i formellinjen eller kategorien Avansert på høyre side og deretter bla gjennom listen over nasjonale innstillinger for det tredje argumentet.
Plassholder for språk
Hvis du vil angi språket for det egendefinerte formatet, kan du bruke:
| Plassholder | Beskrivelse |
|---|---|
| [$-LanguageTag] | LanguageTag er en språkkode som returneres fra Language-funksjonen. Den kan angi bare språket (for eksempel [$-en] for engelsk), eller den kan også angi området (for eksempel [$-en-GB] for ytterligere å spesifisere Storbritannia). |
Plassholderen for språk kan forekomme hvor som helst i det egendefinerte formatet, men bare én gang.
Hvis du angir et egendefinert format uten en plassholder for språk, og formatet er tvetydig fra et globalt standpunkt, settes språkkoden for gjeldende språk inn automatisk.
[$-en-US] antas hvis plassholderen ikke er til stede når appen kjøres.
Obs!
Syntaksen for denne plassholderen kan endres for å unngå forvirring med en lignende, men forskjellig, plassholder som støttes av Excel i en fremtidig versjon.
Språkkode for resultatet
Resultatet av Text inkluderer oversatte strenger for måned, ukedager og angivelser av AM/PM samt passende gruppe og desimalskilletegn.
Text bruker som standard språket for brukeren som kjører appen. Language-funksjonen returnerer språkkoden for gjeldende bruker. Du kan overstyre denne standardverdien ved å oppgi en språkkode for det tredje argumentet for Text.
Syntaks
Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )
- NumberOrDateTime – obligatorisk. Tallet eller dato/klokkeslett-verdien som skal formateres.
- DateTimeFormat – obligatorisk. Et medlem av opplistingen for DateTimeFormat.
- ResultLanguageTag – valgfritt. Språkkoden som skal brukes for resultatteksten. Språket for gjeldende bruker brukes som standard.
Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )
- Nummer – obligatorisk. Tallet eller dato/klokkeslett-verdien som skal formateres.
- CustomFormat – obligatorisk. Én eller flere plassholdere omsluttet av doble anførselstegn.
- ResultLanguageTag – valgfritt. Språkkoden som skal brukes for resultatteksten. Språket for gjeldende bruker brukes som standard.
Text( AnyValue )
- AnyValue – obligatorisk. Verdi som skal konverteres til en tekstrepresentasjon. Et standardformat brukes.
Text ( Untyped )
- Untyped - v. Objekt uten type som representerer et streng. Godkjente verdier er avhengig av leverandøren uten type. Hvis det typeløse objektet for JSON er et tall eller boolsk, konverteres det til tekst.
Eksempler
Brukeren som kjører disse formlene befinner seg i USA og har valgt engelsk som språket sitt, hvis ikke annet er angitt. Language-funksjonen returnerer en-US.
Antall
| Formel | Beskrivelse | Resultat |
|---|---|---|
| Text( 1234.59, "####.#" ) | Formaterer tallet med én desimal. | "1234.6" |
| Text( 8.9, "#.000" ) | Fyller ut tallets desimaldel med etterfølgende nuller, om nødvendig. | "8.900" |
| Text( 0.631, "0.#" ) | Fyller ut tallets heltallsdel med foranstilte nuller, om nødvendig. | "0.6" |
| Text( 12, "#.0#" ) Text( 1234.568, "#.0#" ) |
Fyller ut tallets desimaldel med nuller for én desimalplass, og inkluderer en desimal nummer to hvis dette er angitt. | "12.0" "1234.57" |
| Text( 12000, "$ #,###" ) Text( 1200000, "$ #,###" ) |
Plasserer et skilletegn for tusener for hvert tredje siffer, og inkluderer et valutasymbol. | "$ 12,000" "$ 1,200,000" |
Dato/klokkeslett
- Kl. 2:37:47 PM, mandag 23. november 2015
- Tidssonen for USA (UTC-8)
| Formel | Beskrivelse | Resultat |
|---|---|---|
| Text( Now(), DateTimeFormat.LongDate ) | Formateres som en lang datostreng i språk og nasjonale innstillinger for gjeldende bruker. | "Mandag 23. november 2015" |
| Text( Now(), DateTimeFormat.LongDateTime ) | Formateres som en lang dato- og klokkeslettstreng i språk og nasjonale innstillinger for gjeldende bruker ved bruk av en 12-timers klokke. | "Mandag 23. november 2015 2:37:47 PM" |
| Text( Now(), DateTimeFormat.LongTime24 ) | Formateres som en lang tidsstreng med 24-timers klokke. | "14:37:47" |
| Text( Now(), DateTimeFormat.ShortDate ) | Formateres som en kort datostreng med språk og nasjonale innstillinger for gjeldende bruker. | "11/23/2015" |
| Text( Now(), "d-mmm-yy" ) | Formateres ved hjelp av plassholdertegn:
|
"23-Nov-15" |
| Text(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") | Viser en UNIX-dato/klokkeslett-verdi i et lesbart format hvis du multipliserer kildeverdien med 1 000. | "Nov. 23, 2015 (02:47:37 PM)" |
Globale apper
| Formel | Bekrivelse | Result |
|---|---|---|
| Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") | Viser et mellomrom som et grupperingsskilletegn, komma som desimalskilletegn og € som valutasymbol. | "1 234 567,89 €" |
| Text(1234567,89; "[$-fr-FR]# ###,## €") | Hvis kildedataene følger den franske egendefinerte bruken av komma som desimalskilletegn, må du endre de nasjonale innstillingene til fransk og dele argumentene med et semikolon i stedet for komma for å oppnå samme resultat som ovenfor. | "1 234 567,89 €" |
| Text( Date(2016,1,31), "dddd mmmm d" ) | Returnerer ukedagen, måneden og dagen i måneden i språket for gjeldende bruker. Fordi ingen av plassholderne er språkavhengige, er det ikke behov for en språkkode for tekstformat. | "Søndag januar 31" |
| Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) | Returnerer ukedagen, måneden og dagen i måneden på "es-ES"-språket. | "domingo enero 31" |
Konvertere verdier til tekst
| Formel | Beskrivelse | Resultat |
|---|---|---|
| Text( 1234567.89 ) | Konverterer et tall til en streng. Det finnes ingen tusenskilletegn eller kontroll over antall sifre før eller etter desimalskilletegnet. Hvis du vil ha mer kontroll, må du angi plassholdere for tall som andre argument. | "1234567.89" |
| Text( DateTimeValue( "01/04/2003" ) ) | Konverterer en dato/klokkeslett-verdi til en tekststreng. Hvis du vil kontrollere konverteringen, må du enten angi et medlem av DateTimeFormat-opplistingen eller en streng med egendefinerte format. | "1/4/2003 12:00 AM" |
| Text( true ) | Konverterer en boolsk verdi til en streng. | "true" |
| Text( GUID() ) | Konverterer en generert GUID-verdi til en streng. | "f8b10550-0f12-4f08-9aa3-bb10958bc3ff" |
| Left( Text( GUID() ), 4 ) | Returnerer de fire første tegnene i en generert GUID. | "2d9c" |