Die Funktionen „Replace“ und „Substitute“

Gilt: Canvas-Spps Dataverse Formelspalten Desktop-Flows Modellgesteuerte Apps Power Platform CLI

Ersetzen Sie einen Teil einer Textzeichenfolge durch eine andere Zeichenfolge.

Description

Die Replace-Funktion identifiziert den zu ersetzenden Text anhand der Anfangsposition und Länge.

Die Substitute-Funktion identifiziert den zu ersetzenden Text anhand einer Übereinstimmung mit einer Zeichenfolge. Wenn mehr als eine Übereinstimmung gefunden wird, können Sie alle ersetzen oder eine zu ersetzende angeben.

Wenn Sie eine einzelne Zeichenfolge übergeben, ist der Rückgabewert die geänderte Zeichenfolge. Wenn Sie eine einspaltige Tabelle übergeben, die Zeichenfolgen enthält, ist der Rückgabewert eine einspaltige Tabelle mit einer Wert-Spalte geänderter Zeichenfolge. Mehrspaltige Tabellen können in einspaltige Tabellen umgeformt werden, wie unter Arbeiten mit Tabellen beschrieben wird.

Syntax

Replace( String, StartingPosition, NumberOfCharacters, NewString )

• Zeichenfolge - Erforderlich. Die zu verarbeitende Zeichenfolge
• StartingPosition: erforderlich. Zeichenposition, ab der ersetzt werden soll. Das erste Zeichen von String befindet sich an Position 1.
• NumberOfCharacters: erforderlich. Die Anzahl der zu ersetzenden Zeichen in String
• NewString: erforderlich. Die Ersatzzeichenfolge. Die Anzahl der Zeichen in diesem Argument kann sich von dem NumberOfCharacters-Argument unterscheiden.

Substitute( String, OldString, NewString [, InstanceNumber ] )

• Zeichenfolge - Erforderlich. Die zu verarbeitende Zeichenfolge
• OldString: erforderlich. Die zu ersetzende Zeichenfolge
• NewString: erforderlich. Die Ersatzzeichenfolge. OldString und NewString können unterschiedlich lang sein.
• InstanceNumber: optional. Verwenden Sie dieses Argument, um anzugeben, welche Instanz von OldString ersetzt werden soll, wenn String mehr als eine Instanz enthält. Wenn Sie dieses Argument nicht angeben, werden alle Instanzen ersetzt.

Replace( SingleColumnTable, StartingPosition, NumberOfCharacters, NewString )

• SingleColumnTable - Erforderlich. Eine einspaltige Tabelle mit Zeichenfolgen, die verarbeitet werden sollen.
• StartingPosition: erforderlich. Zeichenposition, ab der ersetzt werden soll. Das erste Zeichen einer jeden Zeichenfolge in der Tabelle ist an Position 1.
• NumberOfCharacters: erforderlich. Die Zahl der zu ersetzenden Zeichen in jeder Zeichenfolge
• NewString: erforderlich. Die Ersatzzeichenfolge. Die Anzahl der Zeichen in diesem Argument kann sich von dem NumberOfCharacters-Argument unterscheiden.

Substitute( SingleColumnTable, OldString, NewString [, InstanceNumber ] )

• SingleColumnTable - Erforderlich. Eine einspaltige Tabelle mit Zeichenfolgen, die verarbeitet werden sollen.
• OldString: erforderlich. Die zu ersetzende Zeichenfolge
• NewString: erforderlich. Die Ersatzzeichenfolge. OldString und NewString können unterschiedlich lang sein.
• InstanceNumber: optional. Verwenden Sie dieses Argument, um anzugeben, welche Instanz von OldString ersetzt werden soll, wenn String mehr als eine Instanz enthält. Wenn Sie dieses Argument nicht angeben, werden alle Instanzen ersetzt.

Beispiele

Formel	Beschreibung	Ergebnis
Replace( „abcdefghijk“,6,5,„*“)	Ersetzt fünf Zeichen in "abcdefghijk" durch ein einzelnes "*"-Zeichen, beginnend mit dem sechsten Zeichen ("f").	"abcde*k"
Replace(„2019“, 3, 2, „20“)	Ersetzt die letzten beiden Zeichen von "2019" durch "20".	"2020"
replace(„123456“. 1, 3, „_“ )	Ersetzt die ersten drei Zeichen von "123456" durch ein einzelnes "_".	"_456"
Substitute( „Sales Data“, „Sales“, „Cost“)	Ersetzt die Zeichenfolge "Cost" durch "Sales".	"Cost Data"
Substitute( „Quarter 1, 2018“, „1“, „2“, 1 )	Ersetzt nur die erste Instanz von "1" durch "2", weil das vierte Argument (InstanceNumber) mit einer 1 versehen ist.	"Quarter 2, 2018"
Substitute( „Quarter 1, 2011“, „1“, „2“, 3 )	Ersetzt nur die dritte Instanz von "1" durch "2", weil das vierte Argument (InstanceNumber) mit einer 3 versehen ist.	"Quarter 1, 2012"
Substitute( „Quarter 1, 2011“, „1“, „2“)	Ersetzt alle Instanzen von "1" durch "2", weil das vierte Argument (InstanceNumber) nicht vorhanden ist.	"Quarter 2, 2022"
Replace( [ „Quartal, 1, 2018“, „Quartal, 2, 2011“, „Quartal, 4, 2019“ ], 9, 1, „3“ )	Ersetzt das neunte Zeichen in jedem Datensatz der einspaltigen Tabelle durch "3".	Eine einspaltige Tabelle mit einer Value-Spalte mit folgenden Werten: [ „3. Quartal 2018“, „Quartal, 3, 2011“, „Quartal, 3, 2019“ ]
Ersatz( [ „Qtr 1, 2018“, „Quartal, 1, 2011“, „Q1, 2019“], „1“, „3“, 1 )	Weil das vierte Argument (InstanceNumber) mit dem Wert 1 versehen wird und nur die erste Instanz von "1" in jedem Datensatz der einspaltigen Tabelle durch "3" ersetzt.	Eine einspaltige Tabelle mit einer Value-Spalte mit folgenden Werten: [ „3. Qu. 2018“, „Quartal, 3, 2011“, "Q3,2019"]
Ersatz( [ „Qtr 1, 2018“, „Quartal, 1, 2011“, „Q1, 2019“], „1“, „3“)	Weil das vierte Argument (InstanceNumber) nicht bereitgestellt wird, werden alle Instanzen von "1" in jedem Datensatz der einspaltigen Tabelle durch "3" ersetzt.	Eine einspaltige Tabelle mit einer Value-Spalte mit folgenden Werten: [ „3. Qu. 2038“, Quartal, 3, 2033, "Q3,2039"]