Funktionen Text

Gælder for: Lærredsapps Lærredsapps Dataverse formelkolonner Modeldrevne apps 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.

Antal pladsholdere

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

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.

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 for det brugerdefinerede format: For fremstillere: Hvordan skal et brugerdefineret format fortolkes? 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: For brugere – hvilket sprog skal resultatet af funktionen vises på? 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:

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.

[$-en-US] bruges som standard, hvis denne pladsholder ikke er til stede, når appen køres.

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

Text( 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 – valgfri. Den sprogkode, der skal bruges til resultatteksten. Som standard bruges den aktuelle brugers sprog.

Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )

• Number – 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 – valgfri. Den sprogkode, der skal bruges til resultatteksten. Som standard bruges den aktuelle brugers sprog.

Text( AnyValue )

• AnyValue – påkrævet. Værdi, der skal konverteres til en tekstrepræsentation. Der bruges et standardformat.

Text ( Untyped )

• Untyped - 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

Dato og klokkeslæt

• Kl. 2:37:47 PMmandag d. 23. november 2015
• USA Pacific Time (UTC-8)

Globale apps

Konvertere værdier til tekst