Text Функция

Келесілерге қолданылады: Кенеп бағдарламалары Copilot Studio Жұмыс үстелі ағындары Dataverse формула бағандары Үлгіге негізделген бағдарламалар Power Platform CLI Dataverse функциялары Power Pages

Кез келген мәнді мәтін жолына түрлендіреді және санды немесе күн/уақыт мәнін мәтін жолы түрінде пішімдейді.

Сипаттама

Функция аргументтердің мына түрлерінің біріне негізделген санды немесе күн/уақыт мәнін пішімдейді:Text

  • Алдын ала анықталған күн/уақыт пішімі, оны DateTimeFormat санамалауын пайдалана отырып көрсетуге болады. Күндер мен уақыттар үшін бұл тәсілге артықшылық беріледі, өйткені ол әр пайдаланушының тілі мен аймағына автоматты түрде бейімделеді.
  • Мысалы, сандар ондық бөлгішті және күндер айдың толық атауын, аббревиатура түріндегі айды немесе айды сан ретінде көрсететінін анықтайтын толтырғыштар жолынан тұратын теңшелетін пішім. Power Apps жүйесі Microsoft Excel қолдайтын толтырғыштардың ішкі жиынын қолдайды. Бұл жолда тіл толтырғышы басқа толтырғыштарды түсіндіретін тілді көрсетеді. Егер теңшелетін пішім кезеңді қамтыса, мысалы, тіл пішіміндегі толтырғыш кезеңнің ондық бөлгіш (ja-JP) немесе мыңдық бөлгіш (es-ES) екенін анықтайды.

Қосымша ақпаратты күндермен және уақыттармен жұмыс істеу бөлімінен қараңыз.

Функция сондай-ақ кез-келген деректер түрін Text әдепкі пішімді пайдаланып мәтіндік көрсетілімге түрлендіре алады. Мұны Len, Right және IsMatch сияқты мәтін негізіндегі функцияларға мәтіндік емес мәндерді өткізу үшін пайдаланыңыз.

Алдын ала анықталған күн/уақыт пішімдері

Осы мысалдар үшін пайдаланылған күн мен уақыт — сейсенбі, 7 сәуір, 2020 8:26:59.180, UTC-7 сағаттары уақыт белдеуінде.

DateTimeFormat санамалауы Сипаттама Мысалдар (en-US пайдаланылған)
Ұзақкүн Төрт цифрлық жыл, айдың атауы, айдың күні және аптаның күні. Айдың және апта күнінің атаулары қысқартылмайды. "Сейсенбі, 7 сәуір, 2020"
LongDateTime Төрт цифрлық жыл, айдың атауы, айдың күні және аптаның күні, сонымен қатар сағат (12 сағаттық сағат), минуттар, секундтар және AM/PM белгіленуі. Айдың және апта күнінің атаулары қысқартылмайды. "Сейсенбі, 7 сәуір, 2020 8:26:59 PM"
LongDateTime24 Төрт цифрлық жыл, ай, айдың күні және аптаның күні, сонымен қатар сағат (24 сағаттық сағат), минуттар және секундтар. Айдың және апта күнінің атаулары қысқартылмайды. "Сейсенбі, 7 сәуір, 2020 20:26:59"
Ұзақ уақыт Сағат (12 сағаттық сағат), минуттар, секундтар және AM/PM белгіленуі. «8:26:59 PM»
Ұзақ уақыт 24 Сағат (24 сағаттық сағат), минуттар, секундтар. "20:26:59"
Қысқа күн Сандық ай және ай күні бар төрт цифрлық жыл. "4/7/2020"
ShortDateTime Сандық ай және айдың күні бар төрт цифрлық жыл, сонымен қатар сағат (12 сағаттық сағат), минуттар және AM/PM белгіленуі. «4/7/2020 8: 26 PM»
ShortDateTime24 Сандық ай және айдың күні бар төрт цифрлық жыл, сонымен қатар сағат (24 сағаттық сағат) және минуттар. "4/7/2020 20:26"
Қысқа уақыт Сағат (12 сағаттық сағат), минуттар және AM/PM белгіленуі. «8:26 PM»
Қысқа уақыт24 Сағат (24 сағаттық сағат) және минуттар. "20:26"
UTC Күн/уақыт мәні ағымдағы пайдаланушының уақыт белдеуіне сәйкес UTC пішіміне түрлендіріледі және ISO 8601 стандартына сәйкес пішімделеді. "2020-04-08T03:26:59.180Z"

Сандық толтырғыштар

Толтырғыш Сипаттама
0 (нөл) Егер санда пішімдегі нөлдерден азырақ цифрлар болса, шамалы нөлдерді көрсетеді. Мысалы, 8,9 санын 8,90 түрінде көрсеткіңіз келсе, #,00 пішімін пайдаланыңыз.
# 0 (нөл) санымен бірдей ережелерді сақтайды. Алайда, Text санның ондық бөлшектің екі жағында пішімдегі # символдарына қарағанда аз цифрлар болған кезде қосымша нөлдерді қайтармайды. Мысалы, 8,9 саны теңшелетін пішім #,## болса және пішімдейтін сан 8,9 болса көрсетіледі.
. (нүкте) Санда ондық нүктені көрсетеді. Теңшелетін пішімнің тіліне байланысты; қосымша мәліметтерді глобалдық бағдарламалар бөлімінен қараңыз.
, (үтір) Санда жиі мыңдықтар үшін пайдаланылатын топтастыру бөлгішін көрсетеді. Text Пішімде сан белгілерімен (#) немесе нөлдермен қоршалған үтір болса, топтарды үтірмен бөледі. Теңшелетін пішімнің тіліне байланысты; қосымша мәліметтерді глобалдық бағдарламалар бөлімінен қараңыз.

Егер санда ондық үтірдің оң жағында пішімдегі толтырғыштардан көбірек цифрлар болса, сан толтырғыштармен бірдей ондық таңбаларға дейін дөңгелектенеді. Егер ондық үтірдің сол жағында толтырғыштардан көбірек цифрлар болса, қосымша цифрлар көрсетіледі. Егер пішім ондық үтірдің сол жағында сандық белгілерді (#) қамтыса, 1-ден азырақ сандар ондық үтірден басталады (мысалы, ,47).

Күн мен уақыт толтырғыштары

Толтырғыш Сипаттама
m Айды алдыңғы нөлсіз сан түрінде көрсетеді.
mm Айды тиісті кезде алдыңғы нөл бар сан түрінде көрсетеді.
mmm Айды аббревиатура түрінде көрсетеді ( Қаң - Жел).
mmmm Айды толық атауымен көрсетеді ( Қаңтар - Желтоқсан).
d Күнді алдыңғы нөлсіз сан түрінде көрсетеді.
dd Күнді тиісті кезде алдыңғы нөл бар сан түрінде көрсетеді.
ddd Күнді аббревиатура түрінде көрсетеді ( Жек - Сен).
dddd Күнді толық атауымен көрсетеді ( Жексенбі - Сенбі).
yy Жылды екі цифрлық сан түрінде көрсетеді.
yyyy Жылды төрт цифрлық сан түрінде көрсетеді.
h Сағатты алдыңғы нөлсіз сан түрінде көрсетеді.
hh Сағатты тиісті кезде алдыңғы нөл бар сан түрінде көрсетеді. Егер пішім AM немесе PM сөзін қамтыса, сағат 12 сағаттық сағат негізінде көрсетіледі. Әйтпесе, сағат 24 сағаттық сағат негізінде көрсетіледі.
m Минутты алдыңғы нөлсіз сан түрінде көрсетеді.

Бұл толтырғыш h немесе hh кодынан кейін немесе SS кодының алдында бірден пайда болуы керек; әйтпесе, Text минуттардың орнына айды қайтарады.
mm Минутты тиісті кезде алдыңғы нөл бар сан түрінде көрсетеді.

Бұл толтырғыш h немесе hh толтырғышынан кейін бірден, я болмаса тура ss толтырғышының алдында болуы керек. Әйтпесе, Text минуттардың орнына айды қайтарады.
s Секундты алдыңғы нөлсіз сан түрінде көрсетеді.
ss Секундты тиісті кезде алдыңғы нөл бар сан түрінде көрсетеді.
f Секундтың бөлшектерін көрсетеді.
AM/PM,a/p 12 сағаттық сағат негізінде сағатты көрсетеді. Text Түн ортасынан түске дейінгі уақыттар үшін "AM" немесе "A" және түстен түн ортасына дейін "PM" немесе "P" қайтарады

Литерал толтырғыштар

Сіз осы таңбалардың кез келгенін пішім жолына қоса аласыз. Нәтижесіндегідей пайда Text болады. Қосымша таңбалар болашақ толтырғыштар үшін сақталған, сондықтан оларды пайдаланбауыңыз керек.

Таңба Сипаттама
Кез келген ақша белгісі Доллар белгісі, цент белгісі, евро белгісі, т.б.
+ Плюс белгісі
( Сол жақ жақша
: Қос нүкте
^ Циркумфлекс акценті (қақпақ белгісі)
' Апостроф
{ Сол жақ ирек жақша
< Азырақ белгісі
= Тең белгісі
- Минус белгісі
/ Қиғаш сызық белгісі
) Оң жақ жақша
& Амперсанд
~ Тильда
} Оң жақ ирек жақша
> Көбірек белгісі
  Бос орын таңбасы

Глобалдық бағдарламалар

Бұл Text функция бүкіл әлем бойынша танымал. Тілдердің кең уақымы үшін ол күндерді, уақыттарды, валюталарды және сандарды дұрыс жазу жолын біледі. Өз жұмысын істеу үшін оған екі ақпарат бөлігі керек:

  • Пайдаланушы пішімінің тілі: Жасаушылар үшін теңшелетін пішімді қалай түсіндіру керек? Бөлгіш таңбалар (. және ,) әртүрлі тілдерде әртүрлі мағыналарға ие. Егер теңшелетін пішімді көрсетсеңіз, сіз тіл толтырғышын қоса аласыз немесе құрылғы орнатылған тілді көрсететін әдепкі мәнді қабылдай аласыз. Одан да оңайырағы, сіз тілді білетін алдын ала анықталған күн/уақыт пішімдерінің біреуін пайдалана аласыз.
  • Нәтиженің тілі: Пайдаланушылар үшін функция нәтижесі қай тілде пайда болуы керек? Айлар мен жұмыс күндерінің атаулары бағдарламаның пайдаланушысы үшін тиісті тілде болуы керек, оны функцияға үшінші, қосымша аргументті Text қосу арқылы көрсетуге болады.

Екеуі де үшін тілді тіл тегін пайдалана отырып көрсетуге болады. Қолдау көрсетілетін тілдер тізімін көру үшін формула жолағына немесе оң жақ тақтаның Қосымша қойындысына ( 1234, "", ) теріпText, үшінші аргумент үшін ұсынылған тілдер тізімін айналдырыңыз.

Тіл толтырғышы

Теңшелетін пішімнің тілін көрсету үшін мынаны пайдаланыңыз:

Толтырғыш Сипаттама
[$-LanguageTag] LanguageTag бұл Тіл функциясынан қайтарылған тіл тегі. Ол тек тілді көрсете алады (мысалы, ағылшын тілі үшін [$-en]) немесе сонымен бірге аймақты көрсете алады (мысалы, одан әрі Ұлыбританияны көрсету үшін [$-en-GB]).

Тіл толтырғышы теңшелетін пішімде кез келген жерде көрінуі мүмкін, бірақ тек бір рет.

Егер сіз тіл толтырғышсыз теңшелетін пішімді көрсетсеңіз және пішім глобалдық тұрғыдан көпмағыналы болса, ағымдағы тілдің тіл тегі автоматты түрде кірістіріледі.

[$-en-US] қолданбаңыз іске қосылған кезде бұл толтырғыш жоқ болса деп есептеледі.

Ескертпе

Болашақ нұсқада осы толтырғыштың синтаксисі Excel қолдайтын ұқсас, бірақ басқа толтырғышпен шатастырмау үшін өзгеруі мүмкін.

Нәтиженің тіл тегі

Нәтижесі Text айларға, жұмыс күндеріне және AM / PM белгілеріне арналған аударылған жолдарды, сондай-ақ тиісті топтық және ондық бөлгіштерді қамтиды.

Әдепкі бойынша, Text қолданбаны іске қосатын пайдаланушының тілін пайдаланыңыз. Language функциясы ағымдағы пайдаланушының тіл тегін қайтарады. Үшінші аргумент Textүшін тіл тегін келтіру арқылы осы әдепкі мәнді ауыстыруға болады.

Синтаксис

Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )

  • NumberOrDateTime - Міндетті. Пішімдейтін сан немесе күн/уақыт мәні.
  • DateTimeFormat - Міндетті. DateTimeFormat санамалауының мүшесі.
  • ResultLanguageTag - Қосымша. Нәтиже мәтіні үшін пайдаланылатын тіл тегі. Әдепкі бойынша, ағымдағы пайдаланушың тілі пайдаланылады.

Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )

  • Сан - Міндетті. Пішімдейтін сан немесе күн/уақыт мәні.
  • CustomFormat - Міндетті. Қос тырнақшаға алынған бір немесе бірнеше толтырғыш.
  • ResultLanguageTag - Қосымша. Нәтиже мәтіні үшін пайдаланылатын тіл тегі. Әдепкі бойынша, ағымдағы пайдаланушың тілі пайдаланылады.

Text( Кез келген мән )

  • AnyValue - Міндетті. Мәтін көрінісіне түрлендіретін мән. Әдепкі пішім пайдаланылады.

Text ( Динамикалық )

  • Динамикалық - қажет. Сызықты білдіретін динамикалық мән. Қабылданатын мәндер жіктелмеген провайдерге байланысты. JSON үшін, егер динамикалық мән сан немесе логикалық мән болса, ол мәтінге түрлендіріледі.

Мысалдар

Басқалай көрсетілмесе, формулаларды орындайтын пайдаланушы Америка Құрама Штаттарында орналасқан және ағылшын тілін өз тілі ретінде таңдаған. Language функциясы "en-US" мәнін қайтарады.

Нөмірі

Формула Сипаттама Нәтиже
Text( 1234.59, "####.#" ) Санды бір ондық таңбамен пішімдейді. "1234,6"
Text( 8.9, "#.000" ) Қажет болса, санның бөлшек бөлігін соңындағы нөлдермен толтырады. "8,900"
Text( 0.631, "0.#" ) Қажет болса, санның бүтін сан бөлігін алдындағы нөлдермен толтырады. "0,6"
Text( 12, "#.0#" )
Text( 1234.568, "#.0#" )		 Санның ондық бөлігін бір ондық таңба үшін нөлдермен толтырады және егер берілген болса, екінші ондық таңбаны қосады. "12,0"
"1234,57"
Text( 12000, «$ #,###» )
Text( 1200000, «$ #,###» )		 Әр үш цифрдан кейін мыңдық бөлгішті қояды және ақша белгісін қосады. "$ 12 000"
"$ 1 200 000"

Күні/уақыты

  • 2:37:47 PM уақытында, дүйсенді, 23 қараша, 2015 күнінде
  • Америка Құрама Штаттары Тынық мұхиты уақыт белдеуі (UTC-8)
Формула Сипаттама Нәтиже
Text( Қазір (), DateTimeFormat.LongDate ) Ағымдағы пайдаланушының тілі мен аймағында ұзақ күн жолы түрінде пішімдейді. "Дүйсенбі, 23 қараша, 2015"
Text( қазір (), DateTimeFormat.LongDateTime ) 12 сағаттық сағатты пайдаланып, ағымдағы пайдаланушының тілі мен аймағында ұзақ күн және уақыт жолы түрінде пішімдейді. "Дүйсенбі, 23 қараша, 2015 2:37:47 PM"
Text( Қазір (), DateTimeFormat.LongTime24 ) 24 сағаттық сағатты пайдаланып, ұзын уақыт жолы түрінде пішімдейді. "14:37:47"
Text( Қазір (), DateTimeFormat.ShortDate ) Ағымдағы пайдаланушының тілі мен аймағында қысқа күн жолы түрінде пішімдейді. "11/23/2015"
Text( Қазір (), «д-ммм-гг» ) Толтырғыш таңбаларды пайдаланып пішімдейді:
  • d айдың бір таңбалы немесе екі таңбалы күні үшін
  • - нәтижеге көшірілген әріптік таңба ретінде
  • mmm айдың үш әріптік аббревиатурасы үшін
  • - нәтижеге көшірілген басқа әріптік таңба ретінде
  • yy жылдың екі таңбалы аббревиатурасы үшін
 "23-қар-15"
Text(1448318857 * 1000, «ммм. dd, yyyy (hh:mm:ss AM/PM)») Бастапқы мәнді 1000-ға көбейтсеңіз, адам оқи алатын пішімдегі Unix күн-уақыт мәнін көрсетеді. «Қараша 23, 2015 (02:47:37 PM)»

Глобалдық бағдарламалар

Формула Сипаттама Нәтиже
Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") Бос орынды топтау бөлгіші ретінде, үтірді ондық бөлгіш ретінде және € валюта белгісі ретінде көрсетеді. «1 234 567,89 €»
Text(1234567,89; "[$-fr-FR]# ###,## €") Егер бастапқы деректер үтірді ондық бөлгіш ретінде пайдаланатын француздық әдет-ғұрыпқа сәйкес болса, онда сіз өзіңіздің тіліңізді француз тіліне ауыстыруыңыз және жоғарыдағыдай нәтиже алу үшін аргументтерді үтірдің орнына нүктелі үтірмен бөлуіңіз керек. «1 234 567,89 €»
Text( Күн (2016,1,31), "dddd mmmm d" ) Ағымдағы пайдаланушының тілінде аптаның күнін, айды және күнді қайтарады. Толтырғыштардың ешқайсысы тілге тәуелді емес болғандықтан, пішімделген мәтіндік тіл тегінің қажеті жоқ. "Жексенбі, 31 қаңтар "
Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) "es-ES" тіліндегі аптаның күнін, айды және күнді қайтарады. «Доминго Энерго 31»

Мәндерді мәтінге түрлендіру

Формула Сипаттама Нәтиже
Text( 1234567.89 ) Санды жолға түрлендіреді. Ондық бөлгіштен бұрын немесе одан кейін мыңдық бөлгіштер жоқ немесе цифрлар санын басқару жоқ; көбірек басқару үшін екінші аргумент ретінде сандық толтырғыштарды беріңіз. "1234567,89"
Text( DateTimeValue ( "01/04/2003" ) ) Күн/уақыт мәнін мәтін жолына түрлендіреді. Түрлендіруді басқару үшін DateTimeFormat санамалауының бір мүшесін немесе теңшелетін пішімдегі жолды беріңіз. «1/4/2003 12:00»
Text( шындық ) Логиғалық мәнді жолға түрлендіреді. "true"
Text( GUID () ) Жасалған GUID мәнін жолға түрлендіреді. "f8b10550-0f12-4f08-9aa3-bb10958bc3ff"
Сол жақ( Text( GUID () ), 4 ) Жасалған GUID идентификаторының алғашқы төрт таңбасын қайтарады. "2d9c"
  • Last updated on