Class ConditionalFormatRuleBuilder

Tool zur BedingungserstellungfürFormatierungsregeln

Tool zum Erstellen von Regeln für die bedingte Formatierung.

// 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.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
build()	ConditionalFormatRule	Erstellt eine Regel für die bedingte Formatierung aus den auf den Builder angewendeten Einstellungen.
copy()	ConditionalFormatRuleBuilder	Gibt eine voreingestellte Regel-Builder-Konfiguration mit den Einstellungen dieser Regel zurück.
getBooleanCondition()	BooleanCondition	Ruft die BooleanCondition-Informationen der Regel ab, wenn für diese Regel boolesche Bedingungskriterien verwendet werden.
getGradientCondition()	GradientCondition	Ruft die GradientCondition-Informationen der Regel ab, wenn für diese Regel Gradientenbedingungen verwendet werden.
getRanges()	Range[]	Ruft die Bereiche ab, auf die diese Regel für die bedingte Formatierung angewendet wird.
setBackground(color)	ConditionalFormatRuleBuilder	Legt die Hintergrundfarbe für das Format der Regel für die bedingte Formatierung fest.
setBackgroundObject(color)	ConditionalFormatRuleBuilder	Legt die Hintergrundfarbe für das Format der Regel für die bedingte Formatierung fest.
setBold(bold)	ConditionalFormatRuleBuilder	Legt fest, ob der Text im Format der Regel für die bedingte Formatierung fett dargestellt werden soll.
setFontColor(color)	ConditionalFormatRuleBuilder	Legt die Schriftfarbe für das Format der Regel für die bedingte Formatierung fest.
setFontColorObject(color)	ConditionalFormatRuleBuilder	Legt die Schriftfarbe für das Format der Regel für die bedingte Formatierung fest.
setGradientMaxpoint(color)	ConditionalFormatRuleBuilder	Löscht den maximalen Wert des Gradienten der Regel für die bedingte Formatierung und verwendet stattdessen den Höchstwert in den Bereichen der Regel.
setGradientMaxpointObject(color)	ConditionalFormatRuleBuilder	Löscht den maximalen Wert des Gradienten der Regel für die bedingte Formatierung und verwendet stattdessen den Höchstwert in den Bereichen der Regel.
setGradientMaxpointObjectWithValue(color, type, value)	ConditionalFormatRuleBuilder	Legt die Felder für den maximalen Wert des Gradienten der Regel für die bedingte Formatierung fest.
setGradientMaxpointWithValue(color, type, value)	ConditionalFormatRuleBuilder	Legt die Felder für den maximalen Wert des Gradienten der Regel für die bedingte Formatierung fest.
setGradientMidpointObjectWithValue(color, type, value)	ConditionalFormatRuleBuilder	Legt die Felder für den Mittelpunkt des Verlaufs der Regel für die bedingte Formatierung fest.
setGradientMidpointWithValue(color, type, value)	ConditionalFormatRuleBuilder	Legt die Felder für den Mittelpunkt des Verlaufs der Regel für die bedingte Formatierung fest.
setGradientMinpoint(color)	ConditionalFormatRuleBuilder	Löscht den Mindestwert für den Gradienten der Regel für die bedingte Formatierung und verwendet stattdessen den Mindestwert in den Bereichen der Regel.
setGradientMinpointObject(color)	ConditionalFormatRuleBuilder	Löscht den Mindestwert für den Gradienten der Regel für die bedingte Formatierung und verwendet stattdessen den Mindestwert in den Bereichen der Regel.
setGradientMinpointObjectWithValue(color, type, value)	ConditionalFormatRuleBuilder	Legt die Felder für den minimalen Gradientenpunkt der Regel für die bedingte Formatierung fest.
setGradientMinpointWithValue(color, type, value)	ConditionalFormatRuleBuilder	Legt die Felder für den minimalen Gradientenpunkt der Regel für die bedingte Formatierung fest.
setItalic(italic)	ConditionalFormatRuleBuilder	Legt fest, dass der Text im Format der Regel für die bedingte Formatierung kursiv dargestellt wird.
setRanges(ranges)	ConditionalFormatRuleBuilder	Legt einen oder mehrere Bereiche fest, auf die diese Regel für die bedingte Formatierung angewendet wird.
setStrikethrough(strikethrough)	ConditionalFormatRuleBuilder	Legt fest, dass der Text im Format der Regel für die bedingte Formatierung durchgestrichen wird.
setUnderline(underline)	ConditionalFormatRuleBuilder	Legt die Unterstreichung des Texts für das Format der Regel für die bedingte Formatierung fest.
whenCellEmpty()	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn die Zelle leer ist.
whenCellNotEmpty()	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn die Zelle nicht leer ist.
whenDateAfter(date)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum nach dem angegebenen Wert liegt.
whenDateAfter(date)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum nach dem angegebenen relativen Datum liegt.
whenDateBefore(date)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum vor dem angegebenen Datum liegt.
whenDateBefore(date)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum vor dem angegebenen relativen Datum liegt.
whenDateEqualTo(date)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum dem angegebenen Datum entspricht.
whenDateEqualTo(date)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum dem angegebenen relativen Datum entspricht.
whenFormulaSatisfied(formula)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn die angegebene Formel true ergibt.
whenNumberBetween(start, end)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl zwischen zwei angegebenen Werten liegt oder einen der beiden Werte hat.
whenNumberEqualTo(number)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl gleich dem angegebenen Wert ist.
whenNumberGreaterThan(number)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl größer als der angegebene Wert ist.
whenNumberGreaterThanOrEqualTo(number)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl größer oder gleich dem angegebenen Wert ist.
whenNumberLessThan(number)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl kleiner als der angegebene Wert ist.
whenNumberLessThanOrEqualTo(number)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl kleiner oder gleich dem angegebenen Wert ist.
whenNumberNotBetween(start, end)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl nicht zwischen zwei angegebenen Werten liegt und auch nicht einem der beiden Werte entspricht.
whenNumberNotEqualTo(number)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl nicht dem angegebenen Wert entspricht.
whenTextContains(text)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn die Eingabe den angegebenen Wert enthält.
whenTextDoesNotContain(text)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn die Eingabe den angegebenen Wert nicht enthält.
whenTextEndsWith(text)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn die Eingabe mit dem angegebenen Wert endet.
whenTextEqualTo(text)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn die Eingabe dem angegebenen Wert entspricht.
whenTextStartsWith(text)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn die Eingabe mit dem angegebenen Wert beginnt.
withCriteria(criteria, args)	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format auf Kriterien fest, die durch BooleanCriteria-Werte definiert werden, die in der Regel aus criteria und arguments einer vorhandenen Regel stammen.

