Text-funktio

  • Artikkeli

Koskee seuraavia: Pohjaan perustuvat sovellukset Pohjaan perustuvat sovellukset Dataverse -kaavasarakkeet Mallipohjaiset sovellukset Power Platform CLI

Muuntaa minkä tahansa arvon ja muotoilee luvun tai päivämäärä- tai aika-arvon tekstimerkkijonoksi.

Kuvaus

Text-funktio soveltaa numeron tai päivämäärän/kellonajan muotoiluun jotain seuraavan tyyppisistä argumenteista:

  • Ennalta määritetty päivämäärän/kellonajan esitystapa, jonka voit määrittää käyttämällä DateTimeFormat-luettelointia. Tätä tyyppiä suositellaan päivämäärien ja kellonaikojen muotoiluun, koska se mukautuu automaattisesti kunkin käyttäjän kielen ja alueen mukaan.
  • Mukautettu muoto, joka käsittää paikkamerkkien merkkijonon, joka määrittää esimerkiksi, näytetäänkö lukujen desimaalierottimessa ja päivämäärissä kuukauden koko nimi, kuukausi lyhenteenä tai kuukausi numeroina. Power Apps tukee Microsoft Excelin tukemaa paikkamerkkien alijoukkoa. Tässä merkkijonossa kielen paikkamerkki määrittää kielen, jolla muut paikkamerkit tulkitaan. Jos mukautettu muoto sisältää esimerkiksi pisteen, kielimuodon paikkamerkki määrittää, onko piste desimaalierotin (ja-JP) vai tuhaterotin (es-ES).

Lisätietoja on kohdassa Päivämäärien ja kellonaikojen käsitteleminen.

Text-funktio voi myös muuntaa minkä tahansa tietotyypin tekstimuotoon oletusmuotoa käyttäen. Tämän avulla voit siirtää muita kuin tekstiarvoja tekstiperusteisiin funktioihin, kuten Len, Right ja IsMatch.

Ennalta määritetyt päivämäärän ja kellonajan muotoilut

Näissä esimerkeissä käytetty päivämäärä ja aika ovat tiistai 7. huhtikuuta 2020 klo 20.26.59,180 aikavyöhykkeellä UTC-7.

DateTimeFormat-luettelointi Kuvaus Esimerkkejä (käytössä en-US)
LongDate Nelinumeroinen vuosi, kuukauden nimi, kuukauden päivä ja viikonpäivä. Kuukausien nimiä ja viikonpäiviä ei lyhennetä. "Tuesday, April 7, 2020"
LongDateTime Nelinumeroinen vuosi, kuukauden nimi, kuukauden päivä, viikonpäivä sekä tunnit (12 tunnin kello), minuutit, sekunnit ja AM/PM-merkintä. Kuukausien nimiä ja viikonpäiviä ei lyhennetä. "Tuesday, April 7, 2020 8:26:59 PM"
LongDateTime24 Nelinumeroinen vuosi, kuukausi, kuukauden päivä, viikonpäivä sekä tunnit (24 tunnin kello), minuutit ja sekunnit. Kuukausien nimiä ja viikonpäiviä ei lyhennetä. "Tuesday, April 7, 2020 20:26:59"
LongTime Tunnit (12 tunnin kello), minuutit, sekunnit ja AM/PM. "8:26:59 PM"
LongTime24 Tunnit (24 tunnin kello), minuutit, sekunnit. "20:26:59"
ShortDate Nelinumeroinen vuosiluku sekä kuukausi numeroina ja kuukauden päivä. "4/7/2020"
ShortDateTime Nelinumeroinen vuosi, kuukausi numeroina ja kuukauden päivä sekä tunnit (12 tunnin kello), minuutit ja AM/PM-merkintä. "4/7/2020 8:26 PM"
ShortDateTime24 Nelinumeroinen vuosi, kuukausi numeroina ja kuukauden päivä sekä tunnit (24 tunnin kello) ja minuutit. "4/7/2020 20:26"
ShortTime Tunnit (12 tunnin kello), minuutit ja AM/PM. "8:26 PM"
ShortTime24 Tunnit (24 tunnin kello) ja minuutit. "20:26"
UTC Päivämäärän ja kellonajan arvo muunnetaan UTC-arvoon nykyisen käyttäjän aikavyöhykkeen perusteella ja muotoillaan ISO 8601-standardin mukaisesti. "2020-04-08T03:26:59.180Z"

Luvun paikkamerkit

