Partekatu honen bidez:

Testu funtzioa

  • Artikulua

Hauei aplikatzen zaie: Canvas aplikazioak Canvas aplikazioak Dataverse formula-zutabeak Modeloetan oinarritutako aplikazioak Power Pages Power Platform CLI

Zenbait balio eta formatu zenbaki edo data eta orduko balioa testu-kate bihurtzen du.

Deskribapenak

Text funtzioa zenbaki bat edo data eta orduaren balioa formatu honetako argudio hauetako batean oinarrituz sortzen da:

  • Aurrez zehaztutako data eta orduaren formatua, zuk erabiliz zehazten duzula DateTimeFormat zenbaketa. Data eta orduetarako, ikuspegi hau nahiago da erabiltzaile bakoitzaren hizkuntza eta eskualdera egokitzen den modu automatikoan.
  • Formatu pertsonalizatuak leku-marken kate bat du; adibidez, zenbakiek hamartarren bereizlea eta datek hilabetearen izen osoa, laburdura edo zenbaki gisa erakusten dituen. Power Apps-ek Microsoft Excel-ek sortutako leku-marken azpimultzoa onartzen du. Kate honetan, hizkuntzaren leku-markak zehazten du zein beste leku-marka interpretatzeko. Formatu pertsonalizatuak aldi bat biltzen badu, adibidez, hizkuntza-formatuko leku-markak zehazten du aldia hamartarren bereizlea (ja-JP) edo milakoen bereizlea (es-ES) den.

Informazio gehiago lortzeko, ikus Data eta orduekin lan egin.

Text funtzioak beste edozein datu mota testu ordezkaritza bihur ditzake formatu lehenetsiak erabiliz. Erabili hau testurik gabeko balioak testuetan oinarritutako funtzioetara pasatzeko, adibidez Len, Right eta IsMatch.

Aurrez zehaztutako data eta orduaren formatuak

Adibide hauetarako, erabilitako data eta ordua 2020ko apirilaren 7, asteartea, 8:26:59.180 PM da, ordu-eremuan UTC-7 orduetan.

DateTimeFormat zenbakitzea Deskribapenak Adibideak (en-US erabiliz)
LongDate Lau digituko urtea, hilabetearen izena, hilaren eguna eta asteko eguna. Astearen hilaren eta egunaren izenak ez dira laburtzen. "Asteartea, 2020ko apirilak 7"
LongDateTime Lau digituko urtea, hilabetearen izena, hilaren eguna eta asteko eguna, gehi ordua (12 orduko erlojua), minutuak, segundoak eta AM / PM izendapena. Astearen hilaren eta egunaren izenak ez dira laburtzen. "Asteartea, 2020ko apirilak 7, 8:26:59 PM"
LongDateTime24 Lau digituko urtea, hilabetearen izena, hilaren eguna eta asteko eguna, gehi ordua (24 orduko erlojua), minutuak eta segundoak. Astearen hilaren eta egunaren izenak ez dira laburtzen. "Asteartea, 2020ko apirilak 7, 20:26:59"
LongTime Ordua (12 orduko erlojua), minutu, segundo eta AM/PM izendapena. "8:26:59 PM"
LongTime24 Ordua (24 orduko erlojua), minutu, segundo. "20:26:59"
ShortDate Lau digituko urtea hileko zenbakizko egunarekin eta egunarekin. "2020/4/7"
ShortDateTime Lau digituko urtea hilabetearen eta egunaren zenbakiarekin, gehi ordua (12 orduko erlojua), minutuak eta AM / PM izendapena. "2020/4/7 8:26 PM"
ShortDateTime24 Lau digituko urtea hilabetearen eta egunaren zenbakiarekin, gehi ordua (24 orduko erlojua) eta minutuak. "2020/4/7 20:26"
ShortTime Ordua (12 orduko erlojua), minutu, eta AM/PM izendapena. "8:26 PM"
ShortTime24 Ordua (24 orduko erlojua) eta minutuak. "20:26"
UTC Data eta orduaren balioa UTC bihurtuko da uneko erabiltzailearen ordu-eremuan oinarrituta eta ISO 8601 arauaren arabera. "2020-04-08T03:26:59.180Z"

Zenbakien leku-markak

