Busca o reemplaza texto dentro de un rango, una hoja o una hoja de cálculo. También se pueden especificar opciones de búsqueda.
Métodos
| Método | Tipo de datos que se devuelve | Descripción breve |
|---|---|---|
find | Range[] | Devuelve todas las celdas que coinciden con los criterios de búsqueda. |
find | Range | Devuelve la siguiente celda que coincide con los criterios de búsqueda. |
find | Range | Devuelve la celda anterior que coincide con los criterios de búsqueda. |
get | Range | Devuelve la celda actual que coincide con los criterios de búsqueda. |
ignore | Text | Si es true, configura la búsqueda para que ignore los signos diacríticos durante la coincidencia; de lo contrario, la búsqueda coincide con los signos diacríticos. |
match | Text | Si es true, configura la búsqueda para que coincida exactamente con las mayúsculas y minúsculas del texto de búsqueda. De lo contrario, la búsqueda se establece de forma predeterminada para que no distinga entre mayúsculas y minúsculas. |
match | Text | Si es true, configura la búsqueda para que coincida con todo el contenido de una celda; de lo contrario, la búsqueda se establece de forma predeterminada en la coincidencia parcial. |
match | Text | Si es true, configura la búsqueda para que muestre coincidencias que aparecen dentro del texto de la fórmula; de lo contrario, las celdas con fórmulas se consideran según su valor mostrado. |
replace | Integer | Reemplaza todas las coincidencias con el texto especificado. |
replace | Integer | Reemplaza el texto de búsqueda en la celda que coincide actualmente con el texto especificado y devuelve la cantidad de coincidencias reemplazadas. |
start | Text | Configura la búsqueda para que comience inmediatamente después del rango de celdas especificado. |
use | Text | Si es true, configura la búsqueda para que interprete la cadena de búsqueda como una expresión regular; de lo contrario, la búsqueda interpreta la cadena de búsqueda como texto normal. |
Documentación detallada
findAll()
Devuelve todas las celdas que coinciden con los criterios de búsqueda.
Volver
Range[]: Todas las celdas coincidentes.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
findNext()
Devuelve la siguiente celda que coincide con los criterios de búsqueda.
Volver
Range: La siguiente celda coincidente o null si no hay coincidencias anteriores.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
findPrevious()
Devuelve la celda anterior que coincide con los criterios de búsqueda.
Volver
Range: Es la celda coincidente anterior o null si no hay coincidencias anteriores.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getCurrentMatch()
Devuelve la celda actual que coincide con los criterios de búsqueda.
Volver
Range: Es la celda coincidente actual o null si no hay más coincidencias.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
ignoreDiacritics(ignoreDiacritics)
Si es true, configura la búsqueda para que ignore los signos diacríticos durante la coincidencia; de lo contrario, la búsqueda coincide con los signos diacríticos. Un signo diacrítico es un signo, como un acento o una cedilla, que, cuando se escribe arriba o debajo de una letra, indica una diferencia en la pronunciación de la misma letra cuando no está marcada o está marcada de manera diferente.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
ignore | Boolean | Indica si la búsqueda tiene en cuenta los signos diacríticos. |
Volver
TextFinder: Es el buscador de texto, para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchCase(matchCase)
Si es true, configura la búsqueda para que coincida exactamente con las mayúsculas y minúsculas del texto de búsqueda. De lo contrario, la búsqueda se establece de forma predeterminada para que no distinga entre mayúsculas y minúsculas.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
match | Boolean | Indica si la coincidencia distingue mayúsculas de minúsculas. |
Volver
TextFinder: Es el buscador de texto, para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchEntireCell(matchEntireCell)
Si es true, configura la búsqueda para que coincida con todo el contenido de una celda; de lo contrario, la búsqueda se establece de forma predeterminada en la coincidencia parcial.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
match | Boolean | Indica si coincide toda la celda. |
Volver
TextFinder: Es el buscador de texto, para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchFormulaText(matchFormulaText)
Si es true, configura la búsqueda para que muestre coincidencias que aparecen dentro del texto de la fórmula; de lo contrario, las celdas con fórmulas se consideran según su valor mostrado.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
match | Boolean | Indica si la búsqueda examina el texto de la fórmula. |
Volver
TextFinder: Es el buscador de texto, para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
replaceAllWith(replaceText)
Reemplaza todas las coincidencias con el texto especificado. Devuelve la cantidad de ocurrencias reemplazadas, que puede ser diferente de la cantidad de celdas coincidentes.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
replace | String | Es el texto que reemplaza el texto de las celdas coincidentes. |
Volver
Integer: Es la cantidad de ocurrencias reemplazadas.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
replaceWith(replaceText)
Reemplaza el texto de búsqueda en la celda que coincide actualmente con el texto especificado y devuelve la cantidad de coincidencias reemplazadas.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
replace | String | Es el texto que reemplaza el contenido de la celda que coincide actualmente. |
Volver
Integer: Es la cantidad de ocurrencias reemplazadas.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
startFrom(startRange)
Configura la búsqueda para que comience inmediatamente después del rango de celdas especificado.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
start | Range | Es el rango de celdas después del cual debe comenzar la búsqueda. |
Volver
TextFinder: Es el buscador de texto, para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
useRegularExpression(useRegEx)
Si es true, configura la búsqueda para que interprete la cadena de búsqueda como una expresión regular; de lo contrario, la búsqueda interpreta la cadena de búsqueda como texto normal. Para obtener más detalles sobre cómo usar expresiones regulares, consulta la
página de asistencia de Buscar y reemplazar.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
use | Boolean | Indica si se debe interpretar la cadena de búsqueda como una expresión regular. |
Volver
TextFinder: Es el buscador de texto, para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets