Class ConditionalFormatRuleBuilder

Условный форматправилостроитель

Построитель правил условного форматирования.

// 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);

Методы

Метод	Тип возврата	Краткое описание
build()	ConditionalFormatRule	Создает правило условного форматирования на основе настроек, примененных к построителю.
copy()	ConditionalFormatRuleBuilder	Возвращает набор настроек построителя правил с настройками этого правила.
getBooleanCondition()	BooleanCondition	Извлекает информацию BooleanCondition правила, если это правило использует логические критерии условия.
getGradientCondition()	GradientCondition	Извлекает информацию GradientCondition правила, если это правило использует критерии условия градиента.
getRanges()	Range[]	Извлекает диапазоны, к которым применяется это правило условного форматирования.
setBackground(color)	ConditionalFormatRuleBuilder	Задает цвет фона для формата правила условного форматирования.
setBackgroundObject(color)	ConditionalFormatRuleBuilder	Задает цвет фона для формата правила условного форматирования.
setBold(bold)	ConditionalFormatRuleBuilder	Устанавливает жирность текста для формата правила условного форматирования.
setFontColor(color)	ConditionalFormatRuleBuilder	Задает цвет шрифта для формата правила условного форматирования.
setFontColorObject(color)	ConditionalFormatRuleBuilder	Задает цвет шрифта для формата правила условного форматирования.
setGradientMaxpoint(color)	ConditionalFormatRuleBuilder	Очищает значение максимальной точки градиента правила условного формата и вместо этого использует максимальное значение в диапазонах правила.
setGradientMaxpointObject(color)	ConditionalFormatRuleBuilder	Очищает значение максимальной точки градиента правила условного формата и вместо этого использует максимальное значение в диапазонах правила.
setGradientMaxpointObjectWithValue(color, type, value)	ConditionalFormatRuleBuilder	Устанавливает поля максимальной точки градиента правила условного формата.
setGradientMaxpointWithValue(color, type, value)	ConditionalFormatRuleBuilder	Устанавливает поля максимальной точки градиента правила условного формата.
setGradientMidpointObjectWithValue(color, type, value)	ConditionalFormatRuleBuilder	Устанавливает поля средней точки градиента правила условного формата.
setGradientMidpointWithValue(color, type, value)	ConditionalFormatRuleBuilder	Устанавливает поля средней точки градиента правила условного формата.
setGradientMinpoint(color)	ConditionalFormatRuleBuilder	Очищает значение минимальной точки градиента правила условного формата и вместо этого использует минимальное значение в диапазонах правила.
setGradientMinpointObject(color)	ConditionalFormatRuleBuilder	Очищает значение минимальной точки градиента правила условного формата и вместо этого использует минимальное значение в диапазонах правила.
setGradientMinpointObjectWithValue(color, type, value)	ConditionalFormatRuleBuilder	Устанавливает поля minpoint градиента правила условного формата.
setGradientMinpointWithValue(color, type, value)	ConditionalFormatRuleBuilder	Устанавливает поля minpoint градиента правила условного формата.
setItalic(italic)	ConditionalFormatRuleBuilder	Устанавливает курсив для формата правила условного форматирования.
setRanges(ranges)	ConditionalFormatRuleBuilder	Устанавливает один или несколько диапазонов, к которым применяется это правило условного форматирования.
setStrikethrough(strikethrough)	ConditionalFormatRuleBuilder	Устанавливает зачеркивание текста для формата правила условного форматирования.
setUnderline(underline)	ConditionalFormatRuleBuilder	Устанавливает подчеркивание текста для формата правила условного форматирования.
whenCellEmpty()	ConditionalFormatRuleBuilder	Устанавливает правило условного форматирования, которое срабатывает, когда ячейка пуста.
whenCellNotEmpty()	ConditionalFormatRuleBuilder	Устанавливает правило условного форматирования, которое срабатывает, когда ячейка не пуста.
whenDateAfter(date)	ConditionalFormatRuleBuilder	Устанавливает правило условного формата, которое срабатывает, когда дата находится после заданного значения.
whenDateAfter(date)	ConditionalFormatRuleBuilder	Устанавливает правило условного формата, которое срабатывает, когда дата наступает после заданной относительной даты.
whenDateBefore(date)	ConditionalFormatRuleBuilder	Устанавливает правило условного формата, которое срабатывает, когда дата предшествует заданной дате.
whenDateBefore(date)	ConditionalFormatRuleBuilder	Устанавливает правило условного формата, которое срабатывает, когда дата предшествует заданной относительной дате.
whenDateEqualTo(date)	ConditionalFormatRuleBuilder	Устанавливает правило условного формата, которое срабатывает, когда дата равна заданной дате.
whenDateEqualTo(date)	ConditionalFormatRuleBuilder	Устанавливает правило условного формата, которое срабатывает, когда дата равна заданной относительной дате.
whenFormulaSatisfied(formula)	ConditionalFormatRuleBuilder	Устанавливает правило условного форматирования, которое срабатывает, когда данная формула имеет значение true .
whenNumberBetween(start, end)	ConditionalFormatRuleBuilder	Устанавливает правило условного формата, которое срабатывает, когда число попадает между двумя указанными значениями или является одним из них.
whenNumberEqualTo(number)	ConditionalFormatRuleBuilder	Устанавливает правило условного формата, которое срабатывает, когда число равно заданному значению.
whenNumberGreaterThan(number)	ConditionalFormatRuleBuilder	Устанавливает правило условного форматирования, которое срабатывает, когда число превышает заданное значение.
whenNumberGreaterThanOrEqualTo(number)	ConditionalFormatRuleBuilder	Устанавливает правило условного формата, которое срабатывает, когда число больше или равно заданному значению.
whenNumberLessThan(number)	ConditionalFormatRuleBuilder	Устанавливает правило условного условного формата, которое срабатывает, когда число меньше заданного значения.
whenNumberLessThanOrEqualTo(number)	ConditionalFormatRuleBuilder	Устанавливает правило условного формата, которое срабатывает, когда число меньше или равно заданному значению.
whenNumberNotBetween(start, end)	ConditionalFormatRuleBuilder	Устанавливает правило условного форматирования, которое срабатывает, когда число не попадает ни в одно из двух указанных значений и не находится ни в одном из них.
whenNumberNotEqualTo(number)	ConditionalFormatRuleBuilder	Устанавливает правило условного формата, которое срабатывает, когда число не равно заданному значению.
whenTextContains(text)	ConditionalFormatRuleBuilder	Устанавливает правило условного форматирования, которое срабатывает, когда входные данные содержат заданное значение.
whenTextDoesNotContain(text)	ConditionalFormatRuleBuilder	Устанавливает правило условного форматирования, которое срабатывает, когда входные данные не содержат заданное значение.
whenTextEndsWith(text)	ConditionalFormatRuleBuilder	Устанавливает правило условного формата, которое сработает, когда ввод заканчивается заданным значением.
whenTextEqualTo(text)	ConditionalFormatRuleBuilder	Устанавливает правило условного формата, которое сработает, когда входное значение равно заданному значению.
whenTextStartsWith(text)	ConditionalFormatRuleBuilder	Устанавливает правило условного форматирования, которое срабатывает, когда ввод начинается с заданного значения.
withCriteria(criteria, args)	ConditionalFormatRuleBuilder	Устанавливает правило условного формата в соответствии с критериями, определяемыми значениями BooleanCriteria , которые обычно берутся из criteria и arguments существующего правила.