Detaillierte Dokumentation

build()

Erstellt eine Regel für die bedingte Formatierung aus den auf den Builder angewendeten Einstellungen.

Rückflug

ConditionalFormatRule: Eine Darstellung der Regel für die bedingte Formatierung.

---

copy()

Gibt eine voreingestellte Regel-Builder-Konfiguration mit den Einstellungen dieser Regel zurück.

Rückflug

ConditionalFormatRuleBuilder: Ein Builder, der auf den Einstellungen dieser Regel basiert.

---

getBooleanCondition()

Ruft die BooleanCondition-Informationen der Regel ab, wenn für diese Regel boolesche Bedingungskriterien verwendet werden. Andernfalls wird null zurückgegeben.

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

Rückflug

BooleanCondition: Das boolesche Bedingungsobjekt oder null, wenn die Regel keine boolesche Bedingung verwendet.

---

getGradientCondition()

Ruft die GradientCondition-Informationen der Regel ab, wenn für diese Regel Gradientenbedingungen verwendet werden. Andernfalls wird null zurückgegeben.

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

Rückflug

GradientCondition: Das Gradientenbedingungsobjekt oder null, wenn für die Regel keine Gradientenbedingung verwendet wird.

---

getRanges()

Ruft die Bereiche ab, auf die diese Regel für die bedingte Formatierung angewendet wird.

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

