Replace 與 Substitute 函式
適用於：
畫布應用 Dataverse 公式列 桌面流 模型驅動應用 Power Pages Power Platform CLI
將文字字串的一部分以另一個字串取代。
Description
Replace 函式會以開始位置和長度來識別要取代的文字。
Substitute 函式則會比對字串來識別要取代的文字。 如果找到多個相符的字串，您可以將它們全部取代或指定一個來取代。
如果您傳遞單一字串，則傳回值是修改後的字串。 如果您傳遞包含字串的單欄資料表，則傳回值是包含已修改字串的值欄的單欄資料表。 如果您有多欄資料表，您可依照 使用資料表 所述，將該資料表改為單欄資料表。
語法
替換（String，StartingPosition，NumberOfCharacters，NewString ）
- string - 必需。 要處理的字串。
- StartingPosition - 必需。 要開始取代的字元位置。 String 的第一個字元在位置 1。
- NumberOfCharacters - 必需。 String 中要取代的字元數。
- NewString - 必需。 取代字串。 此引數中的字元數可能與 NumberOfCharacters 引數不同。
替代（String，OldString，NewString [， InstanceNumber ]）
- string - 必需。 要處理的字串。
- OldString - 必需。 要取代的字串。
- NewString - 必需。 取代字串。 OldString 和 NewString 可以具有不同的長度。
- InstanceNumber - 可選。 當 String 包含多個實例時，請使用此引數來指定要取代的 OldString 實例。 如果不指定此參數，則會取代所有實例。
替換（SingleColumnTable，StartingPosition，NumberOfCharacters，NewString ）
- SingleColumnTable - 必需。 要處理的字串單欄資料表。
- StartingPosition - 必需。 要開始取代的字元位置。 資料表中每個字串的第一個字元在位置 1。
- NumberOfCharacters - 必需。 每個字串中要取代的字元數。
- NewString - 必需。 取代字串。 此引數中的字元數可能與 NumberOfCharacters 引數不同。
替換（SingleColumnTable，OldString，NewString [， InstanceNumber ]）
- SingleColumnTable - 必需。 要處理的字串單欄資料表。
- OldString - 必需。 要取代的字串。
- NewString - 必需。 取代字串。 OldString 和 NewString 可以具有不同的長度。
- InstanceNumber - 可選。 當 String 包含多個實例時，請使用此引數來指定要取代的 OldString 實例。 如果不指定此參數，則會取代所有實例。
範例
| 公式 | 描述 | 結果 |
|---|---|---|
| 替換（“abcdefghijk”，6，5，“*”） | 將「abcdefghijk」中，從第六個字元 (「f」) 開始的五個字元取代為單一「*」字元。 | "abcde*k" |
| 取代（“2019”，3，2，“20”） | 將「2019」的後兩個字元取代為「20」。 | 「2020」 |
| 取代（“123456”，1，3，“_”） | 會以單一「_ 」字元取代「123456」的前三個字元。 | 「_456」 |
| substitute（“銷售數據”，“銷售額”，“成本”） | 將字串「成本」取代為「銷售」。 | 「成本資料」 |
| 替代（“2018 年第 1 季度”，“1”，“2”，1） | 因為第四個參數 (InstanceNumber) 提供 1，所以只取代第一個「1」與「2」的實例。 | 「2018 年第 2 季」 |
| Substitute（“2011 年第 1 季度”，“1”，“2”，3） | 因為第四個參數 (InstanceNumber) 提供一個 3，所以只將「1」的第三個實例替代為「 2」。 | 「2012 年第 1 季」 |
| 替代（“Quarter 1，2011”，“1”，“2”） | 因為沒提供第四個參數 (InstanceNumber)，所以將「1」的所有實例替代為「 2」。 | 「2022 年第 2 季」 |
| 取代（ [ "Quarter 1, 2018", "Quarter 2, 2011", "Quarter 4, 2019" ], 9, 1, "3" ) |
會以「3」取代單一欄資料表每個記錄中的第九個字元。 | 單欄資料表，其中的 Value 欄包含下列值：[ "Quarter 3, 2018","Quarter 3, 2011", "Quarter 3, 2019" ] |
| 替代（ [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 2019" ], "1", "3", 1 ) |
因為第四個參數 (InstanceNumber) 提供的值為 1，所以只會在單一欄表中的每個記錄中只取代第一個「1」的實例。 | 單欄資料表，其中的 Value 欄包含下列值：[ "Qtr 3, 2018","Quarter 3, 2011", "Q3, 2019" ] |
| 替代（ [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 2019" ], "1", "3" ) |
因為無法提供第四個參數 (InstanceNumber) ，所以只會在單一欄表中的每個記錄中以「3」來取代所有「1」的實例。 | 單欄資料表，其中的 Value 欄包含下列值：[ "Qtr 3, 2038","Quarter 3, 2033", 「2019年， 第3季」 ] |