Paikkamerkki Kuvaus
0 (nolla) Näyttää merkityksettömät nollat, jos luvussa on vähemmän numeroita kuin muodossa nollia. Käytä esimerkiksi muotoa #.00, jos haluat näyttää luvun 8,9 muodossa 8,90.
# Noudattaa samoja sääntöjä kuin 0 (nolla). Text-funktio ei kuitenkaan palauta ylimääräisiä nollia, jos desimaalipilkun jommallakummalla puolella on numeroita vähemmän kuin muotoilussa on ristikkosymboleja (#). Esimerkiksi 8,9 näytetään, jos mukautettu muoto on #.## ja muotoiltava numero on 8,9.
. (piste) Näyttää luvun desimaalierottimen. Riippuu mukautetun muodon kielestä; katso lisätietoja kohdasta Yleisiä sovelluksia.
, (pilkku) Näyttää ryhmittelyerottimen, jota joissakin kielissä käytetään tuhaterottimena. Text-funktio erottaa ryhmät pilkuilla, jos muotoilussa on ristikkomerkkien (#) tai nollien sisällä oleva pilkku. Riippuu mukautetun muodon kielestä; katso lisätietoja kohdasta Yleisiä sovelluksia.

Jos desimaalipilkun oikealla puolella on enemmän numeroita kuin muodossa on paikkamerkkejä, luku pyöristetään niin moneen desimaaliin kuin muodossa on paikkamerkkejä. Jos desimaalipilkun vasemmalla puolella on enemmän numeroita kuin muodossa on paikkamerkkejä, ylimääräiset numerot näytetään. Jos desimaalipisteen vasemmalla puolella on vain ristikkomerkkejä (#), lukua 1 pienemmän arvot alkavat desimaalipilkulla (esimerkiksi .47).

Päivämäärän ja kellonajan paikkamerkit

Paikkamerkki Kuvaus
m Näyttää kuukauden lukuna ilman ensimmäistä nollaa.
mm Näyttää kuukauden lukuna ja käyttää tarvittaessa ensimmäistä nollaa.
mmm Näyttää kuukauden lyhenteenä (Jan...Dec).
mmmm Näyttää kuukauden koko nimen (January...December).
p Näyttää kuukauden päivän ilman ensimmäistä nollaa.
dd Näyttää kuukauden päivän lukuna ja käyttää tarvittaessa ensimmäistä nollaa.
ddd Näyttää päivän lyhenteenä (Sun...Sat).
dddd Näyttää päivän koko nimen (Sunday...Saturday).
vv Näyttää vuoden kaksinumeroisena lukuna.
vvvv Näyttää vuoden nelinumeroisena lukuna.
H Näyttää tunnit ilman ensimmäistä nollaa.
hh Näyttää tunnit lukuna ja käyttää tarvittaessa ensimmäistä nollaa. Jos muotoiluun sisältyy AM tai PM, aika näkyy 12 tunnin mukaan. Muussa tapauksessa aika näytetään 24 tunnin mukaan.
m Näyttää minuutit lukuna ilman ensimmäistä nollaa.

Tämän paikkamerkin on oltava heti h- tai hh-koodin perässä tai heti ennen ss-koodia; muussa tapauksessa Text-funktio palauttaa kuukauden minuuttien sijaan.
mm Näyttää minuutit lukuna ja käyttää tarvittaessa ensimmäistä nollaa.

Tämän paikkamerkin on oltava heti h- tai hh-paikkamerkin jälkeen tai heti ennen ss-paikkamerkkiä. Muussa tapauksessa Text-funktio palauttaa kuukauden minuuttien sijaan.
s Näyttää sekunnin lukuna ilman ensimmäistä nollaa.
ss Näyttää sekunnit lukuna ja käyttää tarvittaessa ensimmäistä nollaa.
f Näyttää sekunnin murto-osat.
AM/PM, a/p Näyttää ajan 12 tunnin kellon perusteella. Text-funktio palauttaa arvon "AM" tai "a" keskiyöstä keskipäivään ja "PM" tai "p" keskipäivästä keskiyöhön

Literaalit paikkamerkit

Voit sisällyttää muotoilumerkkijonoon seuraavia merkkejä. Ne näkyvät Text-toiminnon tuloksessa sellaisenaan. Muita merkkejä varataan tulevia paikkamerkkejä varten, joten niitä ei kannata käyttää.

Merkki Kuvaus
Kaikki valuuttasymbolit Dollarin, sentin, euron merkit jne.
+ Plusmerkki
( Vasen sulkumerkki
: Kaksoispiste
^ Sirkumfleksi
' Heittomerkki
{ Vasen aaltosulje
< Pienempi kuin -merkki
= Yhtäläisyysmerkki
- Miinusmerkki
/ Vinoviiva
) Oikea sulkumerkki
& Et-merkki
~ Aaltoviiva
} Oikea aaltosulje
> Suurempi kuin -merkki
  Välilyönti

Yleiset sovellukset

Text-funktio on maailmanlaajuinen. Se tuntee suuren määrän kieliä ja osaa kirjoittaa päivämäärät, kellonajat, valuutat ja numerot kielen mukaan. Onnistuakseen tässä se tarvitsee seuraavat kaksi tietoa:

  • Mukautettavan muodon kieli:miten mukautettu muoto tulkitaan tekstin tekijää varten? Erotinmerkeillä (.ja ,) on eri kielissä eri merkitykset. Jos määrität mukautetun muodon, voit lisätä kielen paikkamerkin tai käyttää oletusarvoa, joka vastaa sitä kieltä, jolla laitteesi on määritetty. Vielä helpompaa on käyttää jotakin esimääritetyistä päivämäärä-/aikamuodoista, jotka ovat kielistä riippumattomia.
  • Tuloksen kieli: millä kielellä toiminnon tulos näytetään käyttäjälle? Kuukausien ja viikonpäivien nimien on oltava sovelluksen käyttäjän kielellä, ja ne voidaan määrittää lisäämällä Text-funktioon kolmas valinnainen argumentti.

Kummallekin voidaan määrittää kieli käyttämällä kielitunnistetta. Voit tarkastella tuettujen kielten luetteloa kirjoittamalla kaavariville tai oikeapuoleisen ruudun Lisäasetukset-välilehteen Text( 1234, "", ) ja selaamalla kolmanteen argumenttiin ehdotettuja kieliasetuksia.

Kielen paikkamerkki

Voit käyttää mukautetun muotoilun kielen määrittämiseen seuraavia:

Paikkamerkki Kuvaus
[$-LanguageTag] LanguageTag on Language-toiminnon palauttama kielitunniste. Se voi määrittää pelkän kielen (esim. englanti on [$-en]) tai se voi määrittää myös alueen (esim. Yhdistynyt kuningaskunta on [$-en-GB]).

Kielen paikkamerkki voi esiintyä missä tahansa kohdassa mukautettavaa muotoilua, mutta vain kerran.

Jos määrität mukautetun muodon ilman kielen paikkamerkkiä ja muoto on moniselitteinen maailmanlaajuisesta näkökulmasta, nykyisen kielen kielitunniste lisätään automaattisesti.

Jos tätä paikkamerkkiä ei löydy, kun sovellus suoritetaan, ohjelma olettaa, että asetus on [$-en-US].

Muistiinpano

Tulevassa versiossa tämän paikkamerkin syntaksi voi muuttua, jotta sitä ei sekoitettaisi Excelin tukemaan paikkamerkkiin, joka on samantyyppinen mutta erilainen.

Tuloksen kielitunniste

Text-toiminnon tulos sisältää käännetyt merkkijonot kuukausille, viikonpäiville ja AM-/PM-merkinnälle sekä asianmukaisille ryhmitys- ja desimaalierottimille.

Oletusmuotoisesti Text-funktio käyttää sitä kieltä, jota sovelluksessa parhaillaan käytetään. Language-funktio palauttaa nykyisen käyttäjän kielitunnisteen. Voit ohittaa tämän oletusarvon lisäämällä Text-toiminnon kolmannelle argumentille kielitunnisteen.

Syntaksi

Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )

  • NumberOrDateTime – Pakollinen. Muotoiltava numero tai päivämäärä/kellonaika.
  • DateTimeFormat – Pakollinen. DateTimeFormat-luetteloinnin osa.
  • ResultLanguageTag – Valinnainen. Kielitunniste, jota käytetään tulostekstiin. Oletusmuotoisesti käytetään nykyisen käyttäjän kieltä.

Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )

  • Number – Pakollinen. Muotoiltava numero tai päivämäärä/kellonaika.
  • CustomFormat – pakollinen. Yksi tai useampi paikkamerkki lainausmerkkien sisällä.
  • ResultLanguageTag – Valinnainen. Kielitunniste, jota käytetään tulostekstiin. Oletusmuotoisesti käytetään nykyisen käyttäjän kieltä.

