Поділитися через

Текстова функція

  • Стаття

Застосовується до: програм Canvas Стовпців Dataverse формул програм Canvas Командного 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)
Довга дата Чотиризначний рік, назва місяця, день місяця і день тижня. Назви місяця та дня тижня не скорочені. "Вівторок, 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"
LongTime24 Година (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 (нуль) Відображає неважливі нулі, якщо число містить менше цифр, ніж є нулів у форматі. Наприклад, використовуйте формат #.00, якщо потрібно показати 8.9 як 8.90.
# Дотримується тих самих правил, що й 0 (нуль). Проте Text не повертає зайвих нулів, якщо число містить менше цифр з будь-якого боку десяткового роздільника, ніж символів # у форматі. Наприклад, 8.9 відображається, якщо за допомогою настроюваного формату #.## форматується число 8.9.
. (крапка) Відображає десятковий роздільник у числі. Залежить від мови настроюваного формату; додаткові відомості див. в глобальних програмах.
, (кома) Відображає груповий роздільник у числі, що часто використовується для тисяч. Текст розділяє групи комами, якщо формат містить кому, оточену числовими знаками (#) або нулями. Залежить від мови настроюваного формату; додаткові відомості див. в глобальних програмах.

Якщо в числі більше цифр праворуч від десяткового роздільника, ніж заповнювачів у форматі, число округляється до стількох знаків після коми, скільки є заповнювачів. Якщо цифр ліворуч від десяткового роздільника більше, ніж заповнювачів, відображатимуться всі цифри. Якщо формат містить лише знаки номера (#) ліворуч від десяткового роздільника, числа менше 1 починаються десятковим роздільником (наприклад, .47).

Заповнювачі дати й часу

Заповнювач Опис
m Відображає місяць у вигляді числа без нуля на початку.
Мм Відображає місяць у вигляді числа з нулем на початку у відповідних випадках.
Ммм Відображає місяць як абревіатуру (січ–гру).
Мммм Відображає повну назву місяця (січень–грудень).
d Відображає день у вигляді числа без нуля на початку.
Дд Відображає день у вигляді числа з нулем на початку у відповідних випадках.
ДДД Відображає день як абревіатуру (пн–нд).
dddd Відображає повну назву дня (понеділок–неділя).
Рр Відображає рік як двозначне число.
рррр Відображає рік як чотиризначне число.
h Відображає годину у вигляді числа без нуля на початку.
Г.Ч. Відображає годину у вигляді числа з нулем на початку у відповідних випадках. Якщо формат містить AM або PM, година відображається в 12-годинному форматі. В іншому разі година відображається в 24-годинному форматі.
m Відображає хвилини у вигляді числа без нуля на початку.

Цей заповнювач має з’являтися відразу після коду h чи hh або відразу перед кодом ss. інакше функція Text поверне місяць, а не хвилини.
Мм Відображає хвилини у вигляді числа з нулем на початку у відповідних випадках.

Цей заповнювач має з’являтися відразу після заповнювача h чи hh або відразу перед заповнювачем ss. В іншому разі функція Text поверне місяць, а не хвилини.
s Відображає секунди у вигляді числа без нуля на початку.
Сс Відображає секунди у вигляді числа з нулем на початку у відповідних випадках.
f Відображає частки секунд.
AM/PM, а/п Відображає годину в 12-годинному форматі. Текст повертає «AM» або «a» для часу з півночі до полудня та «PM» або «p» для часу від полудня до півночі

Заповнювачі для літералів

У рядок формату можна додати будь-які з цих символів. Вони відобразяться в результаті функції Text без змін. Додаткові символи зарезервовано для майбутніх заповнювачів, тому їх не можна використовувати.

Символ Опис
Будь-який символ грошової одиниці Знак долара, знак цента, знак євро тощо.
+ Знак "плюс"
( Ліва кругла дужка
: Двокрапка
^ Діакритичний знак (кришка)
’ Апостроф
{ Ліва фігурна дужка
< Знак "менше"
= Знак рівності
- Знак "мінус"
/ Скісна риска
) Права кругла дужка
& Амперсанд
~ Тильда
} Права фігурна дужка
> Знак "більше"
  Символ пробілу

Глобальні програми

Функція Text орієнтується на весь світ. Вона вміє правильно писати дати, час, грошові одиниці та числа для широкого набору мов. Для роботи їй потрібні такі дані:

  • Мова користувальницького формату: Для виробників, як слід інтерпретувати користувальницький формат? Символи-роздільники (. і ,) мають різні значення в різних мовах. Якщо ви вказали настроюваний формат, ви можете включити заповнювач мови або скористатися стандартним значенням, яке відповідає мові вашого пристрою. Або ще простіше: ви можете використати один із попередньо визначених форматів дати/часу, які незалежні від мови.
  • Мова результату: Для користувачів, якою мовою повинен відображатися результат функції? Назви місяців і днів тижня мають відображатися відповідною мовою для користувача програми, яку можна вказати, додаючи третій, необов’язковий аргумент до функції Text.

Для обох параметрів ви вказуєте мову за допомогою тега мови. Щоб переглянути список підтримуваних мов, введіть Text( 1234, "", ) у рядку формул або на вкладці Додатково в області праворуч, а потім прокрутіть список мов, що пропонуються для третього аргументу.

Заповнювач мови

Щоб вказати мову настроюваного формату, використайте:

Заповнювач Опис
[$-LanguageTag] LanguageTag — це language тег, який повертається з функції 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 ] )

  • Кількість - обов’язковий. Число або значення дати й часу для форматування.
  • CustomFormat - Обов’язковий. Один або кілька заповнювачів, взятих у подвійні лапки.
  • ResultLanguageTag - необов’язковий. Тег мови для тексту результату. За замовчуванням використовується мова поточного користувача.

Text( Будь-яке значення )

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

Глобальні програми

Формула Опис Результат
Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") Показує пробіл як роздільник групування, кому як десятковий роздільник і € як символ грошової одиниці. "1 234 567,89 €"
Текст(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"

Перетворення значень на текст

Формула Опис Результат
Текст( 1234567.89 ) Перетворює число на рядок. Немає розділювачів тисяч і контролю над кількістю цифр до або після десяткового роздільника; для більшого контролю вкажіть кількість заповнювачів як другий аргумент. "1234567.89"
Text( DateTimeValue( "01/04/2003" ) ) Перетворює значення дати й часу на рядок тексту. Щоб керувати перетворенням, укажіть елемент переліку DateTimeFormat або рядок у настроюваному форматі. "1/4/2003 12:00 AM"
Текст( правда ) Перетворює логічне значення на рядок. "true"
Текст( GUID() ) Перетворює значення згенерованого ідентифікатора GUID на рядок. "f8b10550-0f12-4f08-9aa3-bb10958bc3ff"
Ліворуч( Текст( GUID() ), 4 ) Повертає перші чотири символи згенерованого ідентифікатора GUID. "2d9c"