Rückflug

Range[]: Die Bereiche, auf die diese Regel für die bedingte Formatierung angewendet wird.

---

setBackground(color)

Legt die Hintergrundfarbe für das Format der Regel für die bedingte Formatierung fest. Wenn Sie null übergeben, wird die Formatierungseinstellung für die Hintergrundfarbe aus der Regel entfernt.

// 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".

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

Parameter

Name	Typ	Beschreibung
color	String	Die gewünschte Farbe oder null zum Löschen.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

setBackgroundObject(color)

Legt die Hintergrundfarbe für das Format der Regel für die bedingte Formatierung fest. Wenn Sie null übergeben, wird die Formatierungseinstellung für die Hintergrundfarbe aus der Regel entfernt.

// 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".

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

Parameter

Name	Typ	Beschreibung
color	Color	Das gewünschte Farbobjekt oder null zum Löschen.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

setBold(bold)

Legt fest, ob der Text im Format der Regel für die bedingte Formatierung fett dargestellt werden soll. Wenn bold true ist, wird der Text in der Regel fett formatiert, wenn die Bedingung erfüllt ist. Wenn false, wird die vorhandene Fettformatierung entfernt, wenn die Bedingung erfüllt ist. Wenn Sie null übergeben, wird die Einstellung für die Fettdarstellung aus der Regel entfernt.

// 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".

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

Parameter

Name	Typ	Beschreibung
bold	Boolean	Gibt an, ob der Text fett formatiert werden soll, wenn die Formatierungsbedingung erfüllt ist. Mit null wird diese Einstellung entfernt.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

setFontColor(color)

Legt die Schriftfarbe für das Format der Regel für die bedingte Formatierung fest. Wenn Sie null übergeben, wird die Formatierungseinstellung für die Schriftfarbe aus der Regel entfernt.

// 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".

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

Parameter

Name	Typ	Beschreibung
color	String	Die gewünschte Farbe oder null zum Löschen.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

setFontColorObject(color)

Legt die Schriftfarbe für das Format der Regel für die bedingte Formatierung fest. Wenn Sie null übergeben, wird die Formatierungseinstellung für die Schriftfarbe aus der Regel entfernt.

// 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".

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

Parameter

Name	Typ	Beschreibung
color	Color	Das gewünschte Farbobjekt oder null zum Löschen.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

setGradientMaxpoint(color)

Löscht den maximalen Wert des Gradienten der Regel für die bedingte Formatierung und verwendet stattdessen den Höchstwert in den Bereichen der Regel. Legt auch die Farbe des Maximalwerts des Verlaufs auf die Eingabefarbe fest.

// 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.

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

Parameter

Name	Typ	Beschreibung
color	String	Die Farbe für den Maximalwert.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

setGradientMaxpointObject(color)

Löscht den maximalen Wert des Gradienten der Regel für die bedingte Formatierung und verwendet stattdessen den Höchstwert in den Bereichen der Regel. Legt auch die Farbe des Maximalwerts des Verlaufs auf die Eingabefarbe fest.

// 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.

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

Parameter

Name	Typ	Beschreibung
color	Color	Das Objekt für die Farbe des Maximalwerts, das festgelegt werden soll.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

setGradientMaxpointObjectWithValue(color, type, value)

Legt die Felder für den maximalen Wert des Gradienten der Regel für die bedingte Formatierung fest.

// 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.

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

Parameter

Name	Typ	Beschreibung
color	Color	Die Farbe für den Maximalwert.
type	InterpolationType	Der festzulegende Maxpoint-Interpolationstyp.
value	String	Der festzulegende Maxpoint-Wert.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

