Partager via


Fonction SUBSTITUTE

Remplace le 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 substituer des caractères ou référence à une colonne qui contient du texte.

old_text

Texte existant que vous souhaitez remplacer.

new_text

Texte par lequel vous souhaitez remplacer old_text.

instance_num

(facultatif) Occurrence d'old_text que vous souhaitez remplacer. En cas d'omission, chaque instance d'old_text est remplacée.

Valeur de propriété/valeur de retour

Chaîne de texte.

Notes

Utilisez la fonction SUBSTITUTE lorsque vous souhaitez remplacer un texte spécifique dans une chaîne de texte ; utilisez la fonction REPLACE lorsque vous souhaitez remplacer tout texte de longueur variable, présent à un emplacement spécifique dans une chaîne de texte.

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

Cette fonction DAX peut retourner des résultats différents lorsqu'elle est utilisée dans un modèle déployé puis interrogé en mode DirectQuery. Pour plus d'informations sur les différences sémantiques en mode DirectQuery, consultez https://go.microsoft.com/fwlink/?LinkId=219171.

Exemple : substitution dans une chaîne

Description

La formule suivante crée une copie de la colonne [Product Code] qui substitue le nouveau code de produit NW à l'ancien code de produit PA chaque fois qu'il apparaît dans la colonne.

Code

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

Voir aussi

Référence

Fonction REPLACE

Autres ressources

Fonctions de texte (DAX)