Class ConditionalFormatRuleBuilder

ConditionalFormatRuleBuilder

Compilador para reglas de formato condicional.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number between 1 and 10.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Métodos

MétodoTipo de datos que se muestraDescripción breve
build()ConditionalFormatRuleConstruye una regla de formato condicional a partir de la configuración aplicada al compilador.
copy()ConditionalFormatRuleBuilderMuestra un ajuste predeterminado del creador de reglas con la configuración de esta regla.
getBooleanCondition()BooleanConditionRecupera la información BooleanCondition de la regla si esta usa criterios de condición booleano.
getGradientCondition()GradientConditionRecupera la información de GradientCondition de la regla, si esta usa criterios de condición de gradiente.
getRanges()Range[]Recupera los rangos a los que se aplica esta regla de formato condicional.
setBackground(color)ConditionalFormatRuleBuilderEstablece el color de fondo para el formato de la regla de formato condicional.
setBackgroundObject(color)ConditionalFormatRuleBuilderEstablece el color de fondo para el formato de la regla de formato condicional.
setBold(bold)ConditionalFormatRuleBuilderEstablece la negrita del texto para el formato de la regla de formato condicional.
setFontColor(color)ConditionalFormatRuleBuilderEstablece el color de fuente para el formato de la regla de formato condicional.
setFontColorObject(color)ConditionalFormatRuleBuilderEstablece el color de fuente para el formato de la regla de formato condicional.
setGradientMaxpoint(color)ConditionalFormatRuleBuilderBorra el valor de punto máximo de gradiente de la regla de formato condicional y, en su lugar, usa el valor máximo de los rangos de la regla.
setGradientMaxpointObject(color)ConditionalFormatRuleBuilderBorra el valor de punto máximo de gradiente de la regla de formato condicional y, en su lugar, usa el valor máximo de los rangos de la regla.
setGradientMaxpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderEstablece los campos de punto máximo de gradiente de la regla de formato condicional.
setGradientMaxpointWithValue(color, type, value)ConditionalFormatRuleBuilderEstablece los campos de punto máximo de gradiente de la regla de formato condicional.
setGradientMidpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderConfigura los campos de punto medio de gradiente de la regla de formato condicional.
setGradientMidpointWithValue(color, type, value)ConditionalFormatRuleBuilderConfigura los campos de punto medio de gradiente de la regla de formato condicional.
setGradientMinpoint(color)ConditionalFormatRuleBuilderBorra el valor de punto mínimo del gradiente de la regla de formato condicional y, en su lugar, usa el valor mínimo en los rangos de la regla.
setGradientMinpointObject(color)ConditionalFormatRuleBuilderBorra el valor de punto mínimo del gradiente de la regla de formato condicional y, en su lugar, usa el valor mínimo en los rangos de la regla.
setGradientMinpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderConfigura los campos de punto mínimo de gradiente de la regla de formato condicional.
setGradientMinpointWithValue(color, type, value)ConditionalFormatRuleBuilderConfigura los campos de punto mínimo de gradiente de la regla de formato condicional.
setItalic(italic)ConditionalFormatRuleBuilderEstablece la cursiva de texto para el formato de la regla de formato condicional.
setRanges(ranges)ConditionalFormatRuleBuilderEstablece uno o más rangos a los que se aplica esta regla de formato condicional.
setStrikethrough(strikethrough)ConditionalFormatRuleBuilderEstablece tachado en el texto para el formato de la regla de formato condicional.
setUnderline(underline)ConditionalFormatRuleBuilderEstablece el subrayado de texto para el formato de la regla de formato condicional.
whenCellEmpty()ConditionalFormatRuleBuilderConfigura la regla de formato condicional que se activará cuando la celda esté vacía.
whenCellNotEmpty()ConditionalFormatRuleBuilderConfigura la regla de formato condicional que se activará cuando la celda no esté vacía.
whenDateAfter(date)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando una fecha sea posterior al valor determinado.
whenDateAfter(date)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando una fecha sea posterior a la fecha relativa determinada.
whenDateBefore(date)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando una fecha sea anterior a la fecha especificada.
whenDateBefore(date)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando una fecha sea anterior a la fecha relativa determinada.
whenDateEqualTo(date)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando una fecha sea igual a la fecha determinada.
whenDateEqualTo(date)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando una fecha sea igual a la fecha relativa determinada.
whenFormulaSatisfied(formula)ConditionalFormatRuleBuilderConfigura la regla de formato condicional que se activará cuando la fórmula dada se evalúe como true.
whenNumberBetween(start, end)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando un número se encuentre entre dos valores especificados o sea cualquiera de ellos.
whenNumberEqualTo(number)ConditionalFormatRuleBuilderConfigura la regla de formato condicional que se activará cuando un número sea igual al valor determinado.
whenNumberGreaterThan(number)ConditionalFormatRuleBuilderConfigura la regla de formato condicional que se activa cuando un número es mayor que el valor especificado.
whenNumberGreaterThanOrEqualTo(number)ConditionalFormatRuleBuilderConfigura la regla de formato condicional que se activa cuando un número es mayor o igual que el valor determinado.
whenNumberLessThan(number)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando un número sea inferior al valor determinado.
whenNumberLessThanOrEqualTo(number)ConditionalFormatRuleBuilderConfigura la regla de formato condicional que se activa cuando un número es menor o igual que el valor determinado.
whenNumberNotBetween(start, end)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando un número no se encuentre en el medio o no sea ninguno de los dos valores especificados.
whenNumberNotEqualTo(number)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando un número no sea igual al valor especificado.
whenTextContains(text)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando la entrada contenga el valor determinado.
whenTextDoesNotContain(text)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando la entrada no contenga el valor determinado.
whenTextEndsWith(text)ConditionalFormatRuleBuilderConfigura la regla de formato condicional que se activa cuando la entrada finaliza con el valor determinado.
whenTextEqualTo(text)ConditionalFormatRuleBuilderConfigura la regla de formato condicional que se activará cuando la entrada sea igual al valor determinado.
whenTextStartsWith(text)ConditionalFormatRuleBuilderConfigura la regla de formato condicional que se activa cuando la entrada comienza con el valor determinado.
withCriteria(criteria, args)ConditionalFormatRuleBuilderConfigura la regla de formato condicional en los criterios definidos por los valores BooleanCriteria, que por lo general se toman de criteria y arguments de una regla existente.