setGradientMaxpointWithValue(color, type, value)

Legt die Felder für den maximalen Wert des Gradienten der Regel für die bedingte Formatierung fest.

// 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.

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

Parameter

Name	Typ	Beschreibung
color	String	Die Farbe für den Maximalwert.
type	InterpolationType	Der festzulegende Maxpoint-Interpolationstyp.
value	String	Der festzulegende Maxpoint-Wert.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

setGradientMidpointObjectWithValue(color, type, value)

Legt die Felder für den Mittelpunkt des Verlaufs der Regel für die bedingte Formatierung fest. Löscht alle Felder für den Mittelpunkt, wenn der übergebene Interpolationstyp null ist.

// 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.

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

Parameter

Name	Typ	Beschreibung
color	Color	Die Farbe für den Mittelwert, die festgelegt werden soll.
type	InterpolationType	Der Typ der Mittelpunktinterpolation, der festgelegt werden soll, oder null, um die Einstellung zu löschen.
value	String	Der festzulegende Mittelwert.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

setGradientMidpointWithValue(color, type, value)

Legt die Felder für den Mittelpunkt des Verlaufs der Regel für die bedingte Formatierung fest. Löscht alle Felder für den Mittelpunkt, wenn der übergebene Interpolationstyp null ist.

// 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.

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

Parameter

Name	Typ	Beschreibung
color	String	Die Farbe für den Mittelwert, die festgelegt werden soll.
type	InterpolationType	Der Typ der Mittelpunktinterpolation, der festgelegt werden soll, oder null, um die Einstellung zu löschen.
value	String	Der festzulegende Mittelwert.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

setGradientMinpoint(color)

Löscht den Mindestwert für den Gradienten der Regel für die bedingte Formatierung und verwendet stattdessen den Mindestwert in den Bereichen der Regel. Legt auch die Farbe des minimalen Punkts des Verlaufs auf die Eingabefarbe fest.

// 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.

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

Parameter

Name	Typ	Beschreibung
color	String	Die Farbe für den Minimalwert, die festgelegt werden soll.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

setGradientMinpointObject(color)

Löscht den Mindestwert für den Gradienten der Regel für die bedingte Formatierung und verwendet stattdessen den Mindestwert in den Bereichen der Regel. Legt auch die Farbe des minimalen Punkts des Verlaufs auf die Eingabefarbe fest.

// 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.

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

Parameter

Name	Typ	Beschreibung
color	Color	Das festzulegende Farbobjekt für den Minimalwert.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

setGradientMinpointObjectWithValue(color, type, value)

Legt die Felder für den minimalen Gradientenpunkt der Regel für die bedingte Formatierung fest.

// 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.

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

Parameter

Name	Typ	Beschreibung
color	Color	Die Farbe für den Minimalwert, die festgelegt werden soll.
type	InterpolationType	Der festzulegende Interpolationstyp für den Mindestpunkt.
value	String	Der festzulegende Mindestpunktwert.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

setGradientMinpointWithValue(color, type, value)

Legt die Felder für den minimalen Gradientenpunkt der Regel für die bedingte Formatierung fest.

// 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.

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

Parameter

Name	Typ	Beschreibung
color	String	Die Farbe für den Minimalwert, die festgelegt werden soll.
type	InterpolationType	Der festzulegende Interpolationstyp für den Mindestpunkt.
value	String	Der festzulegende Mindestpunktwert.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

setItalic(italic)

Legt fest, dass der Text im Format der Regel für die bedingte Formatierung kursiv dargestellt wird. Wenn italic true ist, wird der Text in der Regel kursiv formatiert, wenn die Bedingung erfüllt ist. Wenn false, wird die vorhandene Kursivformatierung entfernt, wenn die Bedingung erfüllt ist. Wenn Sie null übergeben, wird die Formatierungseinstellung für Kursivschrift aus der Regel entfernt.

