Référence sur les formules - Power Apps
Dans cet article, vous découvrez toutes les fonctions disponibles dans Power Apps.
Les formules dans Power Apps combinent de nombreux éléments, à savoir :
- Les fonctions acceptent des paramètres, effectuent une opération et renvoient une valeur. Par exemple, Sqrt(25) renvoie 5. Les fonctions sont modélisées d’après les fonctions Microsoft Excel. Certaines fonctions ont des effets secondaires, par exemple SubmitForm. Elles sont appropriées uniquement dans une formule de comportement comme Button.OnSelect.
- Les signaux renvoient des informations sur l’environnement. Par exemple, Location renvoie les coordonnées GPS actuelles de l’appareil. Les signaux n’acceptent aucun paramètre et n’ont aucun effet secondaire.
- Les énumérations renvoient une valeur constante prédéfinie. Par exemple, Color est une énumération qui a des valeurs prédéfinies pour Color.Red, Color.Blue, et ainsi de suite. Les énumérations courantes sont indiquées ici. Les énumérations spécifiques aux fonctions sont décrites avec la fonction.
- Les opérateurs nommés, par exemple ThisItem et Self, fournissent un accès aux informations depuis un conteneur.
D’autres éléments incluent :
A
Abs : valeur absolue d’un nombre.
Acceleration : lit le capteur d’accélération de votre appareil.
Acos : renvoie l’arc sinus d’un nombre calculé en radians.
Acot : renvoie l’arc cotangente d’un nombre calculé en radians.
AddColumns : renvoie une table pour laquelle des colonnes ont été ajoutées.
And : logique booléenne AND. Renvoie true si tous les arguments sont true. Vous pouvez également utiliser l’opérateur &&.
AIClassify : classe le texte en une ou plusieurs catégories.
AIExtract : extrait des entités spécifiées, comme des numéros d’enregistrement, des numéros de téléphone ou des noms de personnes.
AIReply : rédige une réponse au message que vous fournissez.
AISentiment : détecte le sentiment du texte que vous fournissez.
AISummarize : résume le texte que vous fournissez.
AITranslate : traduit le texte à partir d’une autre langue.
App : fournit des informations sur l’application en cours d’exécution et un contrôle du comportement de l’application.
Asin : renvoie l’arc sinus d’un nombre calculé en radians.
Assert : s’évalue à true ou à false dans un test.
As : nomme l’enregistrement actuel dans des fonctions de galerie, de formulaire et d’étendue d’enregistrement telles que ForAll, With, et Sum.
AsType : traite une référence d’enregistrement comme un type de table spécifique.
Atan : renvoie l’arc tangente d’un nombre calculé en radians.
Atan2 : renvoie l’arc tangente d’après des coordonnées (x,y) calculé en radians.
Average : calcule la moyenne d’une expression de table ou d’un jeu d’arguments.
B
Back : affiche l’écran précédent.
Blank : retourne une valeur vide qui peut être utilisée pour insérer une valeur NULL dans une source de données.
Boolean : convertit une chaîne de texte, un nombre ou une valeur sans type en une valeur booléenne.
C
Calendar : récupère des informations sur le calendrier pour les paramètres régionaux actuels.
Char : traduit un code de caractère en une chaîne.
Choices : retourne une table des valeurs possibles pour une colonne de liste de choix.
Clear : supprime toutes les données d’une collection.
ClearCollect : supprime toutes les données d’une collection, puis ajoute un ensemble d’enregistrements.
ClearData : efface une ou plusieurs collections d’un hôte d’application tel qu’un appareil local.
Clock : récupère des informations sur l’horloge pour les paramètres régionaux actuels.
Coalesce : remplace les valeurs vides tout en laissant les valeurs non vides inchangées.
Collect : crée une collection ou ajoute des données à une source de données.
Color : définit une propriété sur une valeur de couleur prédéfinie.
ColorFade : atténue une valeur de couleur.
ColorValue : traduit un nom de couleur CSS ou un code hexadécimal en une valeur de couleur.
Column : récupère les noms et les valeurs des colonnes à partir d’un type de données d’objet sans type.
ColumnNames : récupère les noms et les valeurs des colonnes à partir d’un type de données d’objet sans type.
Compass : renvoie votre en-tête de boussole.
Concat : concatène les chaînes d’une source de données.
Concatenate : concatène les chaînes.
Concurrent : évalue plusieurs formules entre elles en même temps.
Connection : renvoie des informations sur votre connexion réseau.
Copier : copie le texte dans le Presse-papiers de l’appareil où l’application est en cours d’exécution.
Count : compte les enregistrements de la table contenant des nombres.
Cos : renvoie le cosinus d’un angle calculé en radians.
Cot : renvoie la cotangente d’un angle calculé en radians.
CountA : compte les enregistrements de la table qui ne sont pas vides.
CountIf : compte les enregistrements de la table qui satisfont à une condition.
CountRows : compte les enregistrements d’une table.
D
DataSourceInfo : fournit des informations sur une source de données.
Date : renvoie une valeur date/heure, d’après les valeurs Année, Mois et Jour.
DateAdd : ajoute des jours, mois, trimestres ou années à une valeur de date/heure.
DateDiff : soustrait deux valeurs de date et affiche le résultat en jours, mois, trimestres ou années.
DateTime : renvoie une valeur de date/heure, en fonction des composants de date et d’heure.
DateTimeValue : convertit une chaîne de date et d’heure en une valeur date/heure.
DateValue : convertit une chaîne composée seulement d’une date en une valeur date/heure.
Day : récupère la partie jour d’une valeur date/heure.
Dec2Hex : convertit un nombre en chaîne de texte hexadécimale.
Defaults : renvoie les valeurs par défaut d’une source de données.
Degrees : convertit les radians en degrés.
Disable : désactive un signal, par exemple Location pour lire des données GPS.
Distinct : offre un récapitulatif des enregistrements d’une table en supprimant les doublons.
Download : télécharge un fichier à partir du web sur l’appareil local.
DropColumns : renvoie une table dont une ou plusieurs colonnes ont été supprimées.
E
EDate : ajoute ou soustrait des mois à une date, sans changer le jour du mois.
EditForm : réinitialise un contrôle Form pour la modification d’un élément.
Enable : active un signal, par exemple Location pour lire des données GPS.
EncodeUrl : encode des caractères spéciaux à l’aide de l’encodage des URL.
EndsWith : vérifie si une chaîne de texte se termine par une autre chaîne de texte.
EOMonth : ajoute ou soustrait des mois à une date, en renvoyant le dernier jour de ce mois.
Error : crée une erreur personnalisée ou transmet une erreur.
Errors : fournit des informations d’erreur sur les modifications apportées précédemment à une source de données.
exactin : vérifie si une chaîne de texte est contenue dans une autre chaîne de texte ou tableau, en fonction de la casse. Également utilisé pour vérifier si un enregistrement est dans une table.
Exit : quitte l’application en cours d’exécution et déconnecte éventuellement l’utilisateur actuel.
Exp : renvoie e élevé à la puissance.
F
Filter : renvoie une table filtrée selon un ou plusieurs critères.
Find : vérifie si une chaîne apparaît dans une autre et renvoie l’emplacement.
First : renvoie le premier enregistrement d’une table.
FirstN : renvoie le premier jeu d’enregistrements (N enregistrements) d’une table.
ForAll : calcule les valeurs et effectue des actions pour tous les enregistrements d’une table.
G
GroupBy : renvoie une table dont les enregistrements sont regroupés.
GUID : convertit une chaîne GUID en une valeur GUID, ou crée une valeur GUID.
H
HashTags : extrait les hashtags (#strings) d’une chaîne.
Hex2Dec : convertit une chaîne de texte hexadécimale en nombre.
Hôte : fournit des informations sur l’hôte actuel qui exécute l’application.
Hour : renvoie la partie heure d’une valeur date/heure.
I
If : renvoie une valeur si une condition est vraie et une autre valeur dans le cas contraire.
IfError : détecte les erreurs et fournit une valeur alternative, ou prend des mesures.
in : vérifie si une chaîne de texte est contenue dans une autre chaîne de texte ou tableau, indépendamment de la casse. Également utilisé pour vérifier si un enregistrement est dans une table.
Index : renvoie un enregistrement d’une table en fonction de la position ordonnée.
Int : arrondit une valeur jusqu’à l’entier inférieur.
IsBlank : recherche une valeur blank.
IsBlankOrError : vérifie une valeur ou erreur vide.
IsEmpty : recherche une table vide.
IsError : recherche une erreur.
IsMatch : compare une chaîne à un modèle. Les expressions régulières peuvent être utilisées.
IsNumeric : recherche une valeur numérique.
ISOWeekNum : renvoie le numéro de semaine ISO d’une valeur date/heure.
IsToday : vérifie si une valeur de date/heure correspond à un moment de la journée dans le fuseau horaire de l’utilisateur.
IsType : vérifie si une référence d’enregistrement fait référence à un type de table spécifique.
IsUTCToday : vérifie si une valeur de date/heure correspond à un moment de la journée en temps universel coordonné (UTC).
J
JSON : génère une chaîne de texte JSON pour une table, un enregistrement ou une valeur.
L
Language : renvoie la balise de langue de l’utilisateur actuel.
Last : renvoie le dernier enregistrement d’une table.
LastN : renvoie le dernier jeu d’enregistrements (N enregistrements) d’une table.
Launch : lance une page web ou une application canevas.
Left : renvoie la partie la plus à gauche d’une chaîne.
Len : renvoie la longueur d’une chaîne.
Ln : renvoie le logarithme naturel.
LoadData : charge une collection à partir d’un hôte d’application tel qu’un appareil local.
Location : renvoie votre emplacement sous forme de coordonnées sur une carte en utilisant le système GPS (Global Positioning System) et d’autres informations.
Log : renvoie le logarithme dans n’importe quelle base d’un nombre.
LookUp : recherche un enregistrement unique dans une table en fonction d’un ou de plusieurs critères.
Lower : convertit les lettres d’une chaîne de texte en minuscules.
M
Match : extrait une sous-chaîne en fonction d’un modèle. Les expressions régulières peuvent être utilisées.
MatchAll : extrait plusieurs sous-chaînes en fonction d’un modèle. Les expressions régulières peuvent être utilisées.
Max : valeur maximale d’une expression de table ou d’un jeu d’arguments.
Mid : renvoie la partie centrale d’une chaîne.
Min : valeur minimale d’une expression de table ou d’un jeu d’arguments.
Minute : récupère la partie minute d’une valeur date/heure.
Mod : renvoie le reste d’une division.
Month : récupère la partie mois d’une valeur date/heure.
N
Navigate : modifie l’écran qui s’affiche.
NewForm : réinitialise un contrôle Form pour la création d’un élément.
Not : logique booléenne NOT. Renvoie true si son argument est false et renvoie false si son argument est true. Vous pouvez également utiliser l’opérateur !.
Notify : affiche un message de bannière à l’utilisateur.
Now : renvoie la valeur date/heure actuelle dans le fuseau horaire de l’utilisateur.
O
Or : logique booléenne OR. Renvoie true si tous les arguments sont true. Vous pouvez également utiliser || comme opérateur.
P
Param : paramètres d’accès passés à une application canevas lors de son lancement.
Parent : permet d’accéder aux propriétés d’un contrôle Container.
ParseJSON : convertit un document JSON représenté en texte en une valeur Objet sans type.
Patch : modifie ou crée un enregistrement dans une source de données ou fusionne des enregistrements en dehors d’une source de données.
PDF : exportez le contenu de l’écran actuel vers un objet pour une utilisation dans plusieurs scénarios.
Pi : renvoie le nombre π.
PlainText : supprime les balises HTML et XML depuis une chaîne.
Power : renvoie un nombre élevé à la puissance. Vous pouvez également utiliser ^ comme opérateur.
Proper : convertit la première lettre de chaque mot en une chaîne en majuscules et convertit le reste en minuscules.
R
Radians : convertit les degrés en radians.
Rand : renvoie un nombre pseudo-aléatoire compris entre 0 et 1.
RandBetween : renvoie un nombre pseudo-aléatoire entre deux nombres.
ReadNFC : lit une balise NFC (Near Field Communication).
RecordInfo : fournit des informations sur un enregistrement d’une source de données.
Refresh : actualise les enregistrements d’une source de données.
Relate : associe les enregistrements de deux tables via une relation un-à-plusieurs ou plusieurs-à-plusieurs.
Remove : supprime un ou plusieurs enregistrements spécifiques à partir d’une source de données.
RemoveIf : supprime les enregistrements d’une source de données en fonction d’une condition.
RenameColumns : renomme les colonnes d’une table.
Replace : remplace une partie d’une chaîne par une autre chaîne, d’après la position de départ de la chaîne.
RequestHide : cache un formulaire SharePoint.
Reset : réinitialise un contrôle d’entrée à sa valeur par défaut, en ignorant les modifications de l’utilisateur.
ResetForm : réinitialise un contrôle Form pour la modification d’un élément existant.
Revert : recharge et efface les erreurs des enregistrements d’une source de données.
RGBA : renvoie une valeur de couleur pour un ensemble de composants rouges, verts, bleus et alphanumériques.
Right : renvoie la partie la plus à droite d’une chaîne.
Round : arrondit au nombre le plus proche.
RoundDown : arrondit au nombre précédent le plus grand.
RoundUp : arrondit au nombre suivant le plus petit.
S
SaveData : enregistre une collection vers un hôte d’application tel qu’un appareil local.
Search : recherche les enregistrements d’une table contenant une chaîne dans l’une de leurs colonnes.
Second : récupère la partie seconde d’une valeur date/heure.
Select : simule une action de sélection sur un contrôle, entraînant l’évaluation de la formule OnSelect.
Self : donne accès aux propriétés du contrôle en cours.
Sequence : générer un tableau de nombres séquentiels, utile lors d’une itération avec ForAll.
SendAppNotification (version préliminaire) : envoie une notification dans l’application avec des actions facultatives à un destinataire.
Set : définit la valeur d’une variable globale.
SetFocus : déplace le focus d’entrée vers un contrôle spécifique.
SetProperty : simule des interactions avec les contrôles d’entrée.
ShowColumns : renvoie une table contenant uniquement les colonnes sélectionnées.
ShowHostInfo : affiche des informations pour l’utilisateur dans l’application.
Shuffle : réorganise les enregistrements d’une table de manière aléatoire.
Sin : renvoie le sinus d’un angle calculé en radians.
Sort : renvoie un tableau trié selon une formule.
SortByColumns : renvoie un tableau trié d’après une ou plusieurs colonnes.
Split : fractionne une chaîne de texte en une table de sous-chaînes.
Sqrt : renvoie la racine carrée d’un nombre.
StartsWith : vérifie si une chaîne de texte commence par une autre chaîne de texte.
StdevP : renvoie l’écart type de ses arguments.
Substitute : remplace une partie d’une chaîne par une autre chaîne, en mettant les chaînes en correspondance.
SubmitForm : enregistre l’élément d’un contrôle Form dans la source de données.
Sum : calcule la somme d’une expression de table ou d’un jeu d’arguments.
Switch : correspond à un ensemble de valeurs, puis évalue une formule correspondante.
T
Table : crée une table temporaire.
Tan : renvoie la tangente d’un angle calculé en radians.
Text : convertit n’importe quelle valeur, et met en forme un nombre ou une valeur de date/heure en une chaîne de texte.
ThisItem : renvoie l’enregistrement de l’élément actuel dans une galerie ou un contrôle Form.
ThisRecord : renvoie l’enregistrement de l’élément actuel dans une fonction d’étendue d’enregistrement, telle que ForAll, With et Sum.
Time : renvoie une valeur date/heure, d’après les valeurs Heure, Minute et Seconde.
TimeValue : convertit une chaîne composée d’une heure seulement en une valeur date/heure.
TimeZoneOffset : retourne la différence entre l’heure UTC et l’heure locale de l’utilisateur, exprimée en minutes.
Today : renvoie la valeur de date uniquement actuelle.
Trace : fournit des informations supplémentaires dans les résultats de vos tests.
Trim : supprime les espaces supplémentaires situés aux extrémités et à l’intérieur d’une chaîne de texte.
TrimEnds : supprime les espaces supplémentaires situés aux extrémités d’une chaîne de texte uniquement.
Trunc : tronque le nombre à la partie entière en supprimant toute partie décimale.
U
Ungroup : supprime un regroupement.
UniChar : traduit un code Unicode en chaîne.
Unrelate : supprime la relation entre les enregistrements de deux tables dans une relation un-à-plusieurs ou plusieurs-à-plusieurs.
Update : remplace un enregistrement dans une source de données.
UpdateContext : définit la valeur d’une ou plusieurs variables de contexte de l’écran actuel.
UpdateIf : modifie un jeu d’enregistrement dans une source de données d’après une condition.
Upper : convertit les lettres d’une chaîne de texte en majuscules.
User : renvoie des informations sur l’utilisateur actuel.
UTCNow : renvoie la valeur date/heure actuelle en temps universel coordonné (UTC).
UTCToday : renvoie la valeur de date uniquement actuelle en temps universel coordonné (UTC).
V
Validate : vérifie si la valeur d’une colonne unique ou d’un enregistrement complet est valide pour une source de données.
Value : convertit une chaîne en nombre.
VarP : renvoie la variance de ses arguments.
ViewForm : réinitialise un contrôle Form pour l’affichage d’un élément existant.
W
Weekday : récupère la partie semaine d’une valeur date/heure.
WeekNum : renvoie le numéro de semaine d’une valeur date/heure.
With : calcule des valeurs et effectue des actions pour un seul enregistrement, y compris des enregistrements inline de valeurs nommées.
Y
Year : récupère la partie année d’une valeur date/heure.