Подробная документация

build()

Создает правило условного форматирования на основе настроек, примененных к построителю.

Возвращаться

ConditionalFormatRule — представление правила условного форматирования.

---

copy()

Возвращает набор настроек построителя правил с настройками этого правила.

Возвращаться

ConditionalFormatRuleBuilder — конструктор на основе настроек этого правила.

---

getBooleanCondition()

Извлекает информацию BooleanCondition правила, если это правило использует логические критерии условия. В противном случае возвращает 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());
}

Возвращаться

BooleanCondition — объект логического условия или null если правило не использует логическое условие.

---

getGradientCondition()

Извлекает информацию GradientCondition правила, если это правило использует критерии условия градиента. В противном случае возвращает 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());
}

Возвращаться

GradientCondition — Объект условия градиента или null , если правило не использует условие градиента.

---

getRanges()

Извлекает диапазоны, к которым применяется это правило условного форматирования.

// 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());
}

Возвращаться

Range[] — диапазоны, к которым применяется это правило условного форматирования.

---

setBackground(color)

Задает цвет фона для формата правила условного форматирования. Передача значения null удаляет настройку формата цвета фона из правила.

// 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);

Параметры

Имя	Тип	Описание
color	String	Желаемый цвет или null которое необходимо очистить.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

setBackgroundObject(color)

