Class NamedRange

NamedRange

Crear, acceder y modificar rangos con nombre en una hoja de cálculo Los rangos con nombre son rangos que tienen alias de cadena asociados. Se pueden ver y editar en la IU de Hojas de cálculo en el menú Datos > Rangos con nombre….

Métodos

MétodoTipo de datos que se devuelveDescripción breve
getName()StringObtiene el nombre de este rango con nombre.
getRange()RangeObtiene el rango al que hace referencia este rango con nombre.
remove()voidBorra este rango con nombre.
setName(name)NamedRangeEstablece o actualiza el nombre del rango con nombre.
setRange(range)NamedRangeEstablece o actualiza el rango para este rango con nombre.

Documentación detallada

getName()

Obtiene el nombre de este rango con nombre.

Volver

String: 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 alcances:

  • 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 alcances:

  • 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 alcances:

  • 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

NombreTipoDescripción
nameStringEs el nombre nuevo del rango con nombre.

Volver

NamedRange: Es el rango cuyo nombre se estableció en la llamada.

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

setRange(range)

Establece o actualiza el rango para este rango con nombre.

Parámetros

NombreTipoDescripción
rangeRangeEs el rango de la hoja de cálculo que se asociará con este rango con nombre.

Volver

NamedRange: 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 alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets