Class DataValidationBuilder

DataValidationBuilder

Es el compilador de reglas de validación de datos.

// Set the data validation for cell A1 to require a value from B1:B10.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Métodos

Método	Tipo de datos que se devuelve	Descripción breve
build()	DataValidation	Construye una regla de validación de datos a partir de la configuración aplicada al compilador.
copy()	DataValidationBuilder	Crea un compilador para una regla de validación de datos basada en la configuración de esta regla.
getAllowInvalid()	Boolean	Devuelve true si la regla muestra una advertencia cuando la entrada no pasa la validación de datos o false si rechaza la entrada por completo.
getCriteriaType()	DataValidationCriteria	Obtiene el tipo de criterio de la regla, tal como se define en la enumeración DataValidationCriteria.
getCriteriaValues()	Object[]	Obtiene un array de argumentos para los criterios de la regla.
getHelpText()	String	Obtiene el texto de ayuda de la regla o null si no se configuró ningún texto de ayuda.
requireCheckbox()	DataValidationBuilder	Establece la regla de validación de datos para requerir que la entrada sea un valor booleano. Este valor se renderiza como una casilla de verificación.
requireCheckbox(checkedValue)	DataValidationBuilder	Establece la regla de validación de datos para exigir que la entrada sea el valor especificado o esté en blanco.
requireCheckbox(checkedValue, uncheckedValue)	DataValidationBuilder	Establece la regla de validación de datos para exigir que la entrada sea uno de los valores especificados.
requireDate()	DataValidationBuilder	Establece la regla de validación de datos para requerir una fecha.
requireDateAfter(date)	DataValidationBuilder	Establece la regla de validación de datos para requerir una fecha posterior al valor proporcionado.
requireDateBefore(date)	DataValidationBuilder	Establece la regla de validación de datos para requerir una fecha anterior al valor determinado.
requireDateBetween(start, end)	DataValidationBuilder	Establece la regla de validación de datos para requerir una fecha que se encuentre entre dos fechas especificadas o que sea una de ellas.
requireDateEqualTo(date)	DataValidationBuilder	Establece la regla de validación de datos para requerir una fecha igual al valor proporcionado.
requireDateNotBetween(start, end)	DataValidationBuilder	Establece la regla de validación de datos para requerir una fecha que no se encuentre entre dos fechas especificadas ni sea ninguna de ellas.
requireDateOnOrAfter(date)	DataValidationBuilder	Establece la regla de validación de datos para que se requiera una fecha igual o posterior al valor proporcionado.
requireDateOnOrBefore(date)	DataValidationBuilder	Establece la regla de validación de datos para que se requiera una fecha anterior o igual al valor proporcionado.
requireFormulaSatisfied(formula)	DataValidationBuilder	Establece la regla de validación de datos para exigir que la fórmula determinada se evalúe como true.
requireNumberBetween(start, end)	DataValidationBuilder	Establece la regla de validación de datos para que se requiera un número que se encuentre entre dos números especificados o que sea igual a cualquiera de ellos.
requireNumberEqualTo(number)	DataValidationBuilder	Establece la regla de validación de datos para que se requiera un número igual al valor proporcionado.
requireNumberGreaterThan(number)	DataValidationBuilder	Establece la regla de validación de datos para que requiera un número mayor que el valor proporcionado.
requireNumberGreaterThanOrEqualTo(number)	DataValidationBuilder	Establece la regla de validación de datos para que requiera un número mayor o igual que el valor proporcionado.
requireNumberLessThan(number)	DataValidationBuilder	Establece la regla de validación de datos para que se requiera un número inferior al valor determinado.
requireNumberLessThanOrEqualTo(number)	DataValidationBuilder	Establece la regla de validación de datos para requerir un número menor o igual que el valor determinado.
requireNumberNotBetween(start, end)	DataValidationBuilder	Establece la regla de validación de datos para requerir un número que no se encuentre entre dos números especificados ni sea igual a ninguno de ellos.
requireNumberNotEqualTo(number)	DataValidationBuilder	Establece la regla de validación de datos para requerir un número que no sea igual al valor proporcionado.
requireTextContains(text)	DataValidationBuilder	Establece la regla de validación de datos para exigir que la entrada contenga el valor determinado.
requireTextDoesNotContain(text)	DataValidationBuilder	Establece la regla de validación de datos para exigir que la entrada no contenga el valor determinado.
requireTextEqualTo(text)	DataValidationBuilder	Establece la regla de validación de datos para requerir que la entrada sea igual al valor determinado.
requireTextIsEmail()	DataValidationBuilder	Establece la regla de validación de datos para exigir que la entrada tenga el formato de una dirección de correo electrónico.
requireTextIsUrl()	DataValidationBuilder	Establece la regla de validación de datos para exigir que la entrada tenga el formato de una URL.
requireValueInList(values)	DataValidationBuilder	Establece la regla de validación de datos para exigir que la entrada sea igual a uno de los valores proporcionados.
requireValueInList(values, showDropdown)	DataValidationBuilder	Establece la regla de validación de datos para exigir que la entrada sea igual a uno de los valores proporcionados, con una opción para ocultar el menú desplegable.
requireValueInRange(range)	DataValidationBuilder	Establece la regla de validación de datos para exigir que la entrada sea igual a un valor del rango determinado.
requireValueInRange(range, showDropdown)	DataValidationBuilder	Establece la regla de validación de datos para requerir que la entrada sea igual a un valor en el rango determinado, con una opción para ocultar el menú desplegable.
setAllowInvalid(allowInvalidData)	DataValidationBuilder	Establece si se debe mostrar una advertencia cuando la entrada no supere la validación de datos o si se debe rechazar la entrada por completo.
setHelpText(helpText)	DataValidationBuilder	Establece el texto de ayuda que aparece cuando el usuario coloca el cursor sobre la celda en la que se configuró la validación de datos.
withCriteria(criteria, args)	DataValidationBuilder	Establece la regla de validación de datos según los criterios definidos por los valores de DataValidationCriteria, que suelen tomarse de los valores de criteria y arguments de una regla existente.

