Мәтін функциясы
Қолданылады:
Canvas apps Canvas apps Dataverse формула бағандары CLI моделі басқарылатын бағдарламалар Power Platform
Кез келген мәнді мәтін жолына түрлендіреді және санды немесе күн/уақыт мәнін мәтін жолы түрінде пішімдейді.
Сипаттама
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 пайдаланылған) |
|---|---|---|
| LongDate | Төрт цифрлық жыл, айдың атауы, айдың күні және аптаның күні. Айдың және апта күнінің атаулары қысқартылмайды. | "Сейсенбі, 7 сәуір, 2020" |
| LongDateTime | Төрт цифрлық жыл, айдың атауы, айдың күні және аптаның күні, сонымен қатар сағат (12 сағаттық сағат), минуттар, секундтар және AM/PM белгіленуі. Айдың және апта күнінің атаулары қысқартылмайды. | "Сейсенбі, 7 сәуір, 2020 8:26:59 PM" |
| LongDateTime24 | Төрт цифрлық жыл, ай, айдың күні және аптаның күні, сонымен қатар сағат (24 сағаттық сағат), минуттар және секундтар. Айдың және апта күнінің атаулары қысқартылмайды. | "Сейсенбі, 7 сәуір, 2020 20:26:59" |
| LongTime | Сағат (12 сағаттық сағат), минуттар, секундтар және AM/PM белгіленуі. | "8:26:59 PM" |
| LongTime24 | Сағат (24 сағаттық сағат), минуттар, секундтар. | "20:26:59" |
| ShortDate | Сандық ай және ай күні бар төрт цифрлық жыл. | "4/7/2020" |
| ShortDateTime | Сандық ай және айдың күні бар төрт цифрлық жыл, сонымен қатар сағат (12 сағаттық сағат), минуттар және AM/PM белгіленуі. | "4/7/2020 8:26 PM" |
| ShortDateTime24 | Сандық ай және айдың күні бар төрт цифрлық жыл, сонымен қатар сағат (24 сағаттық сағат) және минуттар. | "4/7/2020 20:26" |
| ShortTime | Сағат (12 сағаттық сағат), минуттар және AM/PM белгіленуі. | "8:26 PM" |
| ShortTime24 | Сағат (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 | Айды толық атауымен көрсетеді ( Қаңтар - Желтоқсан). |
| күн | Күнді алдыңғы нөлсіз сан түрінде көрсетеді. |
| dd | Күнді тиісті кезде алдыңғы нөл бар сан түрінде көрсетеді. |
| ddd | Күнді аббревиатура түрінде көрсетеді ( Жек - Сен). |
| dddd | Күнді толық атауымен көрсетеді ( Жексенбі - Сенбі). |
| yy | Жылды екі цифрлық сан түрінде көрсетеді. |
| yyyy | Жылды төрт цифрлық сан түрінде көрсетеді. |
| сағ | Сағатты алдыңғы нөлсіз сан түрінде көрсетеді. |
| hh | Сағатты тиісті кезде алдыңғы нөл бар сан түрінде көрсетеді. Егер пішім AM немесе PM сөзін қамтыса, сағат 12 сағаттық сағат негізінде көрсетіледі. Әйтпесе, сағат 24 сағаттық сағат негізінде көрсетіледі. |
| m | Минутты алдыңғы нөлсіз сан түрінде көрсетеді. Бұл толтырғыш h немесе hh кодынан кейін бірден болуы, я болмаса ss кодының тура алдында болуы керек; әйтпесе Text функциясы минуттардың орнына айды қайтарады. |
| mm | Минутты тиісті кезде алдыңғы нөл бар сан түрінде көрсетеді. Бұл толтырғыш h немесе hh толтырғышынан кейін бірден, я болмаса тура ss толтырғышының алдында болуы керек. Әйтпесе, Text функциясы минуттардың орнына айды қайтарады. |
| s | Секундты алдыңғы нөлсіз сан түрінде көрсетеді. |
| ss | Секундты тиісті кезде алдыңғы нөл бар сан түрінде көрсетеді. |
| f | Секундтың бөлшектерін көрсетеді. |
| AM/PM, a/p | 12 сағаттық сағат негізінде сағатты көрсетеді. Text aeyrwbzcs түн ортасынан түске дейінгі уақыттар үшін «AM» немесе «a», түстен түн ортасына дейін «PM» немесе «p» мәндерін қайтарады |
Литерал толтырғыштар
Сіз осы таңбалардың кез келгенін пішім жолына қоса аласыз. Олар Text функциясының нәтижесінде бар күйінде көрінеді. Қосымша таңбалар болашақ толтырғыштар үшін сақталған, сондықтан оларды пайдаланбауыңыз керек.
| Таңба | Сипаттама |
|---|---|
| Кез келген ақша белгісі | Доллар белгісі, цент белгісі, евро белгісі, т.б. |
| + | Плюс белгісі |
| ( | Сол жақ жақша |
| : | Қос нүкте |
| ^ | Циркумфлекс акценті (қақпақ белгісі) |
| ' | Апостроф |
| { | Сол жақ ирек жақша |
| < | Азырақ белгісі |
| = | Тең белгісі |
| - | Минус белгісі |
| / | Қиғаш сызық белгісі |
| ) | Оң жақ жақша |
| & | Амперсанд |
| ~ | Тильда |
| } | Оң жақ ирек жақша |
| > | Көбірек белгісі |
| Бос орын таңбасы |
Глобалдық бағдарламалар
Text функциясы глобалдық контекстті біледі. Тілдердің кең уақымы үшін ол күндерді, уақыттарды, валюталарды және сандарды дұрыс жазу жолын біледі. Өз жұмысын істеу үшін оған екі ақпарат бөлігі керек:
- Теңшелетін пішімнің тілі: жасаушылар үшін, теңшелетін пішім қалай түсіндірілуі керек? Бөлгіш таңбалар (. және ,) әртүрлі тілдерде әртүрлі мағыналарға ие. Егер теңшелетін пішімді көрсетсеңіз, сіз тіл толтырғышын қоса аласыз немесе құрылғы орнатылған тілді көрсететін әдепкі мәнді қабылдай аласыз. Одан да оңайырағы, сіз тілді білетін алдын ала анықталған күн/уақыт пішімдерінің біреуін пайдалана аласыз.
- Нәтиже тілі: пайдаланушылар үшін функцияның нәтижесі қай тілде көрінуі керек? Айлар мен жұмыс күндерінің атаулары бағдарламаның пайдаланушысы үшін тиісті тілде болуы керек, оны сіз Text функциясының үшінші, міндетті емес аргументі арқылы көрсете аласыз.
Екеуі де үшін тілді тіл тегін пайдалана отырып көрсетуге болады. Қолдау көрсетілетін тілдердің тізімін көру үшін формула жолағында немесе оң жақ тақтаның Кеңейтілген қойыншасында Text( 1234, "", ) деп теріңіз, содан кейін үшінші аргумент үшін ұсынылатын тілдер тізімі арқылы айналдырыңыз.
Тіл толтырғышы
Теңшелетін пішімнің тілін көрсету үшін мынаны пайдаланыңыз:
| Толтырғыш | Сипаттама |
|---|---|
| [$-LanguageTag] | LanguageTag — Language функциясынан қайтарылатын тіл тегі. Ол тек тілді көрсете алады (мысалы, ағылшын тілі үшін [$-en]) немесе сонымен бірге аймақты көрсете алады (мысалы, одан әрі Ұлыбританияны көрсету үшін [$-en-GB]). |
Тіл толтырғышы теңшелетін пішімде кез келген жерде көрінуі мүмкін, бірақ тек бір рет.
Егер сіз тіл толтырғышсыз теңшелетін пішімді көрсетсеңіз және пішім глобалдық тұрғыдан көпмағыналы болса, ағымдағы тілдің тіл тегі автоматты түрде кірістіріледі.
Бағдарламаңыз іске қосылғанда бұл толтырғыш болмаса, ол [$-en-US] деп есептеледі.
Ескертпе
Болашақ нұсқада осы толтырғыштың синтаксисі Excel қолдайтын ұқсас, бірақ басқа толтырғышпен шатастырмау үшін өзгеруі мүмкін.
Нәтиженің тіл тегі
Text функциясының нәтижесі айлардың, жұмыс күндерінің және AM / PM белгілерінің, сонымен бірге тиісті топтың және ондық бөлгіштердің аударылған жолдарын қамтиды.
Әдепкі бойынша Text бағдарламаны іске қосқан пайдаланушының тілін пайдаланады. Language функциясы ағымдағы пайдаланушының тіл тегін қайтарады. Бұл әдепкі мәнді Text функциясының үшінші аргументіне тіл тегін беру арқылы қайта анықтауға болады.
Синтаксис
Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )
- NumberOrDateTime - Міндетті. Пішімдейтін сан немесе күн/уақыт мәні.
- DateTimeFormat - Міндетті. DateTimeFormat санамалауының мүшесі.
- ResultLanguageTag - Міндетті емес. Нәтиже мәтіні үшін пайдаланылатын тіл тегі. Әдепкі бойынша, ағымдағы пайдаланушың тілі пайдаланылады.
Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )
- Number - Міндетті. Пішімдейтін сан немесе күн/уақыт мәні.
- CustomFormat - Міндетті. Қос тырнақшаға алынған бір немесе бірнеше толтырғыш.
- ResultLanguageTag - Міндетті емес. Нәтиже мәтіні үшін пайдаланылатын тіл тегі. Әдепкі бойынша, ағымдағы пайдаланушың тілі пайдаланылады.
Text( AnyValue )
- AnyValue - Міндетті. Мәтін көрінісіне түрлендіретін мән. Әдепкі пішім пайдаланылады.
Text ( Жіктелмеген )
- Untyped - Міндетті. Жіктелмеген нысан - жолды көрсетеді. Қабылданатын мәндер жіктелмеген провайдерге байланысты. 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( Now(), DateTimeFormat.LongDate ) | Ағымдағы пайдаланушының тілі мен аймағында ұзақ күн жолы түрінде пішімдейді. | "Дүйсенбі, 23 қараша, 2015" |
| Text( Now(), DateTimeFormat.LongDateTime ) | 12 сағаттық сағатты пайдаланып, ағымдағы пайдаланушының тілі мен аймағында ұзақ күн және уақыт жолы түрінде пішімдейді. | "Дүйсенбі, 23 қараша, 2015 2:37:47 PM" |
| Text( Now(), DateTimeFormat.LongTime24 ) | 24 сағаттық сағатты пайдаланып, ұзын уақыт жолы түрінде пішімдейді. | "14:37:47" |
| Text( Now(), DateTimeFormat.ShortDate ) | Ағымдағы пайдаланушының тілі мен аймағында қысқа күн жолы түрінде пішімдейді. | "11/23/2015" |
| Text( Now(), "d-mmm-yy" ) | Толтырғыш таңбаларды пайдаланып пішімдейді:
|
"23-қар-15" |
| Text(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") | Бастапқы мәнді 1000-ға көбейтсеңіз, адам оқи алатын пішімдегі Unix күн-уақыт мәнін көрсетеді. | "Nov. 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( Date(2016,1,31), "dddd mmmm d" ) | Ағымдағы пайдаланушының тілінде аптаның күнін, айды және күнді қайтарады. Толтырғыштардың ешқайсысы тілге тәуелді емес болғандықтан, пішімделген мәтіндік тіл тегінің қажеті жоқ. | "Жексенбі, 31 қаңтар " |
| Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) | "es-ES" тіліндегі аптаның күнін, айды және күнді қайтарады. | "domingo enero 31" |
Мәндерді мәтінге түрлендіру
| Формула | Сипаттама | Нәтиже |
|---|---|---|
| Text( 1234567.89 ) | Санды жолға түрлендіреді. Ондық бөлгіштен бұрын немесе одан кейін мыңдық бөлгіштер жоқ немесе цифрлар санын басқару жоқ; көбірек басқару үшін екінші аргумент ретінде сандық толтырғыштарды беріңіз. | "1234567,89" |
| Text( DateTimeValue( "01/04/2003" ) ) | Күн/уақыт мәнін мәтін жолына түрлендіреді. Түрлендіруді басқару үшін DateTimeFormat санамалауының бір мүшесін немесе теңшелетін пішімдегі жолды беріңіз. | "1/4/2003 12:00 AM" |
| Text( true ) | Логиғалық мәнді жолға түрлендіреді. | "true" |
| Text( GUID() ) | Жасалған GUID мәнін жолға түрлендіреді. | "f8b10550-0f12-4f08-9aa3-bb10958bc3ff" |
| Left( Text( GUID() ), 4 ) | Жасалған GUID идентификаторының алғашқы төрт таңбасын қайтарады. | "2d9c" |