Задает цвет фона для формата правила условного форматирования. Передача значения null удаляет настройку формата цвета фона из правила.

// 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);

Параметры

Имя	Тип	Описание
color	Color	Желаемый цвет объекта или null для очистки.

Возвращаться

ConditionalFormatRuleBuilder — Построитель для цепочки.

---

setBold(bold)

Устанавливает жирность текста для формата правила условного форматирования. Если bold имеет значение true , правило выделяет текст полужирным шрифтом, если условие выполнено; если false , правило удаляет все существующие жирные шрифты, если условие выполнено. При передаче значения null из правила удаляется параметр формата, выделенный жирным шрифтом.

// 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);

Параметры

Имя	Тип	Описание
bold	Boolean	Должен ли текст быть выделен жирным шрифтом, если условие формата соблюдено; null удаляет этот параметр.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

setFontColor(color)

Задает цвет шрифта для формата правила условного форматирования. Передача значения null удаляет настройку формата цвета шрифта из правила.

// 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);

Параметры

Имя	Тип	Описание
color	String	Желаемый цвет или null которое необходимо очистить.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

setFontColorObject(color)

Задает цвет шрифта для формата правила условного форматирования. Передача значения null удаляет настройку формата цвета шрифта из правила.

// 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);

Параметры

Имя	Тип	Описание
color	Color	Желаемый цвет объекта или null для очистки.

Возвращаться

ConditionalFormatRuleBuilder — Построитель для цепочки.

---

setGradientMaxpoint(color)

Очищает значение максимальной точки градиента правила условного формата и вместо этого использует максимальное значение в диапазонах правила. Также устанавливает цвет maxpoint градиента в качестве входного цвета.

// 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);

Параметры

Имя	Тип	Описание
color	String	Цвет maxpoint, который нужно установить.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

setGradientMaxpointObject(color)

Очищает значение максимальной точки градиента правила условного формата и вместо этого использует максимальное значение в диапазонах правила. Также устанавливает цвет maxpoint градиента в качестве входного цвета.

// 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);

Параметры

Имя	Тип	Описание
color	Color	Объект цвета maxpoint, который необходимо установить.

Возвращаться

ConditionalFormatRuleBuilder — Построитель для цепочки.

---

setGradientMaxpointObjectWithValue(color, type, value)

Устанавливает поля максимальной точки градиента правила условного формата.

// 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);

Параметры

Имя	Тип	Описание
color	Color	Цвет maxpoint, который нужно установить.
type	InterpolationType	Устанавливаемый тип интерполяции maxpoint.
value	String	Значение maxpoint, которое необходимо установить.

Возвращаться

ConditionalFormatRuleBuilder — Построитель для цепочки.

---

setGradientMaxpointWithValue(color, type, value)

Устанавливает поля максимальной точки градиента правила условного формата.

// 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);

Параметры

Имя	Тип	Описание
color	String	Цвет maxpoint, который нужно установить.
type	InterpolationType	Устанавливаемый тип интерполяции maxpoint.
value	String	Значение maxpoint, которое необходимо установить.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

setGradientMidpointObjectWithValue(color, type, value)

Устанавливает поля средней точки градиента правила условного формата. Очищает все поля средней точки, если переданный тип интерполяции равен 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);

Параметры

Имя	Тип	Описание
color	Color	Цвет средней точки, который нужно установить.
type	InterpolationType	Тип интерполяции средней точки, который необходимо установить, или null , чтобы очистить.
value	String	Среднее значение, которое нужно установить.

Возвращаться

ConditionalFormatRuleBuilder — Построитель для цепочки.

---

setGradientMidpointWithValue(color, type, value)

Устанавливает поля средней точки градиента правила условного формата. Очищает все поля средней точки, если переданный тип интерполяции равен 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);

Параметры

Имя	Тип	Описание
color	String	Цвет средней точки, который нужно установить.
type	InterpolationType	Тип интерполяции средней точки, который необходимо установить, или null , чтобы очистить.
value	String	Среднее значение, которое нужно установить.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

setGradientMinpoint(color)

Очищает значение минимальной точки градиента правила условного формата и вместо этого использует минимальное значение в диапазонах правила. Также устанавливает цвет minpoint градиента в качестве входного цвета.

// 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);

Параметры

Имя	Тип	Описание
color	String	Цвет minpoint, который нужно установить.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

setGradientMinpointObject(color)

Очищает значение минимальной точки градиента правила условного формата и вместо этого использует минимальное значение в диапазонах правила. Также устанавливает цвет minpoint градиента в качестве входного цвета.

// 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);

Параметры

Имя	Тип	Описание
color	Color	Объект цвета minpoint, который необходимо установить.

Возвращаться

ConditionalFormatRuleBuilder — Построитель для цепочки.

---

setGradientMinpointObjectWithValue(color, type, value)

Устанавливает поля minpoint градиента правила условного формата.

// 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);

Параметры

Имя	Тип	Описание
color	Color	Цвет minpoint, который нужно установить.
type	InterpolationType	Устанавливаемый тип интерполяции minpoint.
value	String	Значение minpoint, которое необходимо установить.

Возвращаться

ConditionalFormatRuleBuilder — Построитель для цепочки.

---

setGradientMinpointWithValue(color, type, value)

Устанавливает поля minpoint градиента правила условного формата.

// 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);

Параметры

Имя	Тип	Описание
color	String	Цвет minpoint, который нужно установить.
type	InterpolationType	Устанавливаемый тип интерполяции minpoint.
value	String	Значение minpoint, которое необходимо установить.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

setItalic(italic)

Устанавливает курсив для формата правила условного форматирования. Если italic имеет значение true , правило выделяет текст курсивом, если условие выполнено; если false , правило удаляет любой существующий курсив, если условие выполнено. Передача значения null удаляет из правила настройку формата курсива.

// 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);

Параметры

Имя	Тип	Описание
italic	Boolean	Следует ли выделять текст курсивом, если условие формата соблюдено; null удаляет этот параметр.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

setRanges(ranges)

Устанавливает один или несколько диапазонов, к которым применяется это правило условного форматирования. Эта операция заменяет любые существующие диапазоны. Установка пустого массива очищает все существующие диапазоны. Правило должно иметь хотя бы один диапазон.

// 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);

Параметры

Имя	Тип	Описание
ranges	Range[]	Диапазоны, к которым применяется это правило условного форматирования.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

setStrikethrough(strikethrough)

Устанавливает зачеркивание текста для формата правила условного форматирования. Если strikethrough имеет значение true , правило зачеркивает текст, если условие выполнено; если false , правило удаляет любое существующее форматирование зачеркивания, если условие выполнено. Передача значения null удаляет из правила настройку формата зачеркивания.

// 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);

Параметры

Имя	Тип	Описание
strikethrough	Boolean	Должен ли текст быть зачеркнут, если условие формата соблюдено; null удаляет этот параметр.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

setUnderline(underline)

Устанавливает подчеркивание текста для формата правила условного форматирования. Если underline имеет значение true , правило подчеркивает текст, если условие выполнено; если false , правило удаляет все существующие подчеркивания, если условие выполнено. При передаче значения null из правила удаляется параметр формата подчеркивания.

// 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);

Параметры

Имя	Тип	Описание
underline	Boolean	Следует ли подчеркивать текст, если условие формата соблюдено; null удаляет этот параметр.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

whenCellEmpty()

Устанавливает правило условного форматирования, которое срабатывает, когда ячейка пуста.

// 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);

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

whenCellNotEmpty()

Устанавливает правило условного форматирования, которое срабатывает, когда ячейка не пуста.

// 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);

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

whenDateAfter(date)

Устанавливает правило условного формата, которое срабатывает, когда дата находится после заданного значения.

// 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);

Параметры

Имя	Тип	Описание
date	Date	Самая последняя дата.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

whenDateAfter(date)

Устанавливает правило условного формата, которое срабатывает, когда дата наступает после заданной относительной даты.

// 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);

Параметры

Имя	Тип	Описание
date	RelativeDate	Самая поздняя дата относительно выбранного типа даты.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

whenDateBefore(date)

Устанавливает правило условного формата, которое срабатывает, когда дата предшествует заданной дате.

// 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);

Параметры

Имя	Тип	Описание
date	Date	Самая ранняя неприемлемая дата.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

whenDateBefore(date)

Устанавливает правило условного формата, которое срабатывает, когда дата предшествует заданной относительной дате.

// 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);

Параметры

Имя	Тип	Описание
date	RelativeDate	Самая поздняя дата относительно выбранного типа даты.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

whenDateEqualTo(date)

Устанавливает правило условного формата, которое срабатывает, когда дата равна заданной дате.

