Споделяне чрез

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 enum Описание Примери (използване en-US)
Дълга дата Четирицифрена година, име на месец, ден от месеца и ден от седмицата. Имената на месеца и ден от седмицата не се съкращават. „Вторник, 7 април 2020 г.“
LongDateTime Четирицифрена година, име на месец, ден от месеца и ден от седмицата, плюс час (12-часов часовник), минути, секунди и AM / PM обозначение. Имената на месеца и ден от седмицата не се съкращават. „Вторник, 7 април 2020 г. 8:26:59 PM“
ДългаДатаЧас24 Четирицифрена година, месец, ден от месеца и ден от седмицата, плюс час (24-часов часовник), минути и секунди. Имената на месеца и ден от седмицата не се съкращават. „Вторник, 7 април 2020 г. 20:26:59“
Дългогодишен Час (12-часов часовник), минути, секунди и AM / PM обозначение. "8:26:59 ч."
Дългосрочен24 Час (24-часов часовник), минути, секунди. "20:26:59"
Кратка дата Четирицифрена година с цифров месец и ден от месеца. "4/7/2020"
ShortDateTime Четирицифрена година с числов месец и ден от месеца, плюс час (12-часов часовник), минути и AM / PM обозначение. "7.4.2020 г., 20:26 ч."
КъсаДатаЧас24 Четирицифрена година с числов месец и ден от месеца, плюс час (24-часов часовник) и минути. "4/7/2020 20:26"
Кратко време Час (12-часов часовник), минути и AM / PM обозначение. "20:26 ч."
КраткоВреме24 Час (24-часов часовник) и минути. "20:26"
UTC Стойността на дата / час се преобразува в UTC въз основа на часовата зона на текущия потребител и се форматира в съответствие със стандарта ISO 8601. "2020-04-08T03:26:59.180Z"

Контейнери на числа

Контейнер Описание
0 (нула) Показва незначителни нули, ако числото има по-малко цифри, отколкото има нули във формата. Например, използвайте формата #.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 както е. Допълнителните символи са запазени за бъдещи задържатели, така че не трябва да ги използвате.

Знак Описание
Всеки символ на валута Знак на долара, знак на цента, знак на евро и т.н.
+ Плюс знак
( Лява скоба
: Двоеточие
^ Circumflex акцент (карета)
' Апостроф
{ Лява къдрава скоба
< „По-малко от” знак
= Знак за равенство
- Знак минус
/ Наклонена черта
) Дясна скоба
& Амперсанд
~ Тилда
} Дясна къдрава скоба
> „По-голямо от” знак
  Знак за интервал

Глобални приложения

Функцията Text е глобално осведомена. За широк спектър от езици той знае как правилно да изписва дати, часове, валути и числа. За да си върши работата, тя се нуждае от две части информация:

  • Езикът на персонализирания формат: За производителите, как трябва да се интерпретира персонализиран формат? Разделителните знаци (. и ,) имат различно значение на различните езици. Ако посочите персонализиран формат, можете да включите езиков заместител или да вземете стойността по подразбиране, която отразява езика, на който е настроено устройството ви. Още по-лесно можете да използвате един от предварително определени формати за дата / час, които са езиков агностик.
  • Езикът на резултата: За потребителите, на какъв език трябва да се показва резултатът от функцията? Имената на месеците и работните дни трябва да са на подходящия език за потребителя на приложението, който можете да зададете, като добавите трети незадължителен аргумент към функцията Text .

И за двете зададете езика, като използвате language tag. За да видите списъка с поддържани езици, въведете Text( 1234, "", ) в лентата за формули или раздела Разширени на десния екран и след това превъртете през списъка с езиково-географски променливи, предложени за третия аргумент.

Заместител на език

За да посочите езика на персонализирания формат, използвайте:

Контейнер Описание
[$-LanguageTag] LanguageTag е езиков етикет, върнат от функцията Language . Той може да посочи само езика (като например [$-en] за английски) или може също така да посочи региона (като например [$-en-GB] за по-нататъшно уточняване на Великобритания).

Заместителят на езика може да се появи навсякъде в персонализиран формат, но само веднъж.

Ако посочите персонализиран формат без езиков заместител и форматът е двусмислен от глобална гледна точка, езиковият етикет за текущия ви език се вмъква автоматично.

[$-bg-US] се приема, ако този контейнер не присъства, когато приложението ви се изпълнява.

Бележка

В бъдеща версия синтаксисът на този заместител може да се промени, за да се избегне объркване с подобен, но различен, заместител на място, който Excel поддържа.

Етикет на езика на резултата

Резултатът от Text включва преведени низове за месеци, работни дни и обозначения am/PM, както и подходящите групи и десетични разделители.

По подразбиране използва езика на потребителя, Text който изпълнява приложението. Функцията Language връща маркера за език за текущия потребител. Можете да заместите тази стойност по подразбиране, като предоставите етикет за език за третия аргумент Textна .

Синтаксис

Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )

  • NumberOrDateTime - Задължително. Числото или стойността на датата / часа за форматиране.
  • DateTimeFormat - Задължително. Член на DateTimeFormat изброяване.
  • ResultLanguageTag - По избор. Езиковият маркер, който да се използва за резултата текст. По подразбиране се използва езикът на текущия потребител.

Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )

  • Брой - Задължително. Числото или стойността на датата / часа за форматиране.
  • CustomFormat - Задължително. Един или повече заместители, затворени в двойни кавички.
  • ResultLanguageTag - По избор. Езиковият маркер, който да се използва за резултата текст. По подразбиране се използва езикът на текущия потребител.

Text( AnyValue )

  • 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"

Date/Time

  • В 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 за едноцифрен или двуцифрен ден от месеца
  • - като литерален знак, копиран в резултата
  • МММ за трибуквено съкращение на месеца
  • - като друг литерален знак, копиран в резултата
  • yy за двуцифрено съкращение на годината
 "23-Nov-15"
Text(1448318857*1000, "ммм. dd, yyyy (hh:mm:ss AM/PM)") Показва стойността на Unix дата-време в четлив за човека формат, ако умножите стойността на източника на 1000. "23 ноември 2015 г. (02:47:37 ч.)"

Глобални приложения

Формула Описание Резултат
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". "доминго enero 31"

Преобразуване на стойности в текст

Формула Описание Резултат
Text( 1234567.89 ) Преобразува число в низ. Няма хиляди разделители или контрол върху броя цифри преди или след десетичния разделител; за по-голям контрол, като втори аргумент, заместители на номера на доставката. "1234567.89"
Text( DateTimeValue( "01/04/2003" ) Преобразува стойност на дата / час на текстов низ. За да контролирате преобразуването, въведете или член на изброяването DateTimeFormat или низ за персонализиран формат. "04.1.2003 г., 00:00 ч."
TextТова е вярно. Преобразува булева стойност в низ. "вярно"
Text( GUID() ) Преобразува стойност на генериран GUID в низ. "f8b10550-0f12-4f08-9aa3-bb10958bc3ff"
Left( Text( GUID() ), 4 ) Връща първите четири знака от генериран GUID. "2d9c"
  • Last updated on