Text( AnyValue )

  • AnyValue – pakollinen. Tekstimuotoon muunnettava arvo. Tässä käytetään oletusmuotoa.

Text ( Untyped )

  • Untyped – Pakollinen. Tyypittämätön objekti, joka edustaa merkkijonoa. Hyväksyttävät arvot riippuvat tyypittämätömästä palvelusta. Jos JSON-arvolle tyypittämätön objekti on numero tai totuusarvo, se muunnetaan tekstiksi.

Esimerkkejä

Ellei muuta ole määritetty, käyttäjä, joka suorittaa nämä kaavat, sijaitsee Yhdysvalloissa ja on valinnut kielekseen englannin. Language-funktio palauttaa tuloksen "en-US".

Luku

Kaava Kuvaus Tulos
Text( 1234.59, "####.#" ) Muotoilee luvun yhden desimaalin tarkkuudella. "1234.6"
Text( 8.9, "#.000" ) Lisää tarvittaessa nollat numeron desimaaliosan loppuun. "8.900"
Text( 0.631, "0.#" ) Lisää tarvittaessa kokonaislukuun nollan. "0.6"
Text( 12, "#.0#" )
Text( 1234.568, "#.0#" )		 Lisää numeroon nollan yhden desimaalin tarkkuudella ja lisää toisen desimaalin, jos se syötetään. "12.0"
"1234.57"
Text( 12000, "$ #,###" )
Text( 1200000, "$ #,###" )		 Sijoittaa lukuun kolmen numeron välein tuhaterottimen ja lisää valuuttasymbolin. "$ 12,000"
"$ 1,200,000"