Documentación detallada

build()

Construye una regla de validación de datos a partir de la configuración aplicada al compilador.

Volver

DataValidation: Es una representación de la regla de validación de datos.

---

copy()

Crea un compilador para una regla de validación de datos basada en la configuración de esta regla.

// Change existing data validation rules that require a date in 2013 to require
// a date in 2014.
const oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
const newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
const rules = range.getDataValidations();

for (let i = 0; i < rules.length; i++) {
  for (let j = 0; j < rules[i].length; j++) {
    const rule = rules[i][j];

    if (rule != null) {
      const criteria = rule.getCriteriaType();
      const args = rule.getCriteriaValues();

      if (criteria === SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN &&
          args[0].getTime() === oldDates[0].getTime() &&
          args[1].getTime() === oldDates[1].getTime()) {
        // Create a builder from the existing rule, then change the dates.
        rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();
      }
    }
  }
}
range.setDataValidations(rules);

Volver

DataValidationBuilder: Es un compilador basado en la configuración de esta regla.

---

getAllowInvalid()

Devuelve true si la regla muestra una advertencia cuando la entrada no pasa la validación de datos o false si rechaza la entrada por completo. El valor predeterminado para las reglas de validación de datos nuevas es true.

Volver

Boolean: true si la regla permite entradas que no superan la validación de datos; false si no es así

---

getCriteriaType()

Obtiene el tipo de criterio de la regla, tal como se define en la enumeración DataValidationCriteria. Para obtener los argumentos de los criterios, usa getCriteriaValues(). Para usar estos valores y crear o modificar una regla de validación de datos, consulta withCriteria(criteria, args).

// Log information about the data validation rule for cell A1.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.');
}

Volver

DataValidationCriteria: Es el tipo de criterio de validación de datos.

---

getCriteriaValues()

Obtiene un array de argumentos para los criterios de la regla. Para obtener el tipo de criterio, usa getCriteriaType(). Para usar estos valores para crear o modificar una regla de validación de datos, consulta withCriteria(criteria, args).

// Log information about the data validation rule for cell A1.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.');
}

Volver

Object[]: Es un array de argumentos adecuados para el tipo de criterio de la regla. La cantidad de argumentos y su tipo coinciden con el método require...() correspondiente de la clase DataValidationBuilder.

