Chaque expression dans le langage de formule d'ActivityInfo a un type spécifique qui détermine les valeurs que l'expression peut 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 "String" et sa valeur sera toujours une combinaison de caractères.
Les valeurs des formules 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 "String".
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 |
|---|---|---|
| String | Une "chaîne" de caractères | "Alice", 'Bob' |
| Nombre | Un nombre à valeur réelle | 42, 1.5, -3000 |
| Booléen | Soit TRUE ou FALSE | 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.
String
Les valeurs de type String 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 système du 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 cette gestion plus "indulgente" des valeurs vides dans les opérations arithmétiques.
Pour plus d'informations, veuillez vous référer à 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 | String |
| Quantité | Nombre |
| Texte | String |
| Texte multiligne | String |
| Date | Date locale |
| Semaine | Semaine |
| Quinzaine | Semaine |
| Mois | Mois |
| Sélection unique | String |
| Sélection multiple | String |
| Pièce jointe | Struct |
| Calculé | Dépend de la formule |
| Référence | String |
| Point géographique | Struct |
| Utilisateur | String |
| En-tête de section | Pas de valeur |
| Sous-formulaire | Pas de valeur |
| Code-barres | String |
Conversion entre les types
Dans certains cas, vous pourriez vouloir changer une valeur d'un type à un autre. Par exemple, pour changer une valeur numérique en une valeur de type String. Les fonctions suivantes sont disponibles.
Conversion en texte
La fonction TEXT convertit son argument en chaîne de caractères.