Delen via

De functie Text

  • Artikel

Van toepassing op: Canvas-apps Canvas-apps Dataverse Formulekolommen Modelgestuurde apps Power Pages Power Platform CLI

Converteert elke waarde en zet een getal- of datum/tijd-waarde om in een tekenreeks met tekst.

Beschrijving

De functie Text maakt een getal of een datum/tijd-waarde op basis van een van deze typen argumenten:

  • Een vooraf gedefinieerde datum/tijd-notatie, die u opgeeft met behulp van de opsomming DateTimeFormat. Voor datums en tijden heeft deze methode de voorkeur omdat het resultaat automatisch wordt aangepast aan de taal en regio van de gebruiker.
  • Een aangepaste notatie, bestaande uit een reeks tijdelijke aanduidingen die bijvoorbeeld bepalen of getallen een decimaal scheidingsteken bevatten en datums de volledige naam van de maand, de maand als afkorting of de maand als een getal geven. Power Apps ondersteunt een subset van de tijdelijke aanduidingen die Microsoft Excel ondersteunt. In deze tekenreeks geeft de tijdelijke aanduiding voor de taal de taal op waarin de andere tijdelijke aanduidingen moeten worden geïnterpreteerd. Als het aangepaste formaat bijvoorbeeld een punt bevat, specificeert de tijdelijke aanduiding voor de taalnotatie of de punt een decimaal scheidingsteken (ja-JP) is of een duizendtallen-scheidingsteken (es-ES).

Zie werken met datums en tijden voor meer informatie.

De functie Text kan ook elk gegevenstype converteren naar een tekstweergave met een standaardnotatie. Gebruik dit om niet-tekstwaarden door te geven aan op tekst gebaseerde functies zoals Len, Right en IsMatch.

Vooraf gedefinieerde datum-/tijdnotaties

Voor deze voorbeelden is de gebruikte datum en tijd dinsdag 7 april, 2020 20:26:59.180, in de tijdzone UTC-7 uur.

Opsomming DateTimeFormat Beschrijving Voorbeelden (met en-US)
LangeDatum Jaar in vier cijfers, naam van maand, dag van de maand en dag van de week. De namen van de maand en dag van de week worden niet afgekort. "Tuesday, April 7, 2020"
LangeDatumtijd Jaar in vier cijfers, naam van de maand, dag van de maand en dag van de week, plus aanduiding van uur (12-uurs notatie), minuten, seconden en AM/PM-aanduiding. De namen van de maand en dag van de week worden niet afgekort. "Tuesday, April 7, 2020 8:26:59 PM"
LangeDatumtijd24 Jaar in vier cijfers, naam van de maand, dag van de maand en dag van de week, plus aanduiding van uur (24-uurs notatie), minuten en seconden. De namen van de maand en dag van de week worden niet afgekort. "Tuesday, April 7, 2020 20:26:59"
Langdurig Uur (12-uurs notatie), minuten, seconden en AM/PM-aanduiding. "8:26:59 PM"
Langtijd24 Uur (24-uurs notatie), minuten en seconden. "20:26:59"
KorteDatum Jaar in vier cijfers met maand in cijfer(s) en dag van de maand. "4/7/2020"
KorteDatumtijd Jaar in vier cijfers met maand in cijfers en dag van de maand, plus uur (12-uurs notatie), minuten en AM/PM-aanduiding. "4/7/2020 8:26 PM"
KorteDatumtijd24 Jaar in vier cijfers met maand in cijfers en dag van de maand, plus uur (24-uurs notatie) en minuten. "4/7/2020 20:26"
Korte tijd Uur (12-uurs notatie), minuten en AM/PM-aanduiding. "8:26 PM"
Kortetijd24 Uur (24-uurs notatie) en minuten. "20:26"
UTC De waarde voor datum/tijd wordt geconverteerd naar UTC op basis van de tijdzone van de huidige gebruiker en genoteerd volgens de ISO 8601-norm. "2020-04-08T03:26:59.180Z"

Tijdelijke aanduidingen voor getallen

Tijdelijke aanduiding Beschrijving
0 (nul) Geeft extra nullen weer als een getal minder cijfers heeft dan er nullen in de notatie zijn. Gebruik bijvoorbeeld de notatie #,00 als u 8,9 wilt weergeven als 8,90.
# Volgt dezelfde regels als de 0 (nul). Text zal echter geen extra nullen retourneren als het getal links of rechts van het decimaalteken minder cijfers heeft dan er #-symbolen zijn in de notatie. Bijvoorbeeld 8,9 wordt weergegeven als de aangepaste notatie #,## is en het te noteren getal 8,9 is.
. (punt) Geeft de decimaalkomma weer in een getal. Is afhankelijk van de taal van de aangepaste notatie. Zie wereldwijde apps voor meer informatie.
, (komma) Geeft het groeperingsscheidingsteken in een getal weer. Wordt vaak gebruikt voor duizendtallen. Tekst scheidt groepen door komma's als de opmaak een komma bevat die is omsloten door getallen (#) of door nullen. Is afhankelijk van de taal van de aangepaste notatie. Zie wereldwijde apps voor meer informatie.