---

getHelpText()

Obtiene el texto de ayuda de la regla o null si no se configuró ningún texto de ayuda.

Volver

String: Es el texto de ayuda de la regla o null si no se configuró ningún texto de ayuda.

---

requireCheckbox()

Establece la regla de validación de datos para requerir que la entrada sea un valor booleano. Este valor se renderiza como una casilla de verificación.

// Set the data validation for cell A1 to require a boolean value; the value is
// rendered as a checkbox.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation().requireCheckbox().build();
cell.setDataValidation(rule);

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireCheckbox(checkedValue)

Establece la regla de validación de datos para exigir que la entrada sea el valor especificado o esté en blanco. Cuando la entrada coincide con el valor especificado, la celda se renderiza como una casilla de verificación marcada. Cuando la entrada está en blanco, la celda se renderiza como una casilla de verificación sin marcar.

// Set the data validation for cell A1 to require a custom checked value that is
// rendered as a checkbox.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED').build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
checkedValue	Object	Es el valor asignado a una casilla de verificación marcada.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireCheckbox(checkedValue, uncheckedValue)

Establece la regla de validación de datos para exigir que la entrada sea uno de los valores especificados. Cuando la entrada es checkedValue, la celda se renderiza como una casilla de verificación marcada. Cuando la entrada es uncheckedValue, la celda se renderiza como una casilla de verificación sin marcar.

// Set the data validation for cell A1 to require custom checked values that are
// rendered as a checkbox.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireCheckbox('APPROVED', 'PENDING')
                 .build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
checkedValue	Object	Es el valor asignado a una casilla de verificación marcada.
uncheckedValue	Object	Es el valor asignado a una casilla sin marcar.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireDate()

Establece la regla de validación de datos para requerir una fecha.

// Set the data validation for cell A1 to require a date.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation().requireDate().build();
cell.setDataValidation(rule);

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireDateAfter(date)

Establece la regla de validación de datos para requerir una fecha posterior al valor proporcionado. Se ignoran los campos de hora del objeto Date; solo se usan los campos de día, mes y año.

// Set the data validation for cell A1 to require a date after January 1, 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateAfter(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
date	Date	Es la fecha más reciente inaceptable.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireDateBefore(date)

Establece la regla de validación de datos para requerir una fecha anterior al valor determinado. Se ignoran los campos de hora del objeto Date; solo se usan los campos de día, mes y año.

// Set the data validation for cell A1 to require a date before January 1, 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateBefore(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
date	Date	Es la fecha más temprana inaceptable.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireDateBetween(start, end)

Establece la regla de validación de datos para requerir una fecha que se encuentre entre dos fechas especificadas o que sea una de ellas. Se ignoran los campos de hora de los objetos Date; solo se usan los campos de día, mes y año.

// Set the data validation for cell A1 to require a date in 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation()
        .requireDateBetween(new Date('1/1/2013'), new Date('12/31/2013'))
        .build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
start	Date	Es la fecha más temprana aceptable.
end	Date	Es la fecha más reciente aceptable.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireDateEqualTo(date)

Establece la regla de validación de datos para requerir una fecha igual al valor proporcionado. Se ignoran los campos de hora del objeto Date; solo se usan los campos de día, mes y año.

// Set the data validation for cell A1 to require a date equal to January 1,
// 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateEqualTo(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
date	Date	Es la única fecha aceptable.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireDateNotBetween(start, end)

Establece la regla de validación de datos para requerir una fecha que no se encuentre entre dos fechas especificadas ni sea ninguna de ellas. Se ignoran los campos de hora de los objetos Date; solo se usan los campos de día, mes y año.

// Set the data validation for cell A1 to require a date not in 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation()
        .requireDateNotBetween(new Date('1/1/2013'), new Date('12/31/2013'))
        .build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
start	Date	Es la fecha más temprana inaceptable.
end	Date	Es la fecha más reciente inaceptable.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireDateOnOrAfter(date)

Establece la regla de validación de datos para que se requiera una fecha igual o posterior al valor proporcionado. Se ignoran los campos de hora del objeto Date; solo se usan los campos de día, mes y año.

