Funções Replace e Substitute

Aplica-se a: Aplicações de tela Colunas de fórmula do Dataverse Fluxos de ambiente de trabalho Aplicações condicionadas por modelo Power Platform CLI

Substitua uma parte de uma cadeia de texto por outra cadeia.

Descrição

A função Replace identifica o texto a substituir pela posição inicial e comprimento.

A função Substitute identifica o texto a substituir pela correspondência de uma cadeia. Se for encontrado mais de uma correspondência, pode substituir todas as ou especificar uma para substituir.

Se transmitir uma cadeia única, o valor de retorno será a cadeia modificada. Se transmitir uma tabela de coluna única com cadeias, o valor devolvido será uma tabela de coluna única com uma coluna Valor das cadeias modificadas. Se tiver uma tabela com várias colunas, pode formatá-las para uma tabela com uma única coluna, conforme descrito em trabalhar com tabelas.

Sintaxe

Replace( String, StartingPosition, NumberOfCharacters, NewString )

  • Cadeia – Obrigatório. A cadeia a ser utilizada.
  • StartingPosition – Obrigatório. Posição do caráter a iniciar a substituição. O primeiro caráter da Cadeia é na posição 1.
  • NumberOfCharacters – Obrigatório. O número de carateres a substituir na Cadeia.
  • NewString – Obrigatório. A cadeia de substituição. O número de carateres neste argumento pode diferir do argumento NumberOfCharacters.

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

  • Cadeia – Obrigatório. A cadeia a ser utilizada.
  • OldString – Obrigatório. A cadeia a substituir.
  • NewString – Obrigatório. A cadeia de substituição. OldString e NewString podem ter comprimentos diferentes.
  • InstanceNumber – Opcional. Utilize este argumento para especificar a instância de OldString a substituir se String contiver mais de uma instância. Se não especificar este argumento, todas as instâncias serão substituídas.

Replace( SingleColumnTable, StartingPosition, NumberOfCharacters, NewString )

  • TabelaComUmaÚnicaColuna – Obrigatório. Uma tabela de coluna única de cadeias onde atuar.
  • StartingPosition – Obrigatório. Posição do caráter a iniciar a substituição. O primeiro caráter de cada cadeia na tabela está na posição 1.
  • NumberOfCharacters – Obrigatório. O número de carateres a substituir em cada cadeia.
  • NewString – Obrigatório. A cadeia de substituição. O número de carateres neste argumento pode diferir do argumento NumberOfCharacters.

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

  • TabelaComUmaÚnicaColuna – Obrigatório. Uma tabela de coluna única de cadeias onde atuar.
  • OldString – Obrigatório. A cadeia a substituir.
  • NewString – Obrigatório. A cadeia de substituição. OldString e NewString podem ter comprimentos diferentes.
  • InstanceNumber – Opcional. Utilize este argumento para especificar a instância de OldString a substituir se String contiver mais de uma instância. Se não especificar este argumento, todas as instâncias serão substituídas.

Exemplos

Fórmula Descrição Resultado
Replace( "abcdefghijk", 6, 5, "*" ) Substitui cinco caracteres em "abcdefghijk" com um único carácter "*", a partir do sexto carácter ("f"). "abcde*k"
Replace( "2019", 3, 2, "20" ) Substitui os dois últimos caracteres de "2019" por "20". "2020"
Replace( "123456", 1, 3, "_" ) Substitui os primeiros três caracteres de "123456" por um único carácter "_". "_456"
Substitute( "Sales Data", "Sales", "Cost" ) Substitui a cadeia de "Cost" por "Sales". "Cost Data"
Substitute( "Quarter 1, 2018", "1", "2", 1 ) Substitui apenas a primeira instância de "1" por "2" porque o quarto argumento (InstanceNumber) é fornecido com um 1. "Quarter 2, 2018"
Substitute( "Quarter 1, 2011", "1", "2", 3 ) Substitui apenas a terceira instância de "1" por "2" porque o quarto argumento (InstanceNumber) é fornecido com um 3. "Quarter 1, 2012"
Substitute( "Quarter 1, 2011", "1", "2" ) Substitui todas as instâncias de "1" por "2" porque o quarto argumento (InstanceNumber) não é fornecido. "Quarter 2, 2022"
Replace(
[ "Trimestre 1, 2018",
"Trimestre 2, 2011",
"Trimestre 4, 2019" ],
9, 1, "3" )
Substitui o nono carácter em cada registo da tabela de coluna única com "3". Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: [ "Quarter 3, 2018",
"Trimestre 3, 2011",
"Trimestre 3, 2019" ]
Substitute(
["Tr 1, 2018",
"Trimestre 1, 2011",
"T1, 2019" ],
"1", "3", 1 )
Como o quarto argumento (InstanceNumber) é fornecido com um valor de 1, substitui apenas a primeira instância de "1" em cada registo da tabela de coluna única com "3". Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: [ "Qtr 3, 2018",
"Trimestre 3, 2011",
"Q3,2019"]
Substitute(
["Tr 1, 2018",
"Trimestre 1, 2011",
"T1, 2019" ],
"1", "3" )
Como o quarto argumento (InstanceNumber) não é fornecido, substitui todas as instância de "1" em cada registo da tabela de coluna única com "3". Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: [ "Qtr 3, 2038",
"Trimestre 3, 2033",
"Q3,2039"]