Мәтіндік функция
Қолданылады:
Canvas қолданбалары Canvas қолданбалары Dataverse формула бағандары Үлгіге негізделген қолданбалар Power Pages Power Platform CLI
Кез келген мәнді мәтін жолына түрлендіреді және санды немесе күн/уақыт мәнін мәтін жолы түрінде пішімдейді.
Сипаттама
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 болса көрсетіледі. |
| . (нүкте) | Санда ондық нүктені көрсетеді. Теңшелетін пішімнің тіліне байланысты; қосымша мәліметтерді глобалдық бағдарламалар бөлімінен қараңыз. |
| , (үтір) | Санда жиі мыңдықтар үшін пайдаланылатын топтастыру бөлгішін көрсетеді. Мәтін егер пішімде сандық белгілермен (#) немесе нөлдермен қоршалған үтір болса, топтарды үтірмен бөледі. Теңшелетін пішімнің тіліне байланысты; қосымша мәліметтерді глобалдық бағдарламалар бөлімінен қараңыз. |
Егер санда ондық үтірдің оң жағында пішімдегі толтырғыштардан көбірек цифрлар болса, сан толтырғыштармен бірдей ондық таңбаларға дейін дөңгелектенеді. Егер ондық үтірдің сол жағында толтырғыштардан көбірек цифрлар болса, қосымша цифрлар көрсетіледі. Егер пішім ондық үтірдің сол жағында сандық белгілерді (#) қамтыса, 1-ден азырақ сандар ондық үтірден басталады (мысалы, ,47).
Күн мен уақыт толтырғыштары
| Толтырғыш | Сипаттама |
|---|---|
| м | Айды алдыңғы нөлсіз сан түрінде көрсетеді. |
| мм | Айды тиісті кезде алдыңғы нөл бар сан түрінде көрсетеді. |
| ммм | Айды аббревиатура түрінде көрсетеді ( Қаң - Жел). |
| мммм | Айды толық атауымен көрсетеді ( Қаңтар - Желтоқсан). |
| d | Күнді алдыңғы нөлсіз сан түрінде көрсетеді. |
| кк | Күнді тиісті кезде алдыңғы нөл бар сан түрінде көрсетеді. |
| кк | Күнді аббревиатура түрінде көрсетеді ( Жек - Сен). |
| ккк | Күнді толық атауымен көрсетеді ( Жексенбі - Сенбі). |
| yy | Жылды екі цифрлық сан түрінде көрсетеді. |
| жжжж | Жылды төрт цифрлық сан түрінде көрсетеді. |
| h | Сағатты алдыңғы нөлсіз сан түрінде көрсетеді. |
| сағ | Сағатты тиісті кезде алдыңғы нөл бар сан түрінде көрсетеді. Егер пішім AM немесе PM сөзін қамтыса, сағат 12 сағаттық сағат негізінде көрсетіледі. Әйтпесе, сағат 24 сағаттық сағат негізінде көрсетіледі. |
| м | Минутты алдыңғы нөлсіз сан түрінде көрсетеді. Бұл толтырғыш h немесе hh кодынан кейін бірден болуы, я болмаса ss кодының тура алдында болуы керек; әйтпесе Text функциясы минуттардың орнына айды қайтарады. |
| мм | Минутты тиісті кезде алдыңғы нөл бар сан түрінде көрсетеді. Бұл толтырғыш h немесе hh толтырғышынан кейін бірден, я болмаса тура ss толтырғышының алдында болуы керек. Әйтпесе, Text функциясы минуттардың орнына айды қайтарады. |
| с | Секундты алдыңғы нөлсіз сан түрінде көрсетеді. |
| сс | Секундты тиісті кезде алдыңғы нөл бар сан түрінде көрсетеді. |
| f | Секундтың бөлшектерін көрсетеді. |
| AM/PM, a/p | 12 сағаттық сағат негізінде сағатты көрсетеді. Мәтін түн ортасынан түске дейінгі уақыт үшін "AM" немесе "a", түстен түн ортасына дейінгі уақыт үшін "PM" немесе "p" мәнін береді. |
Литерал толтырғыштар
Сіз осы таңбалардың кез келгенін пішім жолына қоса аласыз. Олар Text функциясының нәтижесінде бар күйінде көрінеді. Қосымша таңбалар болашақ толтырғыштар үшін сақталған, сондықтан оларды пайдаланбауыңыз керек.
| Таңба | Сипаттама |
|---|---|
| Кез келген ақша белгісі | Доллар белгісі, цент белгісі, евро белгісі, т.б. |
| + | Плюс белгісі |
| ( | Сол жақ жақша |
| : | Қос нүкте |
| ^ | Циркумфлекс акценті (қақпақ белгісі) |
| ' | Апостроф |
| { | Сол жақ ирек жақша |
| < | Азырақ белгісі |
| = | Тең белгісі |
| - | Минус белгісі |
| / | Қиғаш сызық белгісі |
| ) | Оң жақ жақша |
| & | Амперсанд |
| ~ | Тильда |
| } | Оң жақ ирек жақша |
| > | Көбірек белгісі |
| Бос орын таңбасы |
Глобалдық бағдарламалар
Text функциясы глобалдық контекстті біледі. Тілдердің кең уақымы үшін ол күндерді, уақыттарды, валюталарды және сандарды дұрыс жазу жолын біледі. Өз жұмысын істеу үшін оған екі ақпарат бөлігі керек:
- Пайдаланушы пішімінің тілі: Жасаушылар үшін теңшелетін пішімді қалай түсіндіру керек? Бөлгіш таңбалар (. және ,) әртүрлі тілдерде әртүрлі мағыналарға ие. Егер теңшелетін пішімді көрсетсеңіз, сіз тіл толтырғышын қоса аласыз немесе құрылғы орнатылған тілді көрсететін әдепкі мәнді қабылдай аласыз. Одан да оңайырағы, сіз тілді білетін алдын ала анықталған күн/уақыт пішімдерінің біреуін пайдалана аласыз.
- Нәтиженің тілі: Пайдаланушылар үшін функция нәтижесі қай тілде пайда болуы керек? Айлар мен жұмыс күндерінің атаулары бағдарламаның пайдаланушысы үшін тиісті тілде болуы керек, оны сіз Text функциясының үшінші, міндетті емес аргументі арқылы көрсете аласыз.
Екеуі де үшін тілді тіл тегін пайдалана отырып көрсетуге болады. Қолдау көрсетілетін тілдердің тізімін көру үшін формула жолағында немесе оң жақ тақтаның Кеңейтілген қойыншасында Text( 1234, "", ) деп теріңіз, содан кейін үшінші аргумент үшін ұсынылатын тілдер тізімі арқылы айналдырыңыз.
Тіл толтырғышы
Теңшелетін пішімнің тілін көрсету үшін мынаны пайдаланыңыз:
| Толтырғыш | Сипаттама |
|---|---|
| [$-LanguageTag] | LanguageTag бұл Тіл функциясынан қайтарылған тіл тегі. Ол тек тілді көрсете алады (мысалы, ағылшын тілі үшін [$-en]) немесе сонымен бірге аймақты көрсете алады (мысалы, одан әрі Ұлыбританияны көрсету үшін [$-en-GB]). |
Тіл толтырғышы теңшелетін пішімде кез келген жерде көрінуі мүмкін, бірақ тек бір рет.
Егер сіз тіл толтырғышсыз теңшелетін пішімді көрсетсеңіз және пішім глобалдық тұрғыдан көпмағыналы болса, ағымдағы тілдің тіл тегі автоматты түрде кірістіріледі.
[$-en-US] қолданбаңыз іске қосылған кезде бұл толтырғыш жоқ болса деп есептеледі.
Ескертпе
Болашақ нұсқада осы толтырғыштың синтаксисі Excel қолдайтын ұқсас, бірақ басқа толтырғышпен шатастырмау үшін өзгеруі мүмкін.
Нәтиженің тіл тегі
Text функциясының нәтижесі айлардың, жұмыс күндерінің және AM / PM белгілерінің, сонымен бірге тиісті топтың және ондық бөлгіштердің аударылған жолдарын қамтиды.
Әдепкі бойынша Text бағдарламаны іске қосқан пайдаланушының тілін пайдаланады. Language функциясы ағымдағы пайдаланушының тіл тегін қайтарады. Бұл әдепкі мәнді Text функциясының үшінші аргументіне тіл тегін беру арқылы қайта анықтауға болады.
Синтаксис
Мәтін( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ])
- NumberOrDateTime - Міндетті. Пішімдейтін сан немесе күн/уақыт мәні.
- DateTimeFormat - Міндетті. DateTimeFormat санамалауының мүшесі.
- ResultLanguageTag - Қосымша. Нәтиже мәтіні үшін пайдаланылатын тіл тегі. Әдепкі бойынша, ағымдағы пайдаланушың тілі пайдаланылады.
Мәтін( NumberOrDateTime, Теңшелетін пішім [, Нәтиже тілінің тегі ])
- Сан - Міндетті. Пішімдейтін сан немесе күн/уақыт мәні.
- CustomFormat - Міндетті. Қос тырнақшаға алынған бір немесе бірнеше толтырғыш.
- ResultLanguageTag - Қосымша. Нәтиже мәтіні үшін пайдаланылатын тіл тегі. Әдепкі бойынша, ағымдағы пайдаланушың тілі пайдаланылады.
Мәтін( Кез келген мән )
- AnyValue - Міндетті. Мәтін көрінісіне түрлендіретін мән. Әдепкі пішім пайдаланылады.
Мәтін ( Типтелмеген )
- Терілмеген - Міндетті. жіктелмеген нысан ол жолды білдіреді. Қабылданатын мәндер жіктелмеген провайдерге байланысты. JSON үшін, егер жіктелмеген нысан сан немесе логикалық болса, ол мәтінге түрлендіріледі.
Мысалдар
Басқалай көрсетілмесе, формулаларды орындайтын пайдаланушы Америка Құрама Штаттарында орналасқан және ағылшын тілін өз тілі ретінде таңдаған. Language функциясы "en-US" мәнін қайтарады.
Нөмірі
| Формула | Сипаттама | Нәтиже |
|---|---|---|
| Мәтін( 1234.59, "####.#" ) | Санды бір ондық таңбамен пішімдейді. | "1234,6" |
| Мәтін( 8.9, "#.000" ) | Қажет болса, санның бөлшек бөлігін соңындағы нөлдермен толтырады. | "8,900" |
| Мәтін( 0,631, "0.#" ) | Қажет болса, санның бүтін сан бөлігін алдындағы нөлдермен толтырады. | "0,6" |
|
Мәтін( 12, "#.0#" ) Мәтін( 1234.568, "#.0#" ) |
Санның ондық бөлігін бір ондық таңба үшін нөлдермен толтырады және егер берілген болса, екінші ондық таңбаны қосады. | "12,0" "1234,57" |
|
Мәтін( 12000, "$ #,###" ) Мәтін( 1200000, "$ #,###" ) |
Әр үш цифрдан кейін мыңдық бөлгішті қояды және ақша белгісін қосады. | "$ 12 000" "$ 1 200 000" |
Күні/Уақыты
- 2:37:47 PM уақытында, дүйсенді, 23 қараша, 2015 күнінде
- Америка Құрама Штаттары Тынық мұхиты уақыт белдеуі (UTC-8)
| Формула | Сипаттама | Нәтиже |
|---|---|---|
| Мәтін( Қазір(), DateTimeFormat.LongDate ) | Ағымдағы пайдаланушының тілі мен аймағында ұзақ күн жолы түрінде пішімдейді. | "Дүйсенбі, 23 қараша, 2015" |
| Мәтін( Қазір(), DateTimeFormat.LongDateTime ) | 12 сағаттық сағатты пайдаланып, ағымдағы пайдаланушының тілі мен аймағында ұзақ күн және уақыт жолы түрінде пішімдейді. | "Дүйсенбі, 23 қараша, 2015 2:37:47 PM" |
| Мәтін( Қазір(), DateTimeFormat.LongTime24 ) | 24 сағаттық сағатты пайдаланып, ұзын уақыт жолы түрінде пішімдейді. | "14:37:47" |
| Мәтін( Қазір(), DateTimeFormat.ShortDate ) | Ағымдағы пайдаланушының тілі мен аймағында қысқа күн жолы түрінде пішімдейді. | "11/23/2015" |
| Мәтін( Қазір(), "д-мм-жж" ) | Толтырғыш таңбаларды пайдаланып пішімдейді:
|
"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 €" |
| Мәтін( Date(2016,1,31), "dddd mmmm d" ) | Ағымдағы пайдаланушының тілінде аптаның күнін, айды және күнді қайтарады. Толтырғыштардың ешқайсысы тілге тәуелді емес болғандықтан, пішімделген мәтіндік тіл тегінің қажеті жоқ. | "Жексенбі, 31 қаңтар " |
| Мәтін( Date(2016,1,31), "dddd mmmm d", "es-ES" ) | "es-ES" тіліндегі аптаның күнін, айды және күнді қайтарады. | "domingo enero 31" |
Мәндерді мәтінге түрлендіру
| Формула | Сипаттама | Нәтиже |
|---|---|---|
| Мәтін ( 1234567.89 ) | Санды жолға түрлендіреді. Ондық бөлгіштен бұрын немесе одан кейін мыңдық бөлгіштер жоқ немесе цифрлар санын басқару жоқ; көбірек басқару үшін екінші аргумент ретінде сандық толтырғыштарды беріңіз. | "1234567,89" |
| Мәтін( DateTimeValue( "01/04/2003" ) ) | Күн/уақыт мәнін мәтін жолына түрлендіреді. Түрлендіруді басқару үшін DateTimeFormat санамалауының бір мүшесін немесе теңшелетін пішімдегі жолды беріңіз. | "1/4/2003 12:00 AM" |
| Мәтін (шын) | Логиғалық мәнді жолға түрлендіреді. | "true" |
| Мәтін( GUID() ) | Жасалған GUID мәнін жолға түрлендіреді. | "f8b10550-0f12-4f08-9aa3-bb10958bc3ff" |
| Сол жақ( Мәтін( GUID() ), 4 ) | Жасалған GUID идентификаторының алғашқы төрт таңбасын қайтарады. | "2d9c" |