// 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".

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

Parameter

Name	Typ	Beschreibung
italic	Boolean	Gibt an, ob der Text kursiv formatiert werden soll, wenn die Formatierungsbedingung erfüllt ist. Mit null wird diese Einstellung entfernt.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

setRanges(ranges)

Legt einen oder mehrere Bereiche fest, auf die diese Regel für die bedingte Formatierung angewendet wird. Bei diesem Vorgang werden alle vorhandenen Bereiche ersetzt. Wenn Sie ein leeres Array festlegen, werden alle vorhandenen Bereiche gelöscht. Eine Regel muss mindestens einen Bereich enthalten.

// 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.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeOne = sheet.getRange('A1:B3');
const rangeTwo = sheet.getRange('D4:F6');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([rangeOne, rangeTwo])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
ranges	Range[]	Die Bereiche, auf die diese Regel für die bedingte Formatierung angewendet wird.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

setStrikethrough(strikethrough)

Legt fest, dass der Text im Format der Regel für die bedingte Formatierung durchgestrichen wird. Wenn strikethrough gleich true ist, wird der Text in der Regel durchgestrichen, wenn die Bedingung erfüllt ist. Wenn strikethrough gleich false ist, wird die vorhandene Durchstreichung entfernt, wenn die Bedingung erfüllt ist. Wenn Sie null übergeben, wird die Formatierungseinstellung „Durchgestrichen“ aus der Regel entfernt.

// 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".

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

Parameter

Name	Typ	Beschreibung
strikethrough	Boolean	Gibt an, ob der Text durchgestrichen werden soll, wenn die Formatierungsbedingung erfüllt ist. Mit null wird diese Einstellung entfernt.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

setUnderline(underline)

Legt die Unterstreichung des Texts für das Format der Regel für die bedingte Formatierung fest. Wenn underline true ist, wird Text in der Regel unterstrichen, wenn die Bedingung erfüllt ist. Wenn false, werden vorhandene Unterstreichungen entfernt, wenn die Bedingung erfüllt ist. Wenn Sie null übergeben, wird die Unterstreichungsformatierung aus der Regel entfernt.

// 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".

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

Parameter

Name	Typ	Beschreibung
underline	Boolean	Gibt an, ob der Text unterstrichen werden soll, wenn die Formatierungsbedingung erfüllt ist. Mit null wird diese Einstellung entfernt.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

whenCellEmpty()

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn die Zelle leer ist.

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

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

whenCellNotEmpty()

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn die Zelle nicht leer ist.

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

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

whenDateAfter(date)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum nach dem angegebenen Wert liegt.

// 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.

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

Parameter

Name	Typ	Beschreibung
date	Date	Das letzte Datum.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

whenDateAfter(date)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum nach dem angegebenen relativen Datum liegt.

// 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.

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

Parameter

Name	Typ	Beschreibung
date	RelativeDate	Das letzte Datum relativ zum ausgewählten Datumstyp.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

whenDateBefore(date)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum vor dem angegebenen Datum liegt.

// 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.

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

Parameter

Name	Typ	Beschreibung
date	Date	Das früheste unzulässige Datum.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

whenDateBefore(date)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum vor dem angegebenen relativen Datum liegt.

// 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.

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

Parameter

Name	Typ	Beschreibung
date	RelativeDate	Das letzte Datum relativ zum ausgewählten Datumstyp.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

whenDateEqualTo(date)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum dem angegebenen Datum entspricht.

// 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.

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

Parameter

Name	Typ	Beschreibung
date	Date	Das einzig akzeptable Datum.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

whenDateEqualTo(date)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum dem angegebenen relativen Datum entspricht.

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

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

Parameter

Name	Typ	Beschreibung
date	RelativeDate	Das letzte Datum relativ zum ausgewählten Datumstyp.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

