Partager via


SUBSTITUTE

s’applique à :colonne calculéetable calculéemesurecalcul 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
text Texte dans lequel vous souhaitez remplacer des caractères ou une référence à une colonne contenant du texte.
old_text Texte existant à remplacer.
new_text Texte avec lequel vous souhaitez remplacer old_text.
instance_num (facultatif) Occurrence de old_text vous souhaitez remplacer. S’il est omis, chaque instance de old_text est remplacée

Valeur de retour

Chaîne de texte.

Remarques

  • Utilisez la fonction SUBSTITUTE lorsque vous souhaitez remplacer du texte spécifique dans une chaîne de texte ; utilisez la fonction REPLACE lorsque vous souhaitez remplacer tout texte de longueur variable qui se produit dans un emplacement spécifique dans une chaîne de texte.

  • La fonction SUBSTITUTE respecte la casse. Si le cas ne correspond pas entre text et old_text, SUBSTITUTE ne remplace pas le texte.

  • Cette fonction n’est pas prise en charge pour une utilisation en mode DirectQuery lorsqu’elle est utilisée dans les colonnes calculées ou les 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 [Code produit] qui remplace le nouveau code de produit NW pour l’ancien code de produit PA où qu’il se produise dans la colonne.

= SUBSTITUTE([Product Code], "NW", "PA")

fonctions texte REPLACE