PowerApps の Replace および Substitute 関数Replace and Substitute functions in PowerApps

テキストの文字列の一部を別の文字列に置換します。Replace a portion of a string of text with another string.

説明Description

Replace 関数は、開始位置と長さによって、置換するテキストを識別します。The Replace function identifies the text to replace by starting position and length.

Substitute 関数は、文字列を照合することで、置換するテキストを識別します。The Substitute function identifies the text to replace by matching a string. 1 つ以上の一致が見つかった場合は、それらのすべてを置き換えるか、置換するいずれかを指定することができます。If more than one match is found, you can replace all of them or specify one to replace.

1 つの文字列を渡すと、変更された文字列が戻り値として返されます。If you pass a single string, the return value is the modified string. 文字列を含む単一列テーブルを渡すと、変更された文字列の単一列テーブルが戻り値として返されます。If you pass a single-column table that contains strings, the return value is a single-column table of modified strings. 複数列テーブルがある場合は、テーブルの使用に関するページの説明に従って、そのテーブルを単一列テーブルにすることができます。If you have a multi-column table, you can shape it into a single-column table, as working with tables describes.

構文Syntax

Replace( String, StartingPosition, NumberOfCharacters, NewString )Replace( String, StartingPosition, NumberOfCharacters, NewString )

  • String - 必須。String - Required. 操作の対象となる文字列。The string to operate on.
  • StartingPosition - 必須。StartingPosition - Required. 置換を開始する文字の位置。Character position to start the replacement. String の最初の文字の位置は 1 です。The first character of String is at position 1.
  • NumberOfCharacters - 必須。NumberOfCharacters - Required. String で置換する文字の数。The number of characters to replace in String.
  • NewString - 必須。NewString - Required. 置換後の文字列。The replacement string. この引数の文字数は、NumberOfCharacters 引数とは異なっていてもかまいません。The number of characters in this argument can differ from the NumberOfCharacters argument.

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

  • String - 必須。String - Required. 操作の対象となる文字列。The string to operate on.
  • OldString - 必須。OldString - Required. 置換の対象となる文字列。The string to replace.
  • NewString - 必須。NewString - Required. 置換後の文字列。The replacement string. OldStringNewString の長さは異なっていてもかまいません。OldString and NewString can have different lengths.
  • InstanceNumber - 省略可能。InstanceNumber - Optional. この引数を使用して、対象のインスタンスの指定OldStringを置き換える文字列1 つ以上のインスタンスが含まれます。Use this argument to specify which instance of OldString to replace if String contains more than one instance. この引数を指定しない場合は、すべてのインスタンスが置き換えられます。If you don't specify this argument, all instances will be replaced.

Replace( SingleColumnTable, StartingPosition, NumberOfCharacters, NewString )Replace( SingleColumnTable, StartingPosition, NumberOfCharacters, NewString )

  • SingleColumnTable - 必須。SingleColumnTable - Required. 操作対象となる複数の文字列の単一列テーブル。A single-column table of strings to operate on.
  • StartingPosition - 必須。StartingPosition - Required. 置換を開始する文字の位置。Character position to start the replacement. テーブルの各文字列の最初の文字の位置は 1 です。The first character of each string in the table is at position 1.
  • NumberOfCharacters - 必須。NumberOfCharacters - Required. 各文字列で置換する文字の数。The number of characters to replace in each string.
  • NewString - 必須。NewString - Required. 置換後の文字列。The replacement string. この引数の文字数は、NumberOfCharacters 引数とは異なっていてもかまいません。The number of characters in this argument can differ from the NumberOfCharacters argument.

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

  • SingleColumnTable - 必須。SingleColumnTable - Required. 操作対象となる複数の文字列の単一列テーブル。A single-column table of strings to operate on.
  • OldString - 必須。OldString - Required. 置換の対象となる文字列。The string to replace.
  • NewString - 必須。NewString - Required. 置換後の文字列。The replacement string. OldStringNewString の長さは異なっていてもかまいません。OldString and NewString can have different lengths.
  • InstanceNumber - 省略可能。InstanceNumber - Optional. この引数を使用して、対象のインスタンスの指定OldStringを置き換える文字列1 つ以上のインスタンスが含まれます。Use this argument to specify which instance of OldString to replace if String contains more than one instance. この引数を指定しない場合は、すべてのインスタンスが置き換えられます。If you don't specify this argument, all instances will be replaced.

Examples