Päivämäärä/aika

  • 2:37:47 PM, Monday, November 23, 2015
  • Yhdysvaltain Tyynenmeren aikavyöhyke (UTC-8)
Kaava Kuvaus Tulos
Text( Now(), DateTimeFormat.LongDate ) Päivämäärä pitkänä merkkijonona, käytössä olevan kielen mukaan esitettynä. "Monday, November 23, 2015"
Text( Now(), DateTimeFormat.LongDateTime ) Päivämäärä pitkänä merkkijonona, käytössä olevan kielen mukaan esitettynä 12 tunnin mukaan. "Monday, November 23, 2015 2:37:47 PM"
Text( Now(), DateTimeFormat.LongTime24 ) Päivämäärä pitkänä merkkijonona, käytössä olevan kielen mukaan esitettynä 24 tunnin mukaan. "14:37:47"
Text( Now(), DateTimeFormat.ShortDate ) Päivämäärä lyhyenä merkkijonona, käytössä olevan kielen mukaan esitettynä. "11/23/2015"
Text( Now(), "d-mmm-yy" ) Esitetään käyttämällä paikkamerkkejä:
  • d – yksi- tai kaksinumeroinen kuukauden päivä
  • - – tulokseen kopioitu literaalimerkki
  • mmm – kolmikirjaiminen kuukauden lyhenne
  • - – toinen tulokseen kopioitu literaalimerkki
  • yy – vuosiluku kaksinumeroisena lyhenteenä
 "23-Nov-15"
Text(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") Näyttää Unix-päivämäärä-aika-arvon luettavassa muodossa, jos lähdearvon kertoo luvulla 1 000. "Nov. 23, 2015 (02:47:37 PM)"

Maailmanlaajuiset sovellukset

Kaava Description Result
Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") Näyttää välilyönnin ryhmittelyerottimena, pilkun desimaalierottimena ja €-merkin rahayksikön tunnuksena. "1 234 567,89 €"
Text(1234567,89; "[$-fr-FR]# ###,## €") Jos lähdetiedoissa noudatetaan ranskalaista tapaa käyttää pilkkua desimaalierottimena, sinun on muutettava sijainniksesi Ranska ja erotettava argumentit puolipisteellä pisteen sijaan, jotta saat saman tuloksen kuin yllä. "1 234 567,89 €"
Text( Date(2016,1,31), "dddd mmmm d" ) Palauttaa viikonpäivän, kuukauden ja kuukauden päivän muotoiltuna nykyisen käyttäjän kielen mukaan. Koska paikkamerkit eivät ole kieleen sidottuja, tekstin muotoiluun ei tarvita kielitunnistetta. "Sunday January 31"
Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) Palauttaa viikonpäivän, kuukauden ja kuukauden päivän kielitunnisteen "es-ES" mukaisesti. "domingo enero 31"

Arvojen muuntaminen tekstiksi

Kaava Kuvaus Tulos
Text( 1234567.89 ) Muuntaa numeron merkkijonoksi. Tuhaterottimia ei ole, eikä desimaalierotinta edeltävien tai seuraavien numeroiden määrään voi vaikuttaa. Lisää määritysmahdollisuuksia saat käyttämällä toisena argumenttina numeropaikkamerkkejä. "1234567.89"
Text( DateTimeValue( "01/04/2003" ) ) Muuntaa päivämäärä-/aika-arvon tekstimerkkijonoksi. Jos haluat hallita muunnosta, anna joko DateTimeFormat-luetteloinnin tai mukautetun muodon merkkijonon jäsen. "1/4/2003 12:00 AM"
Text( true ) Muuntaa totuusarvon merkkijonoksi. "true"
Text( GUID() ) Muuntaa luodun GUID-arvon merkkijonoksi. "f8b10550-0f12-4f08-9aa3-bb10958bc3ff"
Left( Text( GUID() ), 4 ) Palauttaa luodun GUID-tunnuksen neljä ensimmäistä merkkiä. "2d9c"