Справка по формулам - Power Apps
В этой статье вы узнаете обо всех функциях, доступных в Power Apps.
Формулы в Power Apps объединяют множество элементов. Ниже перечислены следующие элементы:
- Функции принимают параметры, выполняют операцию и возвращают значение. Например, Sqrt(25) возвращает значение 5. Функции строятся наподобие функций Microsoft Excel. Некоторые функции вызывают побочные действия, такие как SubmitForm, что должно происходить только в формуле поведения, такой как Button.OnSelect.
- Сигналы возвращают сведения о среде. Например, Location возвращает текущие GPS-координаты устройства. Сигналы не принимают параметры и не вызывают побочные действия.
- Перечисления возвращают предопределенные постоянные значения. Например, Color является перечислением с предопределенными значениями, такими как Color.Red, Color.Blue и т. д. Здесь приводятся общие перечисления, а описания перечислений для конкретных функций приводятся в описаниях самих функций.
- Именованные операторы, такие как ThisItem и Self, предоставляют доступ к сведениям из контейнера.
К другим элементам относятся:
а
Abs — абсолютное значение числа.
Acceleration — считывает данные с датчика ускорения на устройстве.
Acos — возвращает арккосинус числа (в радианах).
Acot — возвращает арккотангенс числа (в радианах).
AddColumns — возвращает таблицу с добавленными столбцами.
And — логическая функция AND. Возвращает значение true, если все аргументы принимают значение true. Также можно использовать оператор &&.
AIClassify — классифицирует текст по одной или нескольким категориям.
AIExtract — извлекает указанные сущности, такие как регистрационные номера, номера телефонов или имена людей.
AIReply — составление черновика ответа на предоставленное вами сообщение.
AISentiment — определяет тональность текста, который вы предоставляете.
AISummarize — обобщение предоставленного вами текста.
AITranslate — переводит текст с другого языка.
App — предоставляет сведения о работающем в настоящее время приложении и позволяет управлять его поведением.
Asin — возвращает арксинус числа (в радианах).
Assert — выражение принимает значение true или false во время тестирования.
As — называет текущую запись в функциях коллекции, формы и области записи, таких как ForAll, With и Sum.
AsType — обрабатывает ссылку на запись как конкретный тип таблицы.
Atan — возвращает арктангенс числа (в радианах).
Atan2 — возвращает арктангенс на основе координаты (x,y) (в радианах).
Average — вычисляет среднее значение табличного выражения или набора аргументов.
B
Back — отображает предыдущий экран.
Blank — возвращает пустое значение, которое может использоваться для вставки значения NULL в источник данных.
Boolean — преобразует текстовую строку, число или нетипизированное значение в логическое значение.
О
Calendar — извлекает календарные данные для текущего значения языкового стандарта.
Char — преобразует код знака в строку.
Choices — возвращает таблицу из возможных значений для столбца подстановки.
Clear — удаляет все данные из коллекции.
ClearCollect — удаляет все данные из коллекции, а затем добавляет набор записей.
ClearData — удаляет коллекцию или все коллекции с узла приложения, такого как локальное устройство.
Clock — извлекает сведения о времени для текущего значения языкового стандарта.
Coalesce — заменяет пустые значения, оставляя непустые значения без изменений.
Collect — создает коллекцию или добавляет данные в источник данных.
Color — задает свойство для встроенного значения цвета.
ColorFade — изменяет значение цвета, делая его более светлым или темным.
ColorValue — преобразует имя цвета CSS или шестнадцатеричный код в значение цвета.
Столбец. Извлекает имена и значения столбцов из типа данных "Нетипизированный объект".
ColumnNames. Извлекает имена и значения столбцов из типа данных "Нетипизированный объект".
Compass — возвращает направление по компасу.
Concat — объединяет строки в источнике данных.
Concatenate — объединяет строки.
Concurrent — оценивает несколько формул одновременно.
Connection — возвращает сведения о сетевом подключении.
Copy — копирует текст в буфер обмена на устройстве, на котором запущено приложение.
Count — подсчитывает количество записей в таблице, которые содержат числа.
Cos — возвращает косинус угла, указанного в радианах.
Cot — возвращает котангенс угла, указанного в радианах.
CountA — подсчитывает количество записей в таблице, которые не являются пустыми.
CountIf — подсчитывает количество записей в таблице, удовлетворяющих определенному условию.
CountRows — подсчитывает количество записей в таблице.
D
DataSourceInfo — предоставляет сведения об источнике данных.
Date — возвращает значение даты и времени на основе значений Year, Month и Day.
DateAdd — добавляет к значению даты и времени дни, месяцы, кварталы или года.
DateDiff — вычитает два значения даты и показывает результат в днях, месяцах, кварталах или годах.
DateTime — возвращает значение даты и времени на основе и компонента даты, и компонента времени.
DateTimeValue — преобразует строку даты и времени в значение даты и времени.
DateValue — преобразует строку формата ''только дата'' в значение даты и времени.
Day — извлекает сведения о дате из значения даты и времени.
Dec2Hex — преобразовывает число в шестнадцатеричную текстовую строку.
Defaults — возвращает значения по умолчанию для источника данных.
Degrees — преобразовывает радианы в градусы.
Disable — отключает сигнал, например Location для считывания GPS-координат.
Distinct — вычисляет итоговые значения для записей таблицы, удаляя дубликаты.
Download — скачивает файл из Интернета на локальное устройство.
DropColumns — возвращает таблицу, удаляя из нее один или несколько столбцов.
E
EDate — добавляет или вычитает месяцы из даты, не меняя день месяца.
EditForm — сбрасывает элемент управления формы для редактирования элемента.
Enable — включает сигнал, например Location для считывания GPS-координат.
EncodeUrl — кодирует специальные символы с помощью кодировки URL.
EndsWith — проверяет, заканчивается ли одна текстовая строка другой.
EOMonth — добавляет или вычитает месяцы из даты, возвращая последний день этого месяца.
Error — создать пользовательскую ошибку или пройти через ошибку.
Errors — предоставляет сведения об ошибках для предыдущих изменений источника данных.
exactin — проверяет, содержится ли текстовая строка в другой текстовой строке или таблице, с учетом регистра. Также используется для проверки наличия записи в таблице.
Exit — закрывает текущее запущенное приложение и, при необходимости, производит выход текущего пользователя.
Exp — возвращает число e, возведенное в указанную степень.
F
Filter — возвращает таблицу, отфильтрованную на основе одного или нескольких критериев.
Find — проверяет, находится ли одна строка внутри другой, и возвращает расположение.
First — возвращает первую запись таблицы.
FirstN — возвращает первый набор записей (N записей) таблицы.
ForAll — вычисляет значения и выполняет действия для всех записей в таблице.
G
GroupBy — возвращает таблицу со сгруппированными записями.
GUID — преобразует строку GUID в значение GUID или создает новое значение GUID.
H
HashTags — извлекает из строки хэш-теги (#strings).
Hex2Dec — преобразовывает шестнадцатеричную текстовую строку в число.
Host — предоставляет информацию о текущем хосте, на котором запущено приложение.
Hour — возвращает данные времени в часах из значения даты и времени.
I
If — возвращает одно значение, если условие выполняется, и другое, если то же условие не выполняется.
IfError — обнаруживает ошибки и предоставляет альтернативное значение или выполняет действие.
in — проверяет, содержится ли текстовая строка в другой текстовой строке или таблице, без учета регистра. Также используется для проверки наличия записи в таблице.
Index — возвращает запись из таблицы на основе упорядоченной позиции.
Int — округляет значение вниз до ближайшего целого.
IsBlank — проверяет наличие пустого значения.
IsBlankOrError — проверяет на пустое значение или ошибку.
IsEmpty — проверяет наличие пустых таблиц.
IsError — проверяет на наличие ошибки.
IsMatch — проверяет строку на соответствие определенному шаблону. Можно использовать регулярные выражения.
IsNumeric — проверяет, является ли значение числовым.
ISOWeekNum — возвращает номер недели в формате ISO для значения даты и времени.
IsToday — проверяет, соответствует ли значение даты/времени текущему времени в часовом поясе пользователя.
IsType — проверяет, указывает ли ссылка на запись на конкретный тип таблицы.
IsUTCToday — проверяет, соответствует ли значение даты/времени сегодняшнему дню в формате UTC.
J
JSON — создает текстовую строку JSON для таблицы, записи или значения.
L
Language — возвращает тег языка текущего пользователя.
Last — возвращает последнюю запись таблицы.
LastN — возвращает последний набор записей (N записей) таблицы.
Launch — запускает веб-страницу или приложение на основе холста.
Left — возвращает левую часть строки.
Len — возвращает длину строки.
Ln — возвращает натуральный логарифм.
LoadData — загружает коллекцию с узла приложения, такого как локальное устройство.
Location — возвращает расположение в виде координат на карте, используя глобальную навигационную спутниковую систему (GPS) и другие сведения.
Log — Возвращает логарифм по любому основанию числа.
LookUp — выполняет поиск одной записи в таблице, основываясь на одном или нескольких критериях.
Lower — преобразует буквы текстовой строки во все строчные.
M
Match — извлекает подстроку на основе шаблона. Можно использовать регулярные выражения.
MatchAll — извлекает несколько подстрок на основе шаблона. Можно использовать регулярные выражения.
Max — максимальное значение табличного выражения или набора аргументов.
Mid — возвращает среднюю часть строки.
Min — минимальное значение табличного выражения или набора аргументов.
Minute — возвращает данные времени в минутах из значения даты и времени.
Mod — возвращает остаток от деления одного числа на другое.
Month — извлекает сведения о месяце из значения даты и времени.
N
Navigate — изменяет отображаемый экран.
NewForm — сбрасывает элемент управления формы для создания элемента.
Not — логическая функция NOT. Возвращает значение true, если ее аргумент принимает значение false, и возвращает false, если ее аргумент принимает значение true. Также можно использовать оператор !.
Notify — отображает баннер с сообщением для пользователя.
Now — возвращает текущее значение даты/времени в часовом поясе пользователя.
O
Or — логическая функция OR. Возвращает значение true, если хотя бы один из ее аргументов принимает значение true. Также можно использовать оператор ||.
P
Param — доступ к параметрам, передаваемым приложению на основе холста при запуске.
Parent — предоставляет доступ к свойствам элемента управления контейнера.
ParseJSON – Преобразует документ JSON, представленный в виде текста, в значение Нетипизированный объект.
Patch — изменяет или создает запись в источнике данных или объединяет записи вне источника данных.
PDF — Экспорт содержимого с текущего экрана в объект для использования в нескольких сценариях.
Pi — возвращает значение числа π.
PlainText — удаляет из строки HTML- и XML-теги.
Power — возвращает число, возведенное в степень. Также можно использовать оператор ^.
Proper — преобразует в строке первую букву каждого слова в прописную, а остальные буквы преобразует в строчные.
R
Radians — преобразовывает градусы в радианы.
Rand — возвращает псевдослучайное число от 0 до 1.
RandBetween — возвращает псевдослучайное число между двумя числами.
ReadNFC — считывает метку радиочастотной связи ближнего действия (NFC).
RecordInfo — предоставляет информацию о записи источника данных.
Refresh — обновляет записи источника данных.
Relate — связывание и отмена связывания записей двух таблиц с использованием отношения "один ко многим" или "многие ко многим".
Remove — удаляет одну или несколько указанных записей из источника данных.
RemoveIf — удаляет записи из источника данных, если выполняется определенное условие.
RenameColumns — переименовывает столбцы в таблице.
Replace — заменяет часть строки другой строкой, используя начальную позицию строки.
RequestHide — скрывает форму SharePoint.
Reset — сбрасывает элемент управления вводом до значения по умолчанию и отменяет все изменения, внесенные пользователем.
ResetForm — сбрасывает элемент управления формы для редактирования существующего элемента.
Revert — перезагружает содержимое и удаляет ошибки для записей в источнике данных.
RGBA — возвращает значение цвета для модели RGBA (набор из красного, зеленого, синего и альфа-фактора).
Right — возвращает правую часть строки.
Round — округляет до ближайшего числа.
RoundDown — округляет до ближайшего числа в меньшую сторону.
RoundUp — округляет до ближайшего числа в большую сторону.
S
SaveData — сохраняет коллекцию на узел приложения, такой как локальное устройство.
Search — находит записи в таблице, содержащие строку в одном из столбцов.
Second — возвращает данные времени в секундах из значения даты и времени.
Select — имитирует действие выбора элемента управления, активируя вычисление формулы OnSelect.
Self — предоставляет доступ к свойствам текущего элемента управления.
Sequence — создает таблицу последовательных номеров, полезную при итерации с ForAll.
SendAppNotification (предварительная версия) — отправка получателю уведомления в приложении с необязательными действиями.
Set — задает значение глобальной переменной.
SetFocus — устанавливает фокус ввода на конкретный элемент управления.
SetProperty — имитирует взаимодействие с элементами управления для ввода.
ShowColumns — возвращает таблицу только с выбранными столбцами.
ShowHostInfo. Отображает информацию пользователю в приложении.
Shuffle — случайным образом изменяет порядок записей в таблице.
Sin — возвращает синус угла, указанного в радианах.
Sort — возвращает таблицу, отсортированную на основе формулы.
SortByColumns — возвращает таблицу, отсортированную по одному или нескольким столбцам.
Split — эта функция разбивает строку текста в таблицу с подстроками.
Sqrt — возвращает квадратный корень числа.
StartsWith — проверяет, начинается ли одна текстовая строка с другой.
StdevP — возвращает стандартное отклонение своих аргументов.
Substitute — заменяет часть строки другой строкой, используя совпадение строк.
SubmitForm — сохраняет элемент из элемента управления формы в источнике данных.
Sum — вычисляет сумму табличного выражения или набора аргументов.
Switch — выполняет сопоставление с набором значений, а затем вычисляет соответствующую формулу.
T
Table — создает временную таблицу.
Tan — возвращает тангенс угла, указанного в радианах.
Text — преобразует любое значение и форматирует число или значение даты и времени в текстовую строку.
ThisItem — возвращает запись для текущего элемента в элементе управления коллекции или формы.
ThisRecord — возвращает запись для текущего элемента в функции области записи, например ForAll, With и Sum.
Time — возвращает значение даты и времени на основе значений Hour, Minute и Second.
TimeValue — преобразует строку формата ''только время'' в значение даты и времени.
TimeZoneOffset — возвращает разницу между временем в формате UTC и местным временем пользователя в минутах.
Today — возвращает текущее значение только даты.
Trace — выводит дополнительные сведения в результатах теста.
Trim — удаляет лишние пробелы по краям и внутри текстовой строки.
TrimEnds — удаляет лишние пробелы только по краям текстовой строки.
Trunc — усекает число только до целой части, удаляя десятичную часть.
U
Ungroup — удаляет группирование.
UniChar — преобразует код Unicode в строку.
Unrelate — отменяет связывание записей двух таблиц с использованием связи "один ко многим" или "многие ко многим".
Update — заменяет запись в источнике данных.
UpdateContext — задает значение одной или нескольких переменных контекста на текущем экране.
UpdateIf — изменяет набор записей в источнике данных, если выполняется определенное условие.
Upper — преобразует буквы текстовой строки во все прописные.
User — возвращает сведения о текущем пользователе.
UTCNow — возвращает текущее значение даты/времени в формате UTC.
UTCToday — возвращает текущее значение только даты в формате UTC.
V
Validate — проверяет, являются ли значения одного столбца или всей записи допустимыми для источника данных.
Value — преобразует строку в число.
VarP — возвращает расхождение своих аргументов.
ViewForm — сбрасывает элемент управления формой для просмотра существующего элемента.
W
Weekday — извлекает сведения о дне недели из значения даты и времени.
WeekNum — возвращает номер недели для значения даты и времени.
With — вычисляет значения и выполняет действия для одной записи, включая встроенные записи именованных значений.
Y
Year — извлекает сведения о годе из значения даты и времени.