Fonctions
Les fonctions jouent un rôle clé dans la manipulation et la transformation des données dans PandaSuite. Elles permettent d’effectuer des opérations spécifiques sur différents types de données, tels que les nombres, les chaînes de caractères, les dates et les tableaux.
Comprendre le rôle des fonctions
Une fonction prend des paramètres qui déterminent son comportement. Ces paramètres indiquent sur quelles données la fonction doit agir et peuvent inclure des options spécifiques à l’opération. Une fois exécutée, la fonction retourne un résultat qui peut être utilisé dans l’application.
Certaines fonctions ne sont compatibles qu’avec des types de données spécifiques. Par exemple, une fonction mathématique ne pourra pas être appliquée à une chaîne de caractères sans conversion préalable.
Fonctions générales
Evaluate
Évalue une expression et retourne le résultat.
Paramètre : Expression (chaîne de caractères contenant une opération mathématique ou logique)
Retourne : Vrai ou faux
By Key
Renvoie la valeur d’un élément à partir de sa clé.
Paramètre : Clé
Retourne : Valeur associée à la clé
By Index
Renvoie la valeur d’un élément à partir de son index (le premier élément est indexé à 0).
Paramètre : Index
Retourne : Valeur à l’index donné
By Id
Renvoie la valeur d’un élément à partir de son identifiant unique.
Paramètre : Identifiant
Retourne : Valeur associée
Fonctions mathématiques
Les fonctions mathématiques prennent comme paramètre un nombre.
💡 Si vous utilisez la valeur d’un composant Saisie de texte, pensez à utiliser la fonction Parse Number pour convertir la valeur avant toute opération.
Add
Ajoute le nombre spéicié en paramètre et retourne la valeur.
Substract
Soustrait le nombre spécifié en paramètre et retourne la valeur.
Multiply
Multiplie par le nombre spécifié en paramètre et retourne la valeur.
Divide
Divise par le nombre spécifié en paramètre et retourne la valeur.
Round
Arrondit au nombre entier le plus proche.
Floor
Renvoie le plus grand nombre entier inférieur ou égal à un nombre spécifié.
Ceil
Renvoie le plus petit nombre entier supérieur ou égal à un nombre spécifié.
Sqrt
Renvoie la racine carrée d’un nombre.
Cbrt
Renvoie la racine cubique d’un nombre.
Tan
Renvoie la tangente d’un nombre exprimant un angle en radians.
Cos
Rtourne le cosinus d’un angle dont la valeur est exprimée en radians.
Sin
Renvoie le sinus d’un nombre.
Pow
Renvoie un nombre à une certaine puissance.
Abs
Retourne la valeur absolue d’un nombre.
Format Number
Renvoie un nombre dans le format demandé.
Paramètres :
- Minimums (Fractions) : le nombre minimal de décimales à utiliser
- Maximums (Fractions) : le nombre maximal de décimales à utiliser
💡 Découvrez le doc de référence : https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat
Parse Number
Convertit une chaîne de caractères en nombre.
Parse Color
Fonctions sur le texte
Truncate
Tronque un texte au nombre de caractères spécifié.
Split
Divise un texte en un tableau en utilisant un séparateur défini.
Fonctions sur les dates et le temps
Format Date
Convertit une date en une chaîne de caractères selon un format donné.
Vous avez le choix entre plusieurs formats de date et d’heure :
La première étape est de choisir le Type entre Prédéfini ou Personnalisé.
Les types prédéfinis
Voici les paramètres disponibles pour le type Prédéfini :
- Style date : vous avez le choix entre Aucun, Court, Moyen, Long, Complet
Voici un exemple avec la date du 16 Septembre 2021 à 16h53 :
| Aucun | La date ne s’affiche pas |
|---|---|
| Court | 9/16/21 |
| Moyen | Sep 16, 2021 |
| Long | September 16, 2021 |
| Complet | Thursday September 16, 2021 |
- Style heure : vous avez le choix entre Aucun, Court, Moyen, Long, Complet
Voici un exemple avec la date du 16 Septembre 2021 à 16h53 :
| Aucun | L’heure ne s’affiche pas |
|---|---|
| Court | 4:53 PM |
| Moyen | 4:53:15 PM |
| Long | 4:53:15 PM GMT+2 |
| Complet | 4:53:15 PM Central European Time |
- Fuseau horaire : choisissez le fuseau horaire de référence
Les types personnalisés
Voici les paramètres disponibles pour le type Personnalisé :
- Format Date/Heure : vous pouvez choisir un format libre en vous appuyant sur les codes universels de la donnée Timestamp.
Voici quelques exemples de codes couramment utilisés :
| Code | Description |
|---|---|
| yyyy | Année sur 4 chiffres (par exemple, 2023) |
| MM | Mois sur 2 chiffres (par exemple, 07 pour juillet) |
| dd | Jour sur 2 chiffres (par exemple, 07) |
| HH | Heure sur 2 chiffres au format 24 heures |
| hh | Heure sur 2 chiffres au format 12 heures |
| mm | Minutes sur 2 chiffres |
| tt | A.M. ou P.M. en deux lettres |
💡 Pour retrouver tous les codes : Format Date / Time (Unicode)
- Fuseau horaire : choisissez le fuseau horaire de référence
Parse Date
Analyse une chaîne de caractères avec une date et renvoie la date.
Add Seconds/Minutes/Hours/Days/Months/Years
Ajoute ou soustrait une durée spécifique à une date.
Set Seconds/Minutes/Hours/Days/Months/Years
Remplace une partie de la date avec une nouvelle valeur.
Fonctions sur les tableaux et collections
Merge
Fusionne deux collections en une seule.
Count
Renvoie le nombre d’éléments d’un tableau.
Group by
Regroupe les données selon un critère donné.
Uniq by
Supprime les doublons selon un critère donné.
Min
Renvoie la valeur minimale d’un tableau
Min By
Renvoie l’objet ayant la valeur minimale (dans une collection)
Max
Renvoie la valeur maximale d’un tableau
Max By
Renvoie l’objet ayant cette valeur maximale (dans une collection)