Lire en anglais

Partager via


SUBSTITUTE

S’applique à : Colonne calculée Table calculée Mesure Calcul 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")  

Fonctions de texte
REPLACE