// Set the data validation for cell A1 to require a date on or after January 1,
// 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateOnOrAfter(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
date	Date	Es la fecha más temprana aceptable.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireDateOnOrBefore(date)

Establece la regla de validación de datos para que se requiera una fecha anterior o igual al valor proporcionado. Se ignoran los campos de hora del objeto Date; solo se usan los campos de día, mes y año.

// Set the data validation for cell A1 to require a date on or before January 1,
// 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateOnOrBefore(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
date	Date	Es la fecha más reciente aceptable.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireFormulaSatisfied(formula)

Establece la regla de validación de datos para exigir que la fórmula determinada se evalúe como true.

// Set the data validation for cell A1 to equal B1 with a custom formula.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireFormulaSatisfied('=EQ(A1,B1)')
                 .build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
formula	String	Es una fórmula personalizada que se evalúa como true si la entrada es válida.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireNumberBetween(start, end)

Establece la regla de validación de datos para que se requiera un número que se encuentre entre dos números especificados o que sea igual a cualquiera de ellos.

// Set the data validation for cell A1 to require a number between 1 and 10.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberBetween(1, 10).build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
start	Number	Es el valor más bajo aceptable.
end	Number	Es el valor más alto aceptable.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireNumberEqualTo(number)

Establece la regla de validación de datos para que se requiera un número igual al valor proporcionado.

// Set the data validation for cell A1 to require a number equal
// to 3.1415926536.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberEqualTo(Math.PI).build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
number	Number	Es el único valor aceptable.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireNumberGreaterThan(number)

Establece la regla de validación de datos para que requiera un número mayor que el valor proporcionado.

// Set the data validation for cell A1 to require a number greater than 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberGreaterThan(0).build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
number	Number	Es el valor más alto que no se acepta.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireNumberGreaterThanOrEqualTo(number)

Establece la regla de validación de datos para que requiera un número mayor o igual que el valor proporcionado.

// Set the data validation for cell A1 to require a number greater than or equal
// to 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireNumberGreaterThanOrEqualTo(0)
                 .build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
number	Number	Es el valor más bajo aceptable.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireNumberLessThan(number)

Establece la regla de validación de datos para que se requiera un número inferior al valor determinado.

// Set the data validation for cell A1 to require a number less than 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberLessThan(0).build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
number	Number	Es el valor más bajo inaceptable.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireNumberLessThanOrEqualTo(number)

Establece la regla de validación de datos para requerir un número menor o igual que el valor determinado.

// Set the data validation for cell A1 to require a number less than or equal to
// 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireNumberLessThanOrEqualTo(0)
                 .build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
number	Number	Es el valor más alto aceptable.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireNumberNotBetween(start, end)

Establece la regla de validación de datos para requerir un número que no se encuentre entre dos números especificados ni sea igual a ninguno de ellos.

// Set the data validation for cell A1 to require a number not between 1 and 10.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberNotBetween(1, 10).build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
start	Number	Es el valor más bajo inaceptable.
end	Number	Es el valor más alto que no se acepta.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireNumberNotEqualTo(number)

Establece la regla de validación de datos para requerir un número que no sea igual al valor proporcionado.

// Set the data validation for cell A1 to require a number not equal to 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberNotEqualTo(0).build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
number	Number	Es el único valor inaceptable.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireTextContains(text)

Establece la regla de validación de datos para exigir que la entrada contenga el valor determinado.

// Set the data validation for cell A1 to require any value that includes
// "Google".
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireTextContains('Google').build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
text	String	Es el valor que debe contener la entrada.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireTextDoesNotContain(text)

Establece la regla de validación de datos para exigir que la entrada no contenga el valor determinado.

// Set the data validation for cell A1 to require any value that does not
// include "@".
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireTextDoesNotContain('@').build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
text	String	Valor que no debe contener la entrada.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireTextEqualTo(text)

Establece la regla de validación de datos para requerir que la entrada sea igual al valor determinado.

// Set the data validation for cell A1 to require "Yes".
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireTextEqualTo('Yes').build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
text	String	Es el único valor aceptable.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireTextIsEmail()