Documentación detallada

build()

Construye una regla de formato condicional a partir de la configuración aplicada al compilador.

Devolvedor

ConditionalFormatRule: Es una representación de la regla de formato condicional.


copy()

Muestra un ajuste predeterminado del creador de reglas con la configuración de esta regla.

Devolvedor

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


getBooleanCondition()

Recupera la información BooleanCondition de la regla si esta usa criterios de condición booleano. De lo contrario, muestra null.

// Log the boolean criteria type of the first conditional format rules of a sheet.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var booleanCondition = rule.getBooleanCondition();
if (booleanCondition != null) {
  Logger.log(booleanCondition.getCriteriaType());
}

Devolvedor

BooleanCondition: Es el objeto de condición booleana, o bien null si la regla no usa una condición booleana.


getGradientCondition()

Recupera la información de GradientCondition de la regla, si esta usa criterios de condición de gradiente. De lo contrario, muestra null.

// Log the gradient minimum color of the first conditional format rule of a sheet.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var gradientCondition = rule.getGradientCondition();
if (gradientCondition != null) {
  // Assume the color has ColorType.RGB.
  Logger.log(gradientCondition.getMinColorObject().asRgbColor().asHexString());
}

Devolvedor

GradientCondition: Es el objeto de condición de gradiente o null si la regla no usa una condición de gradiente.


getRanges()

Recupera los rangos a los que se aplica esta regla de formato condicional.

// Log each range of the first conditional format rule of a sheet.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var ranges = rule.getRanges();
for (var i = 0; i < ranges.length; i++) {
  Logger.log(ranges[i].getA1Notation());
}

Devolvedor

Range[]: Son los rangos a los que se aplica esta regla de formato condicional.


setBackground(color)

Establece el color de fondo para el formato de la regla de formato condicional. Pasar null quita la configuración de formato de color de fondo de la regla.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color to red if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
colorStringEl color deseado o null para borrar.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


setBackgroundObject(color)

Establece el color de fondo para el formato de la regla de formato condicional. Pasar null quita la configuración de formato de color de fondo de la regla.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color to theme background color if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBackground(color)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
colorColorEl objeto de color deseado o null para borrar.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


setBold(bold)

