SUBSTITUTE
S’applique à :
Colonne calculéeTable calculéeMesureCalcul de visuel
Remplace un texte existant par un nouveau texte dans une chaîne de texte.
Syntaxe
SUBSTITUTE(<text>, <old_text>, <new_text>, <instance_num>)
Paramètres
| Terme | Définition |
|---|---|
| texte | Texte dans lequel vous souhaitez remplacer des caractères ou référence à une colonne contenant du texte. |
| old_text | Texte existant à remplacer. |
| new_text | Texte de remplacement de old_text. |
| instance_num | (Facultatif) Occurrence de old_text à remplacer. En cas d’omission, chaque instance de old_text est remplacée. |
Valeur renvoyée
Chaîne de texte.
Remarques
Utilisez la fonction SUBSTITUTE pour remplacer un texte spécifique dans une chaîne de texte. Utilisez la fonction REPLACE pour remplacer tout texte de longueur variable figurant à un emplacement spécifique d’une chaîne de texte.
La fonction SUBSTITUTE respecte la casse. Si la casse des paramètres text et old_text est différente, la fonction SUBSTITUTE ne remplace pas le texte.
Cette fonction n’est pas prise en charge pour une utilisation en mode DirectQuery quand elle est utilisée dans des colonnes calculées ou des règles de sécurité au niveau des lignes (RLS).
Exemple : substitution dans une chaîne
La formule suivante crée une copie de la colonne [Product Code] dans laquelle toutes les occurrences de l’ancien code de produit PA sont remplacées par le nouveau code de produit NW.
= SUBSTITUTE([Product Code], "NW", "PA")