Crear, acceder y modificar rangos con nombre en una hoja de cálculo Los rangos con nombre son rangos que tienen alias de cadenas asociados. Se pueden ver y editar a través de la IU de Hojas de cálculo en el menú Datos > Rangos nombrados….
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
get | String | Obtiene el nombre de este rango con nombre. |
get | Range | Obtiene el rango al que hace referencia este rango con nombre. |
remove() | void | Borra este rango con nombre. |
set | Named | Establece o actualiza el nombre del rango con nombre. |
set | Named | Establece o actualiza el rango de este rango con nombre. |
Documentación detallada
getName()
Obtiene el nombre de este rango con nombre.
Volver
String
: Es el nombre de este rango con nombre.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange()
Obtiene el rango al que hace referencia este rango con nombre.
Volver
Range
: Es el rango de la hoja de cálculo asociado con este rango con nombre.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove()
Borra este rango con nombre.
// The code below deletes all the named ranges in the spreadsheet.
const namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (let i = 0; i < namedRanges.length; i++) {
namedRanges[i].remove();
}
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setName(name)
Establece o actualiza el nombre del rango con nombre.
// The code below updates the name for the first named range.
const namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
if (namedRanges.length > 1) {
namedRanges[0].setName('UpdatedNamedRange');
}
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
name | String | Es el nombre nuevo del rango con nombre. |
Volver
Named
: Es el rango cuyo nombre se configuró con la llamada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRange(range)
Establece o actualiza el rango de este rango con nombre.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
range | Range | Es el rango de la hoja de cálculo que se asociará con este rango con nombre. |
Volver
Named
: Es el rango con nombre para el que se estableció el rango de la hoja de cálculo.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets