Делите путем

Функција "Текст"

  • Чланак

Важи за: Цанвас апликације Цанвас апликације формула Dataverse цолумнс Модел-дривен аппс Power Pages Power Platform ЦЛИ

Конвертује било коју вредност и форматира број или вредност датума/времена у ниску текста.

Опис

Функција Text обликује број или вредност датума/времена на основу једне од ових врста аргумената:

  • Унапред дефинисани формат датума/времена који задајете помоћу набрајања DateTimeFormat. За датуме и времена, овај приступ је пожељан јер се аутоматски прилагођава језику и региону сваког корисника.
  • Прилагођени формат, који садржи низ резервних места који дефинишу, на пример, да ли бројеви приказују децимални сепаратор, а датуми показују пуно име месеца, месец као скраћеницу или месец као број. Power Apps подржава подскуп чувара места који подржава Microsoft Excel. У овом низу, чувар места за језик одређује језик на којем се тумаче остала места. Ако прилагођени формат има тачку, на пример, чувар места формата језика одређује да ли је тачка децимални сепаратор (ja-JP) или сепаратор за хиљаде (es-ES).

Погледајте рад са датумима и временима за више информација.

Функција Text такође може да конвертује било који тип података у текстуално представљање користећи подразумевани формат. Користите ово да бисте пренели нетекстуалне вредности на функције засноване на тексту, као што су Len, Right и IsMatch.

Унапред дефинисани формати датума/времена

За ове примере, коришћени датум и време су уторак, 7. април 2020 20: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 (zero) Приказује безначајне нуле ако број има мање цифара него нула у формату. На пример, користите формат #.00 ако желите да се 8.9 прикаже као 8,90.
# Следи иста правила као и 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.

За оба можете одредити језик користећи језичку ознаку. Да бисте видели листу подржаних језика, откуцајте 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 )

  • Untyped - Обавезно. Нетипизиран објекат који представља ниску. Прихватљиве вредности зависе од добављача нетипизираног садржаја. За ЈСОН , ако < ДИЦТ__нетипизирани објекат > унтyпед објецт је број или логичка, биће конвертована у текст.

Примери

Уколико није другачије назначено, корисник који покреће ове формуле налази се у Сједињеним Државама и за свој је језик одабрао енглески. Функција 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" ) Обликује помоћу знакова чувара места:
  • d за једноцифрен или двоцифрени дан у месецу
  • - као литерал знак копиран у резултат
  • mmm за скраћеницу за месец од три слова
  • - као други литерал знак копиран у резултат
  • yy за двоцифрену скраћеницу године
 "23-Nov-15"
Text(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") Приказује Unix вредност датум-време у читљивом формату ако помножите изворну вредност са 1.000. "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" ) Враћа радни дан, месец и дан у месецу на језику тренутног корисника. Будући да ниједан чувар места не зависи од језика, нема потребе за форматирањем језика ознаке текста. "Sunday January 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 ) Претвара Boolean вредносту у ниску. "true"
Text( GUID() ) Претвара генерисани GUID вредносту у ниску. "f8b10550-0f12-4f08-9aa3-bb10958bc3ff"
Left( Text( GUID() ), 4 ) Враћа прва четири знака генерисаног GUID. "2d9c"