Funciones Replace y Substitute

Se aplica a: Aplicaciones de Canvas Dataverse Columnas de fórmulas Flujos de Escritorio Aplicaciones basadas en modelos Power Pages Power Platform CLI

Reemplace una parte de una cadena de texto por otra cadena.

Description

La función Replace identifica el texto que se debe reemplazar según la posición inicial y la longitud.

La función Substitute identifica el texto que se debe reemplazar buscando una cadena coincidente. Si se encuentra más de una coincidencia, puede reemplazarlas todas o especificar una para reemplazar.

Si pasa una única cadena, el valor devuelto es la cadena modificada. Si pasa una tabla de una sola columna que contiene cadenas, el valor devuelto es la tabla de una sola columna con una columna Valor de cadenas modificadas. Si tiene una tabla con varias columnas, puede convertirla en una tabla de una sola columna, como se describe en cómo trabajar con tablas.

Sintaxis

Reemplazar( Cadena, Posición inicial, Número de caracteres, NuevaCadena )

• Cadena - Obligatorio. La cadena en la que se va a actuar.
• StartingPosition - Obligatorio. La posición del carácter en la que se va a iniciar el reemplazo. El primer carácter de String está en la posición 1.
• NumberOfCharacters - Obligatorio. El número de caracteres que se van a reemplazar en String.
• NewString - Obligatorio. La cadena de reemplazo. El número de caracteres de este argumento puede diferir del argumento NumberOfCharacters.

Sustituir( Cadena, Cadena antigua, Cadena nueva [, Número de instancia ] )

• Cadena - Obligatorio. La cadena en la que se va a actuar.
• OldString - Obligatorio. La cadena que se va a reemplazar.
• NewString - Obligatorio. La cadena de reemplazo. OldString y NewString pueden tener longitudes diferentes.
• InstanceNumber - Opcional. Use este argumento para especificar qué instancia de OldString se va a reemplazar si String contiene más de una instancia. Si no especifica este argumento, todas las instancias serán reemplazadas.

Reemplazar( TablaDeColumnaÚnica, PosiciónInicio, NúmeroDeCaracteres, NuevaCadena )

• SingleColumnTable : Obligatorio. Una tabla de números de una sola columna sobre la que se va a actuar.
• StartingPosition - Obligatorio. La posición del carácter en la que se va a iniciar el reemplazo. El primer carácter de cada cadena de la tabla se encuentra en la posición 1.
• NumberOfCharacters - Obligatorio. El número de caracteres que se van a reemplazar en cada cadena.
• NewString - Obligatorio. La cadena de reemplazo. El número de caracteres de este argumento puede diferir del argumento NumberOfCharacters.

Sustituir( TablaDeColumnaÚnica, CadenaAnterior, CadenaNueva [, NúmeroDeInstancia ] )

• SingleColumnTable : Obligatorio. Una tabla de números de una sola columna sobre la que se va a actuar.
• OldString - Obligatorio. La cadena que se va a reemplazar.
• NewString - Obligatorio. La cadena de reemplazo. OldString y NewString pueden tener longitudes diferentes.
• InstanceNumber - Opcional. Use este argumento para especificar qué instancia de OldString se va a reemplazar si String contiene más de una instancia. Si no especifica este argumento, todas las instancias serán reemplazadas.

Ejemplos

Fórmula	Descripción	Resultado
Reemplazar("abcdefghijk", 6, 5, "*")	Reemplaza cinco caracteres en "abcdefghijk" con un solo carácter "*", comenzando por el sexto carácter ("f").	"abcde*k"
Reemplazar("2019", 3, 2, "20")	Reemplaza los dos últimos caracteres de "2019" con "20".	"2020"
Reemplazar("123456", 1, 3, "_")	Reemplaza los primeros tres caracteres de "123456" con un solo carácter "_".	"_456"
Sustituir("Datos de ventas", "Ventas", "Costo")	Sustituye la cadena "Cost" por "Sales".	"Cost Data"
Sustituir( "Primer trimestre de 2018", "1", "2", 1 )	Sustituye solo la primera instancia de "1" con "2" porque el cuarto argumento (InstanceNumber) está provisto de un 1.	"Quarter 2, 2018"
Sustituir( "Primer trimestre de 2011", "1", "2", 3 )	Sustituye solo la tercera instancia de "1" con "2" porque el cuarto argumento (InstanceNumber) está provisto de un 3.	"Quarter 1, 2012"
Sustituir( "Primer trimestre de 2011", "1", "2" )	Sustituye todas las instancias de "1" con "2" porque no se proporciona el cuarto argumento (InstanceNumber).	"Quarter 2, 2022"
Reemplazar( [ "Quarter 1, 2018", "Quarter 2, 2011", "Quarter 4, 2019" ], 9, 1, "3" )	Reemplaza el noveno carácter de cada registro de la tabla de una columna con "3".	Una tabla de una sola columna con una columna Value que contiene los siguientes valores: [ "Trimestre 3, 2018", "Quarter 3, 2011", "Quarter 3, 2019" ]
Sustituto( [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 2019" ], "1", "3", 1 )	Porque el cuarto argumento (InstanceNumber) se proporciona con un valor de 1, sustituye solo la primera instancia de "1" en cada registro de la tabla de una sola columna con "3".	Una tabla de una sola columna con una columna Value que contiene los siguientes valores: [ "Trimestre 3, 2018", "Quarter 3, 2011", "Q3,2019"]
Sustituto( [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 2019" ], "1", "3" )	Porque el cuarto argumento (InstanceNumber) no se proporciona, sustituye todas las instancia de "1" en cada registro de la tabla de una sola columna con "3".	Una tabla de una sola columna con una columna Value que contiene los siguientes valores: [ "Trimestre 3, 2038", "Quarter 3, 2033", "Q3,2039"]