Chaque expression dans le langage de formule d'ActivityInfo a un type spécifique qui détermine les valeurs que l'expression est autorisée à avoir. Par exemple, des expressions comme 2+2 ou 42 ont toutes deux le type "nombre", qui peut inclure n'importe quel nombre à valeur réelle. L'expression CONCAT(FIRST_NAME, " ", LAST_NAME) en revanche, a le type "chaîne de caractères" ; sa valeur sera toujours une combinaison de caractères.
Les valeurs de formule d'ActivityInfo sont liées, mais distinctes, des types de champs. Différents types de champs de formulaire, comme le champ de texte et le type de numéro de série, ont des comportements très différents en ce qui concerne la collecte et la gestion des données, mais lorsqu'ils sont utilisés dans des formules, ils ont tous deux le type "chaîne de caractères".
Comprendre les types de formules d'ActivityInfo peut être utile pour écrire des formules complexes. Certaines fonctions, par exemple, ne peuvent être utilisées qu'avec des types spécifiques.
Types
Voici un aperçu rapide des types de formules d'ActivityInfo :
| Type | Description | Exemples |
|---|---|---|
| Chaîne de caractères | Une « chaîne » de caractères | "Alice", 'Bob' |
| Nombre | Un nombre à valeur réelle | 42, 1.5, -3000 |
| Booléen | Soit Vrai, soit Faux | TRUE, FALSE |
| Date locale | Une année, un mois et un jour | DATE(2022,1,15) |
| Semaine | Une année et un numéro de semaine | WEEKVALUE("2022W3") |
| Mois | Une année et un mois | |
| Trimestre | Une année et un trimestre | |
| Instant | Un moment précis dans le temps | _lastEditTime |
La section suivante fournit plus de détails sur ces types.
Chaîne de caractères
Les valeurs de type chaîne de caractères dans les formules, comme dans les formulaires ActivityInfo, sont un ensemble de caractères Unicode.
Nombre
Les valeurs numériques dans les formules incluent des nombres à valeur réelle entre +/- 1,8 x 10³⁰⁸. En pratique, toutes les valeurs numériques sont stockées sous forme de nombres à virgule flottante de 64 bits.
Date locale
Le type de date locale, que nous appelons généralement "date" dans la documentation, est une date sans fuseau horaire dans le calendrier grégorien (normalisé en ISO-8601), comme 2007-12-03.
Les valeurs de date locale d'ActivityInfo sont limitées à la plage comprise entre 1000-01-01 et 9999-12-31.
Valeurs vides
Chaque type inclut également une valeur exceptionnelle "vide". La valeur vide d'ActivityInfo est similaire à NULL en SQL, à la valeur NA en R, ou à une cellule vide dans Excel.
La sémantique du langage de formule d'ActivityInfo est plus proche de celle d'Excel que de celle de SQL. Par exemple, dans une requête SQL, 1 + NULL donne NULL, tandis que dans Excel 1 + A1 donne 1, même si A1 est vide. ActivityInfo adopte ce traitement plus "indulgent" des valeurs vides en arithmétique.
Pour plus d'informations, veuillez consulter l'article sur les valeurs vides.
Types de champs et types de formules
Le tableau suivant fournit un résumé de la correspondance entre les différents types de champs dans les formulaires ActivityInfo et les types de formules :
| Type de champ | Type de formule |
|---|---|
| Numéro de série | Chaîne de caractères |
| Quantité | Nombre |
| Texte | Chaîne de caractères |
| Texte multiligne | Chaîne de caractères |
| Date | Date locale |
| Semaine | Semaine |
| Quinzaine | Semaine |
| Mois | Mois |
| Sélection unique | Chaîne de caractères |
| Sélection multiple | Chaîne de caractères |
| Pièce jointe | Struct |
| Calculé | Dépend de la formule |
| Référence | Chaîne de caractères |
| Point géographique | Struct |
| Utilisateur | Chaîne de caractères |
| En-tête de section | Pas de valeur |
| Sous-formulaire | Pas de valeur |
| Code-barres | Chaîne de caractères |
Conversion entre les types
Dans certains cas, vous pouvez vouloir changer une valeur d'un type à un autre. Par exemple, pour changer une valeur numérique en une valeur de type chaîne de caractères. Les fonctions suivantes sont disponibles à cet effet.
Conversion en texte
La fonction TEXT convertit son argument en chaîne de caractères.