whenFormulaSatisfied(formula)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn die angegebene Formel true ergibt.

// 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)".

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

Parameter

Name	Typ	Beschreibung
formula	String	Eine benutzerdefinierte Formel, die mit true ausgewertet wird, wenn die Eingabe gültig ist.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

whenNumberBetween(start, end)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl zwischen zwei angegebenen Werten liegt oder einen der beiden Werte hat.

// 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.

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

Parameter

Name	Typ	Beschreibung
start	Number	Der niedrigste akzeptable Wert.
end	Number	Der höchste akzeptable Wert.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

whenNumberEqualTo(number)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl gleich dem angegebenen Wert ist.

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

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

Parameter

Name	Typ	Beschreibung
number	Number	Der einzige zulässige Wert.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

whenNumberGreaterThan(number)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl größer als der angegebene Wert ist.

// 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.

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

Parameter

Name	Typ	Beschreibung
number	Number	Der höchste unzulässige Wert.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

whenNumberGreaterThanOrEqualTo(number)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl größer oder gleich dem angegebenen Wert ist.

// 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.

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

Parameter

Name	Typ	Beschreibung
number	Number	Der niedrigste akzeptable Wert.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

whenNumberLessThan(number)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl kleiner als der angegebene Wert ist.

// 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.

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

Parameter

Name	Typ	Beschreibung
number	Number	Der niedrigste inakzeptable Wert.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

whenNumberLessThanOrEqualTo(number)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl kleiner oder gleich dem angegebenen Wert ist.

// 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.

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

Parameter

Name	Typ	Beschreibung
number	Number	Der höchste akzeptable Wert.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

whenNumberNotBetween(start, end)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl nicht zwischen zwei angegebenen Werten liegt und auch nicht einem der beiden Werte entspricht.

// 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.

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

Parameter

Name	Typ	Beschreibung
start	Number	Der niedrigste inakzeptable Wert.
end	Number	Der höchste unzulässige Wert.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

whenNumberNotEqualTo(number)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl nicht dem angegebenen Wert entspricht.

// 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.

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

Parameter

Name	Typ	Beschreibung
number	Number	Der einzige unzulässige Wert.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

whenTextContains(text)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn die Eingabe den angegebenen Wert enthält.

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

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

Parameter

Name	Typ	Beschreibung
text	String	Der Wert, den die Eingabe enthalten muss.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

whenTextDoesNotContain(text)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn die Eingabe den angegebenen Wert nicht enthält.

// 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".

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

Parameter

Name	Typ	Beschreibung
text	String	Der Wert, den die Eingabe nicht enthalten darf.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

whenTextEndsWith(text)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn die Eingabe mit dem angegebenen Wert endet.

// 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".

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

Parameter

Name	Typ	Beschreibung
text	String	Text, der mit dem Ende des Strings verglichen werden soll.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

whenTextEqualTo(text)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn die Eingabe dem angegebenen Wert entspricht.

// 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".

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

Parameter

Name	Typ	Beschreibung
text	String	Der einzige zulässige Wert.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

whenTextStartsWith(text)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn die Eingabe mit dem angegebenen Wert beginnt.

// 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".

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

Parameter

Name	Typ	Beschreibung
text	String	Text, der mit dem Anfang des Strings verglichen werden soll.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

---

withCriteria(criteria, args)

Legt die Regel für das bedingte Format auf Kriterien fest, die durch BooleanCriteria-Werte definiert werden, die in der Regel aus criteria und arguments einer vorhandenen Regel stammen.

// 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.

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

Parameter

Name	Typ	Beschreibung
criteria	BooleanCriteria	Der Typ der Kriterien für die bedingte Formatierung.
args	Object[]	Ein Array von Argumenten, die dem Kriterientyp entsprechen. Die Anzahl der Argumente und ihr Typ stimmen mit der entsprechenden when...()-Methode oben überein.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.