// 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);

Параметры

Имя	Тип	Описание
date	Date	Единственная приемлемая дата.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

whenDateEqualTo(date)

Устанавливает правило условного формата, которое срабатывает, когда дата равна заданной относительной дате.

// 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);

Параметры

Имя	Тип	Описание
date	RelativeDate	Самая поздняя дата относительно выбранного типа даты.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

whenFormulaSatisfied(formula)

Устанавливает правило условного формата, которое срабатывает, когда данная формула принимает значение 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);

Параметры

Имя	Тип	Описание
formula	String	Пользовательская формула, которая возвращает true если введенные данные действительны.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

whenNumberBetween(start, end)

Устанавливает правило условного форматирования, которое срабатывает, когда число попадает между двумя указанными значениями или является одним из них.

// 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);

Параметры

Имя	Тип	Описание
start	Number	Самое низкое приемлемое значение.
end	Number	Максимально допустимое значение.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

whenNumberEqualTo(number)

Устанавливает правило условного формата, которое срабатывает, когда число равно заданному значению.

// 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);

Параметры

Имя	Тип	Описание
number	Number	Единственное приемлемое значение.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

whenNumberGreaterThan(number)

Устанавливает правило условного форматирования, которое срабатывает, когда число превышает заданное значение.

// 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);

Параметры

Имя	Тип	Описание
number	Number	Высшее недопустимое значение.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

whenNumberGreaterThanOrEqualTo(number)

Устанавливает правило условного формата, которое срабатывает, когда число больше или равно заданному значению.

// 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);

Параметры

Имя	Тип	Описание
number	Number	Самое низкое приемлемое значение.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

whenNumberLessThan(number)

Устанавливает правило условного условного формата, которое срабатывает, когда число меньше заданного значения.

// 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);

Параметры

Имя	Тип	Описание
number	Number	Наименьшее неприемлемое значение.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

whenNumberLessThanOrEqualTo(number)

Устанавливает правило условного формата, которое срабатывает, когда число меньше или равно заданному значению.

// 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);

Параметры

Имя	Тип	Описание
number	Number	Максимально допустимое значение.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

whenNumberNotBetween(start, end)

Устанавливает правило условного форматирования, которое срабатывает, когда число не попадает ни в одно из двух указанных значений и не находится ни в одном из них.

// 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);

Параметры

Имя	Тип	Описание
start	Number	Наименьшее неприемлемое значение.
end	Number	Высшее недопустимое значение.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

whenNumberNotEqualTo(number)

Устанавливает правило условного формата, которое срабатывает, когда число не равно заданному значению.

// 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);

Параметры

Имя	Тип	Описание
number	Number	Единственная неприемлемая ценность.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

whenTextContains(text)

Устанавливает правило условного форматирования, которое срабатывает, когда входные данные содержат заданное значение.

// 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);

Параметры

Имя	Тип	Описание
text	String	Значение, которое должно содержать входные данные.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

whenTextDoesNotContain(text)

Устанавливает правило условного форматирования, которое срабатывает, когда входные данные не содержат заданное значение.

// 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);

Параметры

Имя	Тип	Описание
text	String	Значение, которое входные данные не должны содержать.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

whenTextEndsWith(text)

Устанавливает правило условного формата, которое сработает, когда ввод заканчивается заданным значением.

// 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);

Параметры

Имя	Тип	Описание
text	String	Текст для сравнения с концом строки.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

whenTextEqualTo(text)

Устанавливает правило условного формата, которое сработает, когда входное значение равно заданному значению.

// 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);

Параметры

Имя	Тип	Описание
text	String	Единственное приемлемое значение.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

whenTextStartsWith(text)

Устанавливает правило условного форматирования, которое срабатывает, когда ввод начинается с заданного значения.

// 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);

Параметры

Имя	Тип	Описание
text	String	Текст для сравнения с началом строки.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки

---

withCriteria(criteria, args)

Устанавливает правило условного формата в соответствии с критериями, определяемыми значениями BooleanCriteria , которые обычно берутся из criteria и arguments существующего правила.

// 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);

Параметры

Имя	Тип	Описание
criteria	BooleanCriteria	Тип критериев условного формата.
args	Object[]	Массив аргументов, соответствующих типу критерия; количество аргументов и их тип соответствуют соответствующему методу when...() выше.

Возвращаться

ConditionalFormatRuleBuilder — построитель для цепочки