Leku-marka Deskribapenak
0 (zero) Zero hutsak bistaratzen ditu zenbakiak formatuan zeroak baino zenbaki gutxiago baditu. Adibidez, erabili #.00 formatua bistaratu nahi baduzu 8.9 gisa 8.90.
# Honako arau berak jarraitzen ditu 0 (zero). Hala ere, Testua balioak ez du zero gehigarririk ematen zenbakiak hamartarren alde bakoitzean digitu gutxiago ditu formatuan # sinboloak baino. Adibidez, 8.9 formatu pertsonalizatua bada #.## eta formatu beharreko zenbakia da 8.9.
, (aldia) Zenbaki baten hamartarra bistaratzen du. Formatu pertsonalizatuaren hizkuntzaren araberakoa da; ikusi aplikazio orokorrak xehetasun gehiago lortzeko.
, (koma) Taldekatze-bereizgailua zenbakitan erakusten du, askotan milaka erabiltzeko. Testua balioak taldeak komaz bereizten ditu formatuak zenbaki zeinuekin itxita dagoen koma baldin badu (#) edo zeroen arabera. Formatu pertsonalizatuaren hizkuntzaren araberakoa da; ikusi aplikazio orokorrak xehetasun gehiago lortzeko.

Zenbaki batek zenbaki hamartarraren eskuinaldean formatuan markagailuak baino zenbaki gehiago baldin baditu, zenbakiak leku-marka guztiak dauden hamartar guztietara biribilduko du. Leku-markak baino dezimalen ezkerreko zenbaki gehiago baldin badaude, zenbaki gehigarriak bistaratuko dira. Formatuak dezimalen ezkerreko zenbaki-seinaleak (#) baino ez baditu, 1 baino gutxiagoko zenbakiak hamartar batekin hasten dira (adibidez, .47).

Data eta orduaren leku-markak

Leku-marka Deskribapenak
m Zenbaki gisa hilabetea zero biderik gabe erakusten du.
mm Zenbaki gisa hilabetea aurreko zeroarekin erakusten du beharrezkoa denean.
mmm Hilabetea laburdura gisa erakusten du (urt - abe).
mmmm Izen osoa bezala erakusten du hilabetea (urtarrila - abendua).
d Zenbaki gisa eguna zero biderik gabe erakusten du.
dd Zenbaki gisa eguna aurreko zeroarekin erakusten du beharrezkoa denean.
ddd Eguna laburdura gisa erakusten du (iga - lar).
dddd Eguna izen oso gisa bistaratzen du (Igandea to Larunbata).
yy Urtea bi digituko zenbaki gisa bistaratzen du.
yyyy Urtea lau digituko zenbaki gisa bistaratzen du.
h Zenbaki gisa ordua zero biderik gabe erakusten du.
hh Zenbaki gisa ordua aurreko zeroarekin erakusten du beharrezkoa denean. Formatuak AM edo PM badu, orduak 12 orduko erlojuan oinarrituta erakusten dira. Bestela, 24 orduko erlojua oinarritzat hartuta erakusten da.
m Zenbaki gisa minutua zero biderik gabe erakusten du.

Leku-marka hau berehala agertu beharko da h edo hh kodea edo berehala aurretik ss kodea; bestela, Testua balioak minutuak itzultzen ditu hilabetearen ordez.
mm Zenbaki gisa minutua aurreko zeroarekin erakusten du beharrezkoa denean.

Leku-marka hau berehala agertu beharko da h edo hh leku-marka edo berehala ss. Bestela, Testua balioak minutuak itzultzen ditu hilabetearen ordez.
s Zenbaki gisa segundoa zero biderik gabe erakusten du.
ss Zenbaki gisa segundoa aurreko zeroarekin erakusten du beharrezkoa denean.
f Segundoen zatikiak bistaratzen ditu.
AM/PM, a/p Ordua 12 orduko erloju baten arabera bistaratzen du. Testua balioak "AM" edo "a" itzultzen ditu gauerditik eguerdira arte eta "PM" edo "p" ordutatik eguerdira arte

Leku-marka literalak

Karaktere hauetakoren bat zure formatu-katean sar dezakezu. Emaitzak agertuko dira Testua balioa dagoen bezala. Karaktere osagarriak etorkizuneko tokiei zuzenduta daude eta, beraz, ez zenituzke erabili behar.

Karakterea Deskribapenak
Edozein moneta-ikur Dolarren ikurra, zentimoen ikurra, euroen ikurra eta abar.
+ Plus zeinua
( Ezkerreko parentesia
: Bi puntu
^ Azentu zirkunflexua (tartekatze-zeinua)
' Apostrofea
{ Ezkerreko giltza
< "Hau baino txikiagoa" zeinua
= "Berdina" zeinua
- Minus zeinua
/ Barra-marka
) Eskuineko parentesia
& Ampersan
~ Azentu-marka
} Eskuineko giltza
> "Hau baino handiagoa" zeinua
  Zuriune-karakterea

Aplikazio orokorrak

Text funtzioa mundu osoan jakitun da. Hizkuntza sorta zabal baterako, badaki datak, orduak, moneta eta zenbakiak behar bezala idazten. Bere lana egiteko, bi informazio behar ditu:

  • Formatu pertsonalizatuaren hizkuntza: garatzaileentzat; nola interpretatu behar da formatu pertsonalizatua? Karaktere bereizleek (. eta ,) esanahi desberdinak dituzte hizkuntza desberdinetan. Formatu pertsonalizatua zehazten baduzu, hizkuntzaren leku-marka jarri dezakezu edo balio lehenetsia hartu, zure gailuak ezarri duen hizkuntza islatzen duena. Errazagoa bada ere, erabil dezakezu aurrez zehaztutako data eta orduaren formatuak, hizkuntza agnostikoak direnak.
  • Emaitzaren hizkuntza: erabiltzaileentzat; zein hizkuntzatan agertu behar da funtzioaren emaitza? Hilabeteko eta astegunetako izenak aplikazioaren erabiltzaileari dagokion hizkuntzan jarri behar dira; hau da, aukerako hirugarren argumentua gehituz zehaztu dezakezu Text funtzioa.

Bietarako, hizkuntza zehaztu duzu hizkuntza etiketa. Onartutako hizkuntzen zerrenda ikusteko, idatzi Testua( 1234, "", ) formula-barran edo Aurreratua eskuineko paneleko fitxa, eta joan hirugarren argumentuari iradokitako tokien zerrendatik.

Hizkuntzaren leku-marka

Formatu pertsonalizatuaren hizkuntza zehazteko, erabili:

Leku-marka Deskribapenak
[$-LanguageTag] LanguageTag hizkuntza-etiketa da Language funtziotik itzulita. Hizkuntza besterik ezin du zehaztu (adibidez [$-en] ingelesez) edo eskualdea ere zehaztu dezake (adibidez [$-en-GB] Britainia Handia gehiago zehazteko).

Hizkuntzaren leku-markaren formatuan edozein lekutan ager daiteke, baina behin bakarrik.

Formatu pertsonalizatua hizkuntzaren leku-markarik gabe zehazten baduzu eta formatua anbiguoa da ikuspegi orokorretik, zure uneko hizkuntzaren etiketa automatikoki txertatuko da.

[$-en-US] aplikatzen da leku-marka hau ez badago aplikazioa exekutatzen denean.

Oharra

Etorkizuneko bertsio batean, leku-marka honen sintaxia alda daiteke Excel-ek onartzen duen toponimia antzeko, baina ezberdina izan ez dadin.

Emaitzaren hizkuntza-etiketa

Emaitza Testua barne hartzen ditu hilabete, astegun eta AM/PM izendapenetarako kateak, baita talde eta hamartar bereizle egokiak ere.

Lehenetsiz, Testua aplikazioa exekutatzen duen erabiltzailearen hizkuntza erabiltzen du. Language funtzioak uneko erabiltzailearen hizkuntza-etiketa itzultzen du. Lehenetsitako balio hau hirugarren argumenturako hizkuntza-etiketa hornituz alda dezakezu Testua.

Sintaxia

Testua( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )

  • NumberOrDateTime - Beharrezkoa. Kopiatzeko kopurua edo data eta ordua.
  • DateTimeFormat - Beharrezkoa. Elkarteko kidea DateTimeFormat zenbaketa.
  • ResultLanguageTag - Aukerakoa. Emaitza testurako erabiliko den hizkuntza-etiketa. Berez, uneko erabiltzailearen hizkuntza erabiltzen da.

Testua( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )

  • Zenbakia - Beharrezkoa. Kopiatzeko kopurua edo data eta ordua.
  • CustomFormat - Beharrezkoa. Leku-marka bat edo gehiago komatxo bikoitzetan itxita.
  • ResultLanguageTag - Aukerakoa. Emaitza testurako erabiliko den hizkuntza-etiketa. Berez, uneko erabiltzailearen hizkuntza erabiltzen da.

Testua( AnyValue )

  • AnyValue - Beharrezkoa. Testuaren ordezkaritza bihurtzeko balioa. Formatu lehenetsia erabiltzen da.

Testua ( Idatzi gabea )

  • Untyped - Beharrezkoa. Idatzi gabeko objektua kate bat adierazten duena. Balio onargarriak idatzi gabeko hornitzailearen araberakoak dira. JSONrako, motarik gabeko objektu zenbaki bat edo boolearra bada, testu bihurtuko da.

Adibideak

Besterik adierazi ezean, formula hauek erabiltzen dituzten erabiltzaileak Estatu Batuetan kokatuta daude eta ingelesa hautatu du hizkuntza gisa. Language funtzioa "en-US" itzultzen ari da.

Zenbakia

Formula Deskribapenak Emaitza
Text( 1234.59, "####.#" ) Zenbaki bat hamartar batekin osatzen du. "1234.6"
Text( 8.9, "#.000" ) Behar izanez gero, zenbakiaren zati hamartarra zuloekin lotzen du. "8.900"
Text( 0.631, "0.#" ) Behar izanez gero, zenbakiaren zati osoa aurreko zeroekin lotzen du. "0.6"
Text( 12, "#.0#" )
Text( 1234.568, "#.0#" )		 Zenbaki hamartarren zeroen kopurua hamartarren zifrak betetzen ditu eta bigarren hamartarra barne hartzen du. "12.0"
"1234.57"
Text( 12000, "$ #,###" )
Text( 1200000, "$ #,###" )		 Hiru digitu bakoitzean milakoen banatzaile jartzen ditu eta moneta-ikurra ere badu. "12.000 USD"
"1.200.000 USD"

Data/Ordua

  • 2:37:47 PM ordua Astelehena, 2015eko azaroak 23
  • Ameriketako Estatu Batuak Pazifikoko ordua (UTC-8)
Formula Deskribapenak Emaitza
Testua( Orain(), DateTimeFormat.LongDate ) Formatu luzeko data-kate gisa, uneko erabiltzailearen hizkuntza eta eskualdeko ezarpenetan. "2015eko azaroak 23, astelehena"
Testua( Orain(), DateTimeFormat.LongDateTime ) Formatu luzeko kate gisa data eta ordua, uneko erabiltzailearen hizkuntza eta eskualdeko ezarpenetan, 12 orduko erloju bat erabiliz. "Astelehena, 2015eko azaroak 23, 2:37:47 PM"
Testua( Orain(), DateTimeFormat.LongTime24 ) Formatu luzeko ordu-katea da, 24 orduko erlojua erabilita. "14:37:47"
Testua( Orain(), DateTimeFormat.ShortDate ) Formatu laburreko data-kate gisa, uneko erabiltzailearen hizkuntza eta eskualdeko ezarpenetan. "11/23/2015"
Text( Now(), "d-mmm-yy" ) Leku-markako karaktereak erabiliz formatuak:
  • d hilabetearen zenbaki bakarreko edo bi digituko egunerako
  • - emaitzan kopiatutako karaktere literal gisa
  • mmm hilabetearen hiru letrako laburdura
  • - emaitzan kopiatutako beste karaktere literal bat gisa
  • yy urteko bi digituko laburdurarako
 "23-aza-15"
Text(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") Unix data eta orduaren balioa irakurtzeko moduko formatuan erakusten du iturriaren balioa 1.000 bada. "Azaroak 23, 2015 (02:47:37 PM)"

Aplikazio orokorrak

Formula Deskribapenak Result
Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") Espazio bat taldekatze bereizle gisa, koma bereizle hamartar gisa eta € monetaren sinbolo gisa. "1 234 567,89 €"
Text(1234567,89; "[$-fr-FR]# ###,## €") Jatorrizko datuak koma bereizle hamartar gisa erabiltzeko frantsesaren ohiturari jarraitzen badiozu, zure eskualdeko ezarpenak frantsesez aldatu behar dituzu eta argumentuak puntu biren ordez komaren ordez, emaitza berdina lortzeko. "1 234 567,89 €"
Text( Date(2016,1,31), "dddd mmmm d" ) Astea, hilabetea eta hilaren eguna itzultzen ditu uneko erabiltzailearen hizkuntzan. Leku-marketako bat hizkuntzaren mende dagoenez, ez da formatuko testu-hizkuntza etiketarik behar. "Igandea, urtarrilaren 31"
Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) Astea, hilabetea eta hilaren eguna itzultzen ditu uneko erabiltzailearen "es-ES" hizkuntzan. "domingo enero 31"

Balioak testu bihurtzea

Formula Deskribapenak Emaitza
Text( 1234567.89 ) Zenbaki bat kate bihurtzen du. Ez dago mila bereizketarik edo kontrol-zenbakirik hamartar bereizlearen aurretik edo ondoren; kontrol gehiagorako, hornitzaileen leku-markak bigarren argumentu gisa. "1234567.89"
Text( DateTimeValue( "01/04/2003" ) ) Data eta orduaren balioak testu-kate bihurtzen du. Bihurketa kontrolatzeko, eman DateTimeFormat zenbakitzearen kide bat edo formatu pertsonalizatuko katea. "1/4/2003 12:00 AM"
Text( true ) Zenbaki bat balio boolear bihurtzen du. "egia"
Text( GUID() ) Zenbaki bat sortutako balio GUID bihurtzen du. "f8b10550-0f12-4f08-9aa3-bb10958bc3ff"
Left( Text( GUID() ), 4 ) Sortutako GUID baten lehen lau karaktereak itzultzen ditu. "2d9c"