Establece la regla de validación de datos para exigir que la entrada tenga el formato de una dirección de correo electrónico.

// Set the data validation for cell A1 to require text in the form of an email
// address.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation().requireTextIsEmail().build();
cell.setDataValidation(rule);

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireTextIsUrl()

Establece la regla de validación de datos para exigir que la entrada tenga el formato de una URL.

// Set the data validation for cell A1 to require text in the form of a URL.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation().requireTextIsUrl().build();
cell.setDataValidation(rule);

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireValueInList(values)

Establece la regla de validación de datos para exigir que la entrada sea igual a uno de los valores proporcionados.

// Set the data validation for cell A1 to require "Yes" or "No", with a dropdown
// menu.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireValueInList(['Yes', 'No'])
                 .build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
values	String[]	Es un array de valores aceptables.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireValueInList(values, showDropdown)

Establece la regla de validación de datos para exigir que la entrada sea igual a uno de los valores proporcionados, con una opción para ocultar el menú desplegable.

// Set the data validation for cell A1 to require "Yes" or "No", with no
// dropdown menu.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireValueInList(['Yes', 'No'], false)
                 .build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
values	String[]	Es un array de valores aceptables.
showDropdown	Boolean	true si la hoja de cálculo debe mostrar un menú desplegable para los valores; false si no.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireValueInRange(range)

Establece la regla de validación de datos para exigir que la entrada sea igual a un valor del rango determinado.

// Set the data validation for cell A1 to require a value from B1:B10, with a
// dropdown menu.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
range	Range	Es un rango que contiene los valores aceptables.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

requireValueInRange(range, showDropdown)

Establece la regla de validación de datos para requerir que la entrada sea igual a un valor en el rango determinado, con una opción para ocultar el menú desplegable.

// Set the data validation for cell A1 to require value from B1:B10, with no
// dropdown menu.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule = SpreadsheetApp.newDataValidation()
                 .requireValueInRange(range, false)
                 .build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
range	Range	Es un rango que contiene los valores aceptables.
showDropdown	Boolean	true si la hoja de cálculo debe mostrar un menú desplegable para los valores; false si no.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

setAllowInvalid(allowInvalidData)

Establece si se debe mostrar una advertencia cuando la entrada no supere la validación de datos o si se debe rechazar la entrada por completo. El valor predeterminado para las reglas de validación de datos nuevas es true.

Parámetros

Nombre	Tipo	Descripción
allowInvalidData	Boolean	true si la regla debe permitir la entrada que no pasa la validación de datos; false si no.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

setHelpText(helpText)

Establece el texto de ayuda que aparece cuando el usuario coloca el cursor sobre la celda en la que se configuró la validación de datos.

Parámetros

Nombre	Tipo	Descripción
helpText	String	Es el texto de ayuda que se configurará.

Volver

DataValidationBuilder: Este compilador, para encadenar

---

withCriteria(criteria, args)

Establece la regla de validación de datos según los criterios definidos por los valores de DataValidationCriteria, que suelen tomarse de los valores de criteria y arguments de una regla existente.

// Change existing data validation rules that require a date in 2013 to require
// a date in 2014.
const oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
const newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
const rules = range.getDataValidations();

for (let i = 0; i < rules.length; i++) {
  for (let j = 0; j < rules[i].length; j++) {
    const rule = rules[i][j];

    if (rule != null) {
      const criteria = rule.getCriteriaType();
      const args = rule.getCriteriaValues();

      if (criteria === SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN &&
          args[0].getTime() === oldDates[0].getTime() &&
          args[1].getTime() === oldDates[1].getTime()) {
        // Create a builder from the existing rule, then change the dates.
        rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();
      }
    }
  }
}
range.setDataValidations(rules);

Parámetros

Nombre	Tipo	Descripción
criteria	DataValidationCriteria	Es el tipo de criterio de validación de datos.
args	Object[]	Es un array de argumentos adecuados para el tipo de criterio. La cantidad de argumentos y su tipo coinciden con el método require...() correspondiente anterior.

Volver

DataValidationBuilder: Este compilador, para encadenar