SUBSTITUTESUBSTITUTE

Ersetzt vorhandenen Text durch neuen Text in einer Textzeichenfolge.Replaces existing text with new text in a text string.

SyntaxSyntax

SUBSTITUTE(<text>, <old_text>, <new_text>, <instance_num>)  

ParameterParameters

BenennungTerm DefinitionDefinition
Texttext Der Text, in dem Sie Zeichen ersetzen möchten, oder ein Verweis auf eine Spalte, die Text enthält.The text in which you want to substitute characters, or a reference to a column containing text.
old_textold_text Der vorhandene Text, den Sie ersetzen möchten.The existing text that you want to replace.
new_textnew_text Der Text, durch den old_text ersetzt werden soll.The text you want to replace old_text with.
instance_numinstance_num (optional) Das Vorkommen von old_text, das Sie ersetzen möchten.(optional) The occurrence of old_text you want to replace. Falls weggelassen, wird jedes Vorkommen von old_text ersetzt.If omitted, every instance of old_text is replaced

RückgabewertReturn value

Eine Textzeichenfolge.A string of text.

BemerkungenRemarks

  • Verwenden Sie die SUBSTITUTE-Funktion, wenn Sie einen bestimmten Text in einer Zeichenfolge ersetzen möchten. Verwenden Sie die REPLACE-Funktion, wenn Sie Text variabler Länge ersetzen möchten, der an einer bestimmten Stelle in einer Zeichenfolge vorkommt.Use the SUBSTITUTE function when you want to replace specific text in a text string; use the REPLACE function when you want to replace any text of variable length that occurs in a specific location in a text string.

  • Bei der SUBSTITUTE-Funktion wird Groß-/Kleinschreibung beachtet.The SUBSTITUTE function is case-sensitive. Wenn die Groß-/Kleinschreibung zwischen text und old_text nicht übereinstimmt, ersetzt SUBSTITUTE den Text nicht.If case does not match between text and old_text, SUBSTITUTE will not replace the text.

  • Die Verwendung dieser Funktion im DirectQuery-Modus wird nicht unterstützt, wenn sie in berechneten Spalten oder RLS-Regeln (Row-Level Security) eingesetzt wird.This function is not supported for use in DirectQuery mode when used in calculated columns or row-level security (RLS) rules.

Beispiel: Ersetzen innerhalb einer ZeichenfolgeExample: Substitution within a String

Die folgende Formel erstellt eine Kopie der Spalte [Product Code], in der der alte Produktcode PA durch den neuen Produktcode NW an jeder Stelle in der Spalte ersetzt wird.The following formula creates a copy of the column [Product Code] that substitutes the new product code NW for the old product code PA wherever it occurs in the column.

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

Siehe auchSee also

Textfunktionen.Text functions
REPLACEREPLACE