LOCALVALUE

Description

La fonction LOCALVALUE analyse une chaîne de texte en tant que nombre en utilisant les paramètres régionaux de l'utilisateur actuel. Les séparateurs décimaux et de milliers sont interprétés en fonction de la langue de l'utilisateur, de sorte que la même chaîne de saisie peut produire des résultats différents pour différents utilisateurs.

Utilisation

LOCALVALUE(texte)

| Argument | Type | Obligatoire | Description || --- | --- | --- | --- || texte | Texte | Oui | Une chaîne de texte représentant un nombre, formatée selon les paramètres régionaux de l'utilisateur |

Remarques

Les paramètres régionaux utilisés sont la langue préférée définie dans le profil de l'utilisateur. Le résultat de LOCALVALUE change en fonction de l'utilisateur qui consulte ou exécute la formule.

LOCALVALUE interprète les séparateurs décimaux et de milliers en fonction des paramètres régionaux de l'utilisateur qui exécute la formule :

• Dans les paramètres régionaux anglais, . est le séparateur décimal et , est le séparateur de milliers, donc "1,001" correspond à mille un, et "1.001" correspond à un virgule zéro zéro un.
• Dans les paramètres régionaux allemands (et européens similaires), , est le séparateur décimal et . est le séparateur de milliers, donc "1.001" correspond à mille un, et "1,001" correspond à un virgule zéro zéro un.

Les espaces de début et de fin sont ignorés. Un signe + au début est accepté et ignoré. Les nombres négatifs (commençant par -) sont pris en charge. La notation scientifique (par exemple, "1.024E3") est acceptée lorsqu'elle est formatée pour les paramètres régionaux de l'utilisateur.

Si la saisie est vide ou ne contient que des espaces, le résultat est vide.

Si la saisie ne peut pas être analysée comme un nombre (par exemple, si elle contient des symboles monétaires, des espaces à l'intérieur de la valeur, des séparateurs de date ou du texte non numérique), le résultat est vide.

Pour une analyse indépendante des paramètres régionaux, où . est toujours le séparateur décimal quelle que soit la langue de l'utilisateur, utilisez plutôt VALUE.

Comparaison des paramètres régionaux

| Saisie | Paramètres régionaux anglais | Paramètres régionaux allemands || --- | --- | --- || 1.001 | 1.001 | 1001 | | 1,001 | 1001 | 1.001 | | 1.024E3 | 1024 | | | 1,024E3 | | 1024 | | 365 | 365 | 365 | | -365 | -365 | -365 | | +365 | 365 | 365 |

Saisies non valides

Les saisies suivantes renvoient un résultat vide, quels que soient les paramètres régionaux :

| Saisie | Raison || --- | --- || $22.12 | Les symboles monétaires ne sont pas acceptés | | 22 33 | Les espaces à l'intérieur de la valeur ne sont pas acceptés | | 2022-04-01 | Les chaînes de date ne sont pas acceptées | | dummy | Le texte non numérique n'est pas accepté | | (Vide) | Une saisie vide renvoie un résultat vide |

Exemple

Lorsqu'un formulaire collecte une saisie numérique dans un champ de texte et que la base d'utilisateurs couvre plusieurs paramètres régionaux, LOCALVALUE convertit chaque entrée en fonction des propres paramètres régionaux de l'utilisateur qui la soumet :

LOCALVALUE(QUANTITY_TEXT)

Quand utiliser LOCALVALUE

Étant donné que le résultat de LOCALVALUE dépend des paramètres régionaux de l'utilisateur qui consulte ou exécute la formule, cela peut causer des problèmes dans certains contextes :

• Champs calculés et règles de validation : Évitez d'utiliser LOCALVALUE ici. Différents utilisateurs verront des valeurs différentes pour le même enregistrement, ce qui peut entraîner des données incohérentes et des échecs de validation en fonction de la personne qui consulte le formulaire.
• Formules de valeur par défaut : C'est l'utilisation la plus appropriée. Les formules de valeur par défaut sont évaluées une seule fois lorsqu'un utilisateur ouvre un formulaire pour saisir des données, de sorte que le résultat est calculé dans les paramètres régionaux de cet utilisateur, puis stocké comme une valeur fixe.

Choisir entre LOCALVALUE et VALUE

• Si vos données ont été collectées dans un environnement contrôlé où la notation décimale est toujours anglaise (. comme séparateur décimal), utilisez VALUE pour des résultats prévisibles pour tous les utilisateurs.
• Utilisez LOCALVALUE dans les formules de valeur par défaut lorsque les utilisateurs saisissent du texte dans leurs propres paramètres régionaux et que vous souhaitez que l'analyse corresponde à la manière dont chaque utilisateur formate les nombres.