数式Formula 説明Description 結果Result
Replace( "abcdefghijk", 6, 5, "*" )Replace( "abcdefghijk", 6, 5, "*" ) 1 つの"abcdefghijk"の 5 文字を置き換える"*"("f") の 6 番目の文字で始まる文字。Replaces five characters in "abcdefghijk" with a single "*" character, starting with the sixth character ("f"). "abcde*k""abcde*k"
Replace( "2019", 3, 2, "20" )Replace( "2019", 3, 2, "20" ) 「20」と「2019」の最後の 2 つの文字を置き換えます。Replaces the last two characters of "2019" with "20". "2020""2020"
Replace( "123456", 1, 3, "_" )Replace( "123456", 1, 3, "_" ) 「123456」の最初の 3 つの文字を 1 つの「」文字に置き換えます。Replaces the first three characters of "123456" with a single "" character. "_456""_456"
Substitute( "Sales Data", "Sales", "Cost" )Substitute( "Sales Data", "Sales", "Cost" ) "Sales"の「コスト」の文字列に置換されます。Substitutes the string "Cost" for "Sales". 「コスト データ」"Cost Data"
Substitute( "Quarter 1, 2018", "1", "2", 1 )Substitute( "Quarter 1, 2018", "1", "2", 1 ) 「1」と「2」の最初のインスタンスのみを置き換えるため、4 番目の引数 (インスタンス番号) 1 で提供します。Substitutes only the first instance of "1" with "2" because the fourth argument (InstanceNumber) is provided with a 1. 「第 2、2018」"Quarter 2, 2018"
Substitute( "Quarter 1, 2011", "1", "2", 3 )Substitute( "Quarter 1, 2011", "1", "2", 3 ) 「1」と「2」の 3 番目のインスタンスのみを置き換えるため、4 番目の引数 (インスタンス番号) は 3 に付属します。Substitutes only the third instance of "1" with "2" because the fourth argument (InstanceNumber) is provided with a 3. 「四半期 1, 2012」"Quarter 1, 2012"
Substitute( "Quarter 1, 2011", "1", "2" )Substitute( "Quarter 1, 2011", "1", "2" ) 「1」と「2」のすべてのインスタンスを置き換えるため、4 番目の引数 (インスタンス番号) が指定されていません。Substitutes all instances of "1" with "2" because the fourth argument (InstanceNumber) isn't provided. 「第 2、2022」"Quarter 2, 2022"
Replace(
[ "Quarter 1, 2018",
"Quarter 2, 2011",
"Quarter 4, 2019" ],
9, 1, "3" )
Replace(
[ "Quarter 1, 2018",
"Quarter 2, 2011",
"Quarter 4, 2019" ],
9, 1, "3" )
「3」を単一列テーブルの各レコードの 9 番目の文字に置き換えます。Replaces the ninth character in each record of the single-column table with "3". [ "四半期 3、 2018"、[ "Quarter 3, 2018",
"四半期 3、 2011"、"Quarter 3, 2011",
"四半期 3、 2019" ]"Quarter 3, 2019" ]
Substitute(
[ "Qtr 1, 2018",
"Quarter 1, 2011",
"Q1, 2019" ],
"1", "3", 1 )
Substitute(
[ "Qtr 1, 2018",
"Quarter 1, 2011",
"Q1, 2019" ],
"1", "3", 1 )
ため、4 番目の引数 (インスタンス番号) が付属して、値 1、「1」の最初のインスタンスのみの置換「3」を持つ単一列テーブルは、各レコード。Because the fourth argument (InstanceNumber) is provided with a value of 1, substitutes only the first instance of "1" in each record of the single-column table with "3". [ "Qtr 3、 2018"、[ "Qtr 3, 2018",
"四半期 3、 2011"、"Quarter 3, 2011",
"Q3, 2019" ]"Q3, 2019" ]
Substitute(
[ "Qtr 1, 2018",
"Quarter 1, 2011",
"Q1, 2019" ],
"1", "3" )
Substitute(
[ "Qtr 1, 2018",
"Quarter 1, 2011",
"Q1, 2019" ],
"1", "3" )
ため、4 番目の引数 (インスタンス番号) が指定されていません、「3」を単一列テーブルの各レコードの「1」のすべてのインスタンスに置換されます。Because the fourth argument (InstanceNumber) isn't provided, substitutes all instances of "1" in each record of the single-column table with "3". [ "Qtr 3、 2038"、[ "Qtr 3, 2038",
"四半期 3、 2033"、"Quarter 3, 2033",
"Q3, 2039" ]"Q3, 2039" ]