De functie Text

Van toepassing op: Canvas-apps Canvas-apps Dataverse-formulekolommen Modelgestuurde apps 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.

Tijdelijke aanduidingen voor getallen

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

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.

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 de aangepaste notatie: voor auteurs, hoe moet een aangepaste notatie 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: voor gebruikers, in welke taal moet het resultaat van de functie worden getoond? 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:

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.

Er wordt bijvoorbeeld uitgegaan van [$-en-US] als deze tijdelijke aanduiding niet aanwezig is wanneer uw app wordt uitgevoerd.

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

Text( GetalOfDatumTijd, OpsommingDatumTijdNotatie [, TaalCodeResultaat ] )

• NumberOrDateTime: vereist. 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.

Text( GetalOfDatumTijd, AangepasteNotatie [, TaalCodeResultaat ] )

• Number: vereist. 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.

Text( ElkeWaarde )

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

Text ( Untyped )

• Untyped: vereist. Niet-getypeerd object dat voor een tekenreeks staat. 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

Datum/tijd

• Om 2:37:47 PM op Monday, November 23, 2015
• Verenigde Staten, Pacific Time Zone (UTC-8)

Wereldwijde apps

Waarden omzetten in tekst