Establece la negrita del texto para el formato de la regla de formato condicional. Si bold es true, la regla muestra el texto en negrita si se cumple la condición; si es false, la regla quita cualquier elemento existente en negrita si se cumple la condición. Pasar null quita la configuración de formato en negrita de la regla.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn their
// text bold if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBold(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
boldBooleanIndica si el texto debe estar en negrita o no si se cumple la condición de formato. null quita esta configuración.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


setFontColor(color)

Establece el color de fuente para el formato de la regla de formato condicional. Pasar null quita la configuración de formato de color de la fuente de la regla.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their font
// color to red if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setFontColor("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
colorStringEl color deseado o null para borrar.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


setFontColorObject(color)

Establece el color de fuente para el formato de la regla de formato condicional. Pasar null quita la configuración de formato de color de la fuente de la regla.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their font
// color to theme text color if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setFontColor(color)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
colorColorEl objeto de color deseado o null para borrar.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


setGradientMaxpoint(color)

Borra el valor de punto máximo de gradiente de la regla de formato condicional y, en su lugar, usa el valor máximo de los rangos de la regla. También establece el color de punto máximo del gradiente en el color de entrada.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between white and red, based on their values in comparison to
// the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint("#FF0000")
    .setGradientMinpoint("#FFFFFF")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
colorStringEl color de punto máximo que se establecerá.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


setGradientMaxpointObject(color)

Borra el valor de punto máximo de gradiente de la regla de formato condicional y, en su lugar, usa el valor máximo de los rangos de la regla. También establece el color de punto máximo del gradiente en el color de entrada.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between theme text and background colors, based on their values
// in comparison to the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var textColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();
var backgroundColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint(textColor)
    .setGradientMinpoint(backgroundColor)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
colorColorEl objeto de color de punto máximo que se establecerá.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


setGradientMaxpointObjectWithValue(color, type, value)

Establece los campos de punto máximo de gradiente de la regla de formato condicional.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from theme accent 1, accent 2 to accent 3 colors, based on their
// values in comparison to the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var color2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var color3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
colorColorEl color de punto máximo que se establecerá.
typeInterpolationTypeEl tipo de interpolación de punto máximo que se establecerá.
valueStringEl valor de punto máximo que se establecerá.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


setGradientMaxpointWithValue(color, type, value)

Establece los campos de punto máximo de gradiente de la regla de formato condicional.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from red green to blue, based on their values in comparison to
// the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
colorStringEl color de punto máximo que se establecerá.
typeInterpolationTypeEl tipo de interpolación de punto máximo que se establecerá.
valueStringEl valor de punto máximo que se establecerá.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


setGradientMidpointObjectWithValue(color, type, value)

Configura los campos de punto medio de gradiente de la regla de formato condicional. Borra todos los campos de punto medio si el tipo de interpolación que se pasa es null.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from theme accent 1 to accent 2 to accent 3 colors, based on
// their values in comparison to the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var color2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var color3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
colorColorColor de punto medio que se establecerá.
typeInterpolationTypeEs el tipo de interpolación de punto medio que se establecerá o null para borrar.
valueStringEs el valor de punto medio que se establecerá.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


setGradientMidpointWithValue(color, type, value)

Configura los campos de punto medio de gradiente de la regla de formato condicional. Borra todos los campos de punto medio si el tipo de interpolación que se pasa es null.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from red green to blue, based on their values in comparison to
// the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
colorStringColor de punto medio que se establecerá.
typeInterpolationTypeEs el tipo de interpolación de punto medio que se establecerá o null para borrar.
valueStringEs el valor de punto medio que se establecerá.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


setGradientMinpoint(color)

Borra el valor de punto mínimo del gradiente de la regla de formato condicional y, en su lugar, usa el valor mínimo en los rangos de la regla. También establece el color de punto mínimo del gradiente en el color de entrada.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between white and red, based on their values in comparison to
// the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint("#FF0000")
    .setGradientMinpoint("#FFFFFF")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
colorStringColor de punto mínimo que se establecerá.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


setGradientMinpointObject(color)

Borra el valor de punto mínimo del gradiente de la regla de formato condicional y, en su lugar, usa el valor mínimo en los rangos de la regla. También establece el color de punto mínimo del gradiente en el color de entrada.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between theme text and background colors, based on their values
// in comparison to the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var textColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();
var backgroundColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint(textColor)
    .setGradientMinpoint(backgroundColor)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
colorColorEl objeto de color de punto mínimo que se establecerá.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


setGradientMinpointObjectWithValue(color, type, value)

