Funciones Replace y Substitute
Se aplica a:
Aplicaciones de lienzo Columnas de fórmulas de Dataverse Flujos de escritorio Aplicaciones basadas en modelos 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
Replace( String, StartingPosition, NumberOfCharacters, NewString )
- String: requerido. La cadena en la que se va a actuar.
- StartingPosition: requerido. 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: requerido. El número de caracteres que se van a reemplazar en String.
- NewString: requerido. La cadena de reemplazo. El número de caracteres de este argumento puede diferir del argumento NumberOfCharacters.
Substitute( String, OldString, NewString [, InstanceNumber ] )
- String: requerido. La cadena en la que se va a actuar.
- OldString: requerido. La cadena que se va a reemplazar.
- NewString: requerido. La cadena de reemplazo. OldString y NewString pueden tener longitudes distintas.
- 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.
Replace( SingleColumnTable, StartingPosition, NumberOfCharacters, NewString )
- SingleColumnTable: requerido. Una tabla de números de una sola columna sobre la que se va a actuar.
- StartingPosition: requerido. 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: requerido. El número de caracteres que se van a reemplazar en cada cadena.
- NewString: requerido. La cadena de reemplazo. El número de caracteres de este argumento puede diferir del argumento NumberOfCharacters.
Substitute( SingleColumnTable, OldString, NewString [, InstanceNumber ] )
- SingleColumnTable: requerido. Una tabla de números de una sola columna sobre la que se va a actuar.
- OldString: requerido. La cadena que se va a reemplazar.
- NewString: requerido. La cadena de reemplazo. OldString y NewString pueden tener longitudes distintas.
- 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 |
|---|---|---|
| Replace( "abcdefghijk", 6, 5, "*" ) | Reemplaza cinco caracteres en "abcdefghijk" con un solo carácter "*", comenzando por el sexto carácter ("f"). | "abcde*k" |
| Replace( "2019", 3, 2, "20" ) | Reemplaza los dos últimos caracteres de "2019" con "20". | "2020" |
| Replace( "123456", 1, 3, "_" ) | Reemplaza los primeros tres caracteres de "123456" con un solo carácter "_". | "_456" |
| Substitute( "Sales Data", "Sales", "Cost" ) | Sustituye la cadena "Cost" por "Sales". | "Cost Data" |
| Substitute( "Quarter 1, 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" |
| Substitute( "Quarter 1, 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" |
| Substitute( "Quarter 1, 2011", "1", "2" ) | Sustituye todas las instancias de "1" con "2" porque no se proporciona el cuarto argumento (InstanceNumber). | "Quarter 2, 2022" |
| Replace( [ "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" ] |
| Substitute( [ "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"] |
| Substitute( [ "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"] |