Als in een getal rechts van het decimaalteken meer cijfers voorkomen dan er tijdelijke aanduidingen in de notatie zijn, wordt het getal afgerond naar net zoveel decimaaltekens als het aantal tijdelijke aanduidingen. Als er links van het decimaalteken meer cijfers voorkomen dan er tijdelijke aanduidingen zijn, worden de extra cijfers weergegeven. Als in de notatie alleen hekjes (#) links van het decimaalteken voorkomen, beginnen getallen die kleiner zijn dan 1 met een decimaalteken (bijvoorbeeld ,47).

Tijdelijke aanduidingen voor datum en tijd

Tijdelijke aanduiding Beschrijving
M De maand wordt weergegeven als een getal zonder voorloopnul.
mm De maand wordt weergegeven als een getal met een voorloopnul wanneer dat nodig is.
mmm De maand wordt weergegeven als een afkorting (jan tot dec).
mmm De maand wordt weergegeven als een volledige naam (januari tot december).
D Geeft de dag weer als een getal zonder voorloopnul.
dd Geeft de dag weer als een getal zonder voorloopnul wanneer dat nodig is.
ddd Geeft de dag weer als een afkorting (zo tot za).
daaaa ... Geeft de dag weer als een volledige naam (zondag tot zaterdag).
jj Geeft het jaar weer als een getal van twee cijfers.
jjjj Geeft het jaar weer als een getal van vier cijfers.
H Geeft het uur weer als een getal zonder voorloopnul.
uh Geeft het uur weer als een getal met een voorloopnul wanneer dat nodig is. Als de notatie AM of PM bevat, wordt het uur weergegeven op basis van de 12-uurs notatie. Anders wordt het weergegeven uur gebaseerd op de 24-uurs notatie.
M Geeft de minuut weer als een getal zonder voorloopnul.

Deze tijdelijke aanduiding of mm moet direct na de code h of hh worden weergegeven of direct voor de code ss. Anders retourneert Text de maand in plaats van minuten.
mm Geeft de minuut weer als een getal met een voorloopnul wanneer dat nodig is.

Deze tijdelijke aanduiding moet direct na de tijdelijke aanduiding h of hh verschijnen of direct voor de tijdelijke aanduiding ss. Anders retourneert Text de maand in plaats van minuten.
S Geeft de seconden weer als een getal zonder voorloopnul.
ss Geeft de seconde weer als een getal met een voorloopnul wanneer dat nodig is.
F Geeft de fracties van seconden weer.
AM/PM, a/p Geeft het uur weer op basis van een 12-uurs notatie. Text retourneert "AM" of "a" voor tijden van middernacht tot 's middags en "PM" of "p" voor tijden van 's middags tot middernacht.

Letterlijke tijdelijke aanduidingen

U kunt al deze tekens in de tekenreeks voor uw notatie opnemen. Ze zullen als zodanig worden weergegeven in het resultaat van Text. Andere tekens zijn gereserveerd voor toekomstige tijdelijke aanduidingen. Die tekens mag u daarom niet gebruiken.

Teken Beschrijving
Alle valutasymbolen Euroteken, dollarteken, centteken, enzovoort.
+ Plusteken
( Haakje openen
: Dubbele punt
^ Accent circonflexe (caret-teken)
' Apostrof
{ Accolade links
< Kleiner-dan-teken
= Gelijkteken
- Minteken
/ Schuine streep
) Haakje sluiten
& En-teken
~ Tilde
} Accolade rechts
> Groter-dan-teken
  Spatie

Wereldwijde apps

De functie Text is locatiebewust. Voor een groot aantal talen kan deze functie de juiste notatie van datums, tijden, valuta's en getallen gebruiken. Hiervoor heeft de functie twee soorten informatie nodig:

  • De taal van het aangepaste formaat: Hoe moet een aangepast formaat door makers worden geïnterpreteerd? De scheidingstekens (. en ,) hebben in verschillende talen verschillende betekenissen. Als u een aangepaste notatie opgeeft, kunt u een tijdelijke aanduiding voor de taal opnemen of de standaardwaarde nemen, die de taal weergeeft waarop uw apparaat is ingesteld. U kunt het nog eenvoudiger doen en een van de voorgedefinieerde datum/tijd-notaties gebruiken, die taalonafhankelijk zijn.
  • De taal van het resultaat: In welke taal moet het functieresultaat voor gebruikers worden weergegeven? Namen van maanden en weekdagen moeten in de juiste taal zijn voor de gebruiker van de app. U kunt die specificeren door een derde, optioneel argument toe te voegen aan de functie Text.

Voor beide specificeert u de taal met behulp van een taalcode. Voor een overzicht van de ondersteunde talen typt u Text( 1234, "", ) in de formulebalk of het tabblad Geavanceerd in het rechterdeelvenster en bladert u door de lijst met landinstellingen die voor het derde argument worden voorgesteld.

Tijdelijke aanduiding voor taal

Geef de taal voor de aangepaste notatie als volgt op:

Tijdelijke aanduiding Beschrijving
[$-LanguageTag] LanguageTag is een taaltag zoals geretourneerd door de Language functie. Deze code alleen de taal noemen (bijvoorbeeld [$en] voor Engels), maar ook de regio kan worden gespecificeerd (zoals [$-en-GB] als u bijvoorbeeld specifiek Brits-Engels wilt opgeven).

De tijdelijke aanduiding voor de taal kan overal in de aangepaste notatie voorkomen, maar wel slechts één keer.

Als u een aangepaste notatie opgeeft zonder een tijdelijke aanduiding voor talen en de notatie wereldwijd gezien dubbelzinnig is, wordt de taalcode voor uw huidige taal automatisch ingevoegd.

[$-en-US] wordt aangenomen als deze tijdelijke aanduiding niet aanwezig is wanneer uw app wordt uitgevoerd.

Notitie

In een toekomstige versie zal de syntaxis van deze tijdelijke aanduiding mogelijk worden gewijzigd om verwarring te voorkomen met een vergelijkbare, maar andere, tijdelijke aanduiding die door Excel wordt ondersteund.

Taalcode van resultaat

In het resultaat van Text zijn vertaalde tekenreeksen opgenomen voor maanden, dagen van de week, AM/PM-aanwijzingen, evenals de juiste groeperings- en decimaalscheidingstekens.

Standaard gebruikt Text de taal van de gebruiker die de app uitvoert. De functie Language retourneert de taalcode voor de huidige gebruiker. U kunt deze standaardwaarde onderdrukken door een taalcode op te geven voor het derde argument voor Text.

Syntaxis

Tekst( NummerOfDatumtijd, DatumtijdFormaatEnum [, ResultaatTaalTag ] )

  • NumberOrDateTime - Verplicht. Het getal of de datum/tijd-waarde waarvan de notatie moet worden ingesteld.
  • DateTimeFormat - Vereist. Een lid van de opsomming DatumTijdNotatie.
  • ResultLanguageTag - Optioneel. De te gebruiken taalcode voor de resultaattekst. Standaard wordt de taal van de huidige gebruiker gebruikt.

Tekst( NummerOfDatumtijd, AangepasteOpmaak [, ResultaatTaalTag ] )

  • Nummer - Verplicht. Het getal of de datum/tijd-waarde waarvan de notatie moet worden ingesteld.
  • CustomFormat - Vereist. Een of meer tijdelijke aanduidingen tussen dubbele aanhalingstekens.
  • ResultLanguageTag - Optioneel. De te gebruiken taalcode voor de resultaattekst. Standaard wordt de taal van de huidige gebruiker gebruikt.

Tekst( ElkeWaarde )

  • AnyValue - Verplicht. De waarde die u wilt omzetten naar een tekstweergave. Er wordt een standaardnotatie gebruikt.

Tekst ( Niet getypt )

  • Niet-getypeerd - Verplicht. niet-getypeerd object die een string vertegenwoordigt. Aanvaardbare waarden zijn afhankelijk van de niet-getypeerde provider. Als voor JSON het niet-getypeerde object een getal of booleaanse waarde is, wordt het geconverteerd naar tekst.

Voorbeelden

Tenzij anders bepaald, bevindt de gebruiker die deze formules uitvoert zich in de Verenigde Staten en heeft Engels geselecteerd als taal. De functie Language retourneert "en-US".

Getal

Formule Beschrijving Resultaat
Tekst( 1234.59, "####.#" ) Maakt het getal op met één decimaalpositie. "1234.6"
Tekst( 8.9, "#.000" ) Vult het decimaalgedeelte van het getal op met volgnullen, indien nodig. "8.900"
Tekst( 0.631, "0.#" ) Vult het hele gedeelte van het getal op met voorloopnullen, indien nodig. "0.6"
Tekst( 12, "#.0#" )
Tekst( 1234.568, "#.0#" )		 Vult het decimale gedeelte van het getal op met nullen voor één decimaalpositie en voegt een tweede decimaalpositie toe, als deze is opgegeven. "12.0"
"1234.57"
Tekst(12000, "$ #,###" )
Tekst( 1200000, "$ #,###" )		 Plaatst om de drie cijfers een scheidingsteken voor duizendtallen en voegt een valutasymbool toe. "$ 12,000"
"$ 1,200,000"

Datum/tijd

  • Om 2:37:47 PM op Monday, November 23, 2015
  • Verenigde Staten, Pacific Time Zone (UTC-8)
Formule Beschrijving Resultaat
Tekst(Nu(), DatumtijdFormaat.LangeDatum) Wordt opgemaakt als een tekenreeks met lange datum, in de taal en met de landinstellingen van de huidige gebruiker. "Monday, November 23, 2015"
Tekst(Nu(), DatumtijdFormaat.LangeDatumtijd) Wordt opgemaakt als een tekenreeks met lange datum en tijd in de taal en landinstellingen van de huidige gebruiker, met een 12-uurs notatie. "Monday, November 23, 2015 2:37:47 PM"
Tekst(Nu(), DatumtijdFormaat.Langetijd24) Wordt opgemaakt als een tekenreeks met lange tijd, met een 24-uurs notatie. "14:37:47"
Tekst(Nu(), DatumtijdFormaat.KorteDatum) Wordt opgemaakt als een tekenreeks met korte datum, in de taal en met de landinstellingen van de huidige gebruiker. "11/23/2015"
Tekst(Nu(), "d-mmm-jj") Wordt opgemaakt met tekens als tijdelijke aanduiding:
  • d voor een enkelcijferige of dubbelcijferige dag van de maand
  • - als een letterlijk teken gekopieerd naar het resultaat
  • mmm voor een afkorting van drie letters voor de maand
  • - als een ander letterlijk teken gekopieerd naar het resultaat
  • yy voor een tweecijferige afkorting van het jaar
 "23-Nov-15"
Text(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") Geeft een Unix-datum-tijdwaarde in een door mensen leesbare notatie weer, als u de bronwaarde met 1000 vermenigvuldigt. "Nov. 23, 2015 (02:47:37 PM)"

Wereldwijde apps

Formule Beschrijving Resultaat
Tekst(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") Geeft een spatie weer als groeperingsscheidingsteken, de komma als decimaal scheidingsteken en € als valutasymbool. "1 234 567,89 €"
Tekst(1234567,89; "[$-fr-FR]# ###,## €") Als de brongegevens de Franse gewoonte volgen om een komma als decimaal scheidingsteken te gebruiken, moet u uw landinstelling wijzigen in Frans en de argumenten scheiden met een puntkomma in plaats van een komma om hetzelfde resultaat te krijgen als hierboven. "1 234 567,89 €"
Tekst( Date(2016,1,31), "dddd mmmm d" ) Retourneert de dag van de week, maand en dag van de maand in de taal van de huidige gebruiker. Omdat geen van de tijdelijke aanduidingen taalafhankelijk is, is er geen taalcode voor de opmaak van tekst nodig. "Zondag 31 januari"
Tekst( Date(2016,1,31), "dddd mmmm d", "es-ES" ) Retourneert de dag van de week, maand en dag van de maand in de taal "es-ES". "domingo enero 31"

Waarden omzetten in tekst

Formule Beschrijving Resultaat
Tekst( 1234567.89 ) Converteert een getal naar een tekenreeks. Er zijn geen scheidingstekens voor duizendtallen of controle over het aantal cijfers voor of na het decimale scheidingsteken. Geef voor meer controle plaatsaanduidingen voor getallen op als tweede argument. "1234567.89"
Tekst(DatumtijdWaarde( "01/04/2003" ) ) Converteert een datum/tijdwaarde naar een tekenreeks. Om de omzetting te beheersen, geeft u een lid van de opsomming DatumTijdNotatie op of een tekenreeks voor een aangepaste notatie. "1/4/2003 12:00 AM"
Tekst( waar ) Converteert een booleaanse waarde naar een tekenreeks. "true"
Tekst(GUID() ) Converteert een GUID-waarde naar een tekenreeks. "f8b10550-0f12-4f08-9aa3-bb10958bc3ff"
Links(Tekst(GUID()), 4) Retourneert de eerste vier tekens van een gegenereerde GUID. "2d9c"