Configura los campos de punto mínimo de gradiente de la regla de formato condicional.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from theme accent 1 to accent 2 to accent 3 colors, based on
// their values in comparison to the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var color2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var color3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
colorColorColor de punto mínimo que se establecerá.
typeInterpolationTypeEs el tipo de interpolación de punto mínimo que se establecerá.
valueStringEl valor de punto mínimo que se establecerá.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


setGradientMinpointWithValue(color, type, value)

Configura los campos de punto mínimo de gradiente de la regla de formato condicional.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from red to green to blue, based on their values in comparison to
// the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
colorStringColor de punto mínimo que se establecerá.
typeInterpolationTypeEs el tipo de interpolación de punto mínimo que se establecerá.
valueStringEl valor de punto mínimo que se establecerá.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


setItalic(italic)

Establece la cursiva de texto para el formato de la regla de formato condicional. Si italic es true, la regla muestra el texto en cursiva si se cumple la condición. Si es false, la regla quita cualquier cursiva existente si se cumple la condición. Pasar null quita la configuración de formato cursiva de la regla.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn their
// text italic if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setItalic(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
italicBooleanIndica si el texto debe aparecer en cursiva o no si se cumple la condición de formato. null quita esta configuración.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


setRanges(ranges)

Establece uno o más rangos a los que se aplica esta regla de formato condicional. Esta operación reemplaza cualquier rango existente. Cuando se configura un array vacío, se borran los rangos existentes. Una regla debe tener al menos un rango.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 and range D4:F6
// to turn red if they contain a number between 1 and 10.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeOne = sheet.getRange("A1:B3");
var rangeTwo = sheet.getRange("D4:F6");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([rangeOne, rangeTwo])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
rangesRange[]Los rangos a los que se aplica esta regla de formato condicional.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


setStrikethrough(strikethrough)

Establece tachado en el texto para el formato de la regla de formato condicional. Si strikethrough es true, la regla tacha el texto si se cumple la condición; si es false, la regla quita cualquier formato tachado existente si se cumple la condición. Pasar null quita la configuración de formato tachado de la regla.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to strikethrough
// their text if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setStrikethrough(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
strikethroughBooleanIndica si el texto debe tacharse o no si se cumple la condición de formato. null quita esta configuración.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


setUnderline(underline)

Establece el subrayado de texto para el formato de la regla de formato condicional. Si underline es true, la regla subraya el texto si se cumple la condición; si es false, la regla quita cualquier subrayado existente si se cumple la condición. Pasar null quita la configuración de formato de subrayado de la regla.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to underline
// their text if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setUnderline(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
underlineBooleanIndica si el texto debe subrayarse o no si se cumple la condición de formato. null quita esta configuración.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


whenCellEmpty()

Configura la regla de formato condicional que se activará cuando la celda esté vacía.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they are empty.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenCellEmpty()
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


whenCellNotEmpty()

Configura la regla de formato condicional que se activará cuando la celda no esté vacía.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they are not empty.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenCellNotEmpty()
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


whenDateAfter(date)

Configura la regla de formato condicional para que se active cuando una fecha sea posterior al valor determinado.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date after 11/4/1993.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateAfter(new Date("11/4/1993"))
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
dateDateLa fecha más reciente.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


whenDateAfter(date)

Configura la regla de formato condicional para que se active cuando una fecha sea posterior a la fecha relativa determinada.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date after today.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
dateRelativeDateLa fecha más reciente relacionada con el tipo de fecha seleccionado.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


whenDateBefore(date)

Configura la regla de formato condicional para que se active cuando una fecha sea anterior a la fecha especificada.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date before 11/4/1993.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateBefore(new Date("11/4/1993"))
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
dateDateLa fecha más temprana inaceptable.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


whenDateBefore(date)

Configura la regla de formato condicional para que se active cuando una fecha sea anterior a la fecha relativa determinada.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date before today.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
dateRelativeDateLa fecha más reciente relacionada con el tipo de fecha seleccionado.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


whenDateEqualTo(date)

Configura la regla de formato condicional para que se active cuando una fecha sea igual a la fecha determinada.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain the date 11/4/1993.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateEqualTo(new Date("11/4/1993"))
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
dateDateLa única fecha aceptable.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


whenDateEqualTo(date)

Configura la regla de formato condicional para que se active cuando una fecha sea igual a la fecha relativa determinada.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain todays date.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateEqualTo(SpreadsheetApp.RelativeDate.TODAY)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
dateRelativeDateLa fecha más reciente relacionada con el tipo de fecha seleccionado.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


whenFormulaSatisfied(formula)

Configura la regla de formato condicional que se activará cuando la fórmula dada se evalúe como true.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they satisfy the condition "=EQ(B4, C3)".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenFormulaSatisfied("=EQ(B4, C3)")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
formulaStringUna fórmula personalizada que se evalúa como true si la entrada es válida.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


whenNumberBetween(start, end)

Configura la regla de formato condicional para que se active cuando un número se encuentre entre dos valores especificados o sea cualquiera de ellos.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number between 1 and 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
startNumberEl valor aceptable más bajo.
endNumberEs el valor aceptable más alto.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


whenNumberEqualTo(number)

Configura la regla de formato condicional que se activará cuando un número sea igual al valor determinado.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain the number 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
numberNumberEs el único valor aceptable.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


whenNumberGreaterThan(number)

Configura la regla de formato condicional que se activa cuando un número es mayor que el valor especificado.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red
// if they contain a number greater than 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberGreaterThan(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
numberNumberEs el valor inaceptable más alto.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


whenNumberGreaterThanOrEqualTo(number)

Configura la regla de formato condicional que se activa cuando un número es mayor o igual que el valor determinado.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number greater than or equal to 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberGreaterThanOrEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
numberNumberEl valor aceptable más bajo.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


whenNumberLessThan(number)

Configura la regla de formato condicional para que se active cuando un número sea inferior al valor determinado.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number less than 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberLessThan(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
numberNumberEl valor inaceptable más bajo.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


whenNumberLessThanOrEqualTo(number)

Configura la regla de formato condicional que se activa cuando un número es menor o igual que el valor determinado.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number less than or equal to 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberLessThanOrEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
numberNumberEs el valor aceptable más alto.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


whenNumberNotBetween(start, end)

Configura la regla de formato condicional para que se active cuando un número no se encuentre en el medio o no sea ninguno de los dos valores especificados.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number not between 1 and 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberNotBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
startNumberEl valor inaceptable más bajo.
endNumberEs el valor inaceptable más alto.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


whenNumberNotEqualTo(number)

Configura la regla de formato condicional para que se active cuando un número no sea igual al valor especificado.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they don't contain the number 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberNotEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
numberNumberEl único valor inaceptable.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


whenTextContains(text)

Configura la regla de formato condicional para que se active cuando la entrada contenga el valor determinado.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextContains("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
textStringValor que debe contener la entrada.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


whenTextDoesNotContain(text)

Configura la regla de formato condicional para que se active cuando la entrada no contenga el valor determinado.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they don't contain the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextDoesNotContain("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
textStringValor que no debe contener la entrada.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


whenTextEndsWith(text)

Configura la regla de formato condicional que se activa cuando la entrada finaliza con el valor determinado.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they end with the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEndsWith("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
textStringTexto que se compara con el final de la cadena.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


whenTextEqualTo(text)

Configura la regla de formato condicional que se activará cuando la entrada sea igual al valor determinado.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they have text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
textStringEs el único valor aceptable.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


whenTextStartsWith(text)

Configura la regla de formato condicional que se activa cuando la entrada comienza con el valor determinado.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they start with the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextStartsWith("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
textStringTexto que se compara con el principio de la cadena.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.


withCriteria(criteria, args)

Configura la regla de formato condicional en los criterios definidos por los valores BooleanCriteria, que por lo general se toman de criteria y arguments de una regla existente.

// Adds a new conditional format rule that is a copy of the first active
// conditional format rule, except it instead sets its cells to have a black
// background color.

var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
var booleanCondition = rules[0].getBooleanCondition();
if (booleanCondition != null) {
  var rule = SpreadsheetApp.newConditionalFormatRule()
      .withCriteria(booleanCondition.getCriteriaType(),
         booleanCondition.getCriteriaValues())
      .setBackground("#000000")
      .setRanges(rule.getRanges())
      .build();
  rules.push(rule);
}
sheet.setConditionalFormatRules(rules);

Parámetros

NombreTipoDescripción
criteriaBooleanCriteriaEs el tipo de criterios de formato condicional.
argsObject[]Un array de argumentos apropiado para el tipo de criterio; la cantidad de argumentos y su tipo coinciden con el método when...() correspondiente anterior.

Devolvedor

ConditionalFormatRuleBuilder: Es el compilador para el encadenamiento.