Halaman ini diterjemahkan oleh Cloud Translation API.

Class ConditionalFormatRuleBuilder

Builder untuk aturan format bersyarat.

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

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`build()`	`ConditionalFormatRule`	Membuat aturan format bersyarat dari setelan yang diterapkan ke builder.
`copy()`	`ConditionalFormatRuleBuilder`	Menampilkan preset pembuat aturan dengan setelan aturan ini.
`getBooleanCondition()`	`BooleanCondition`	Mengambil informasi `BooleanCondition` aturan jika aturan ini menggunakan kriteria kondisi boolean.
`getGradientCondition()`	`GradientCondition`	Mengambil informasi `GradientCondition` aturan, jika aturan ini menggunakan kriteria kondisi gradien.
`getRanges()`	`Range[]`	Mengambil rentang tempat aturan format bersyarat ini diterapkan.
`setBackground(color)`	`ConditionalFormatRuleBuilder`	Menetapkan warna latar belakang untuk format aturan format bersyarat.
`setBackgroundObject(color)`	`ConditionalFormatRuleBuilder`	Menetapkan warna latar belakang untuk format aturan format bersyarat.
`setBold(bold)`	`ConditionalFormatRuleBuilder`	Menetapkan huruf tebal teks untuk format aturan format bersyarat.
`setFontColor(color)`	`ConditionalFormatRuleBuilder`	Menetapkan warna font untuk format aturan format bersyarat.
`setFontColorObject(color)`	`ConditionalFormatRuleBuilder`	Menetapkan warna font untuk format aturan format bersyarat.
`setGradientMaxpoint(color)`	`ConditionalFormatRuleBuilder`	Menghapus nilai maxpoint gradien aturan format bersyarat, dan menggunakan nilai maksimum nilai dalam rentang aturan.
`setGradientMaxpointObject(color)`	`ConditionalFormatRuleBuilder`	Menghapus nilai maxpoint gradien aturan format bersyarat, dan menggunakan nilai maksimum nilai dalam rentang aturan.
`setGradientMaxpointObjectWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Menetapkan kolom maxpoint gradien aturan format bersyarat.
`setGradientMaxpointWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Menetapkan kolom maxpoint gradien aturan format bersyarat.
`setGradientMidpointObjectWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Menetapkan kolom titik tengah gradien aturan format bersyarat.
`setGradientMidpointWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Menetapkan kolom titik tengah gradien aturan format bersyarat.
`setGradientMinpoint(color)`	`ConditionalFormatRuleBuilder`	Menghapus nilai minpoint gradien aturan format bersyarat, dan menggunakan nilai minimum nilai dalam rentang aturan.
`setGradientMinpointObject(color)`	`ConditionalFormatRuleBuilder`	Menghapus nilai minpoint gradien aturan format bersyarat, dan menggunakan nilai minimum nilai dalam rentang aturan.
`setGradientMinpointObjectWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Menetapkan kolom minpoint gradien aturan format bersyarat.
`setGradientMinpointWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Menetapkan kolom minpoint gradien aturan format bersyarat.
`setItalic(italic)`	`ConditionalFormatRuleBuilder`	Menetapkan teks miring untuk format aturan format bersyarat.
`setRanges(ranges)`	`ConditionalFormatRuleBuilder`	Menetapkan satu atau beberapa rentang tempat aturan format bersyarat ini diterapkan.
`setStrikethrough(strikethrough)`	`ConditionalFormatRuleBuilder`	Menetapkan coretan teks untuk format aturan format bersyarat.
`setUnderline(underline)`	`ConditionalFormatRuleBuilder`	Menetapkan teks yang menggarisbawahi untuk format aturan format bersyarat.
`whenCellEmpty()`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat untuk dipicu saat sel kosong.
`whenCellNotEmpty()`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat untuk dipicu saat sel tidak kosong.
`whenDateAfter(date)`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat untuk dipicu jika tanggal jatuh setelah nilai yang diberikan.
`whenDateAfter(date)`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat untuk dipicu jika tanggal jatuh setelah tanggal relatif yang ditentukan.
`whenDateBefore(date)`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat untuk dipicu jika tanggal jatuh sebelum tanggal yang ditentukan.
`whenDateBefore(date)`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat untuk dipicu jika tanggal jatuh sebelum tanggal relatif yang ditentukan.
`whenDateEqualTo(date)`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat untuk dipicu saat tanggal sama dengan tanggal yang ditentukan.
`whenDateEqualTo(date)`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat untuk dipicu saat tanggal sama dengan tanggal relatif yang ditentukan.
`whenFormulaSatisfied(formula)`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat untuk dipicu saat formula yang diberikan bernilai `true`.
`whenNumberBetween(start, end)`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat untuk dipicu saat suatu angka berada di antara, atau salah satu dari, dua nilai-nilai yang telah ditentukan.
`whenNumberEqualTo(number)`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat untuk dipicu saat angka sama dengan nilai yang diberikan.
`whenNumberGreaterThan(number)`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat untuk dipicu saat angka lebih besar dari nilai yang diberikan.
`whenNumberGreaterThanOrEqualTo(number)`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat untuk dipicu saat angka lebih besar dari atau sama dengan yang diberikan dengan sejumlah nilai.
`whenNumberLessThan(number)`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat yang akan dipicu jika angkanya lebih kecil dari yang ditentukan dengan sejumlah nilai.
`whenNumberLessThanOrEqualTo(number)`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat untuk dipicu saat angka kurang dari atau sama dengan yang diberikan dengan sejumlah nilai.
`whenNumberNotBetween(start, end)`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat untuk dipicu saat suatu angka tidak berada di antara, dan tidak di antara keduanya dari dua nilai yang telah ditentukan.
`whenNumberNotEqualTo(number)`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat untuk dipicu saat angka tidak sama dengan nilai yang diberikan.
`whenTextContains(text)`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat untuk dipicu saat input berisi nilai yang diberikan.
`whenTextDoesNotContain(text)`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat untuk dipicu saat input tidak berisi string yang diberikan dengan sejumlah nilai.
`whenTextEndsWith(text)`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat untuk dipicu saat input diakhiri dengan nilai yang diberikan.
`whenTextEqualTo(text)`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat yang akan dipicu jika input sama dengan nilai yang diberikan.
`whenTextStartsWith(text)`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat untuk dipicu saat input dimulai dengan nilai yang diberikan.
`withCriteria(criteria, args)`	`ConditionalFormatRuleBuilder`	Menetapkan aturan format bersyarat ke kriteria yang ditentukan oleh nilai `BooleanCriteria`, biasanya diambil dari `criteria` dan `arguments` suatu item aturan yang ada.

Dokumentasi mendetail

`build()`

Membuat aturan format bersyarat dari setelan yang diterapkan ke builder.

Pulang pergi

ConditionalFormatRule — representasi aturan format bersyarat

`copy()`

Menampilkan preset pembuat aturan dengan setelan aturan ini.

Pulang pergi

ConditionalFormatRuleBuilder — builder berdasarkan setelan aturan ini

`getBooleanCondition()`

Mengambil informasi BooleanCondition aturan jika aturan ini menggunakan kriteria kondisi boolean. Jika tidak, menampilkan 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());
}

Pulang pergi

BooleanCondition — objek kondisi boolean, atau null jika aturan tidak menggunakan boolean .

`getGradientCondition()`

Mengambil informasi GradientCondition aturan, jika aturan ini menggunakan kriteria kondisi gradien. Jika tidak, menampilkan 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());
}

Pulang pergi

GradientCondition — Objek kondisi gradien, atau null jika aturan tidak menggunakan gradien .

`getRanges()`

Mengambil rentang tempat aturan format bersyarat ini diterapkan.

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

Pulang pergi

Range[] — rentang tempat aturan format bersyarat ini diterapkan.

`setBackground(color)`

Menetapkan warna latar belakang untuk format aturan format bersyarat. Lulus dalam null menghapus setelan format warna latar belakang dari aturan.

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

Parameter

Nama	Jenis	Deskripsi
`color`	`String`	Warna yang diinginkan atau `null` untuk dihapus.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`setBackgroundObject(color)`

Menetapkan warna latar belakang untuk format aturan format bersyarat. Lulus dalam null menghapus setelan format warna latar belakang dari aturan.

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

Parameter

Nama	Jenis	Deskripsi
`color`	`Color`	Objek warna yang diinginkan atau `null` yang akan dihapus.

Pulang pergi

ConditionalFormatRuleBuilder — Builder, untuk perantaian.

`setBold(bold)`

Menetapkan huruf tebal teks untuk format aturan format bersyarat. Jika bold adalah true, aturan akan mencetak tebal teks jika kondisi terpenuhi; jika false, aturan akan menghapus semua data yang ada dicetak tebal jika kondisi terpenuhi. Meneruskan null akan menghapus setelan format tebal dari aturan tersebut.

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

Parameter

Nama	Jenis	Deskripsi
`bold`	`Boolean`	Apakah teks harus dicetak tebal atau tidak jika kondisi format terpenuhi; `null` menghapus setelan ini.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`setFontColor(color)`

Menetapkan warna font untuk format aturan format bersyarat. Meneruskan null akan menghapus pengaturan format warna font dari aturan.

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

Parameter

Nama	Jenis	Deskripsi
`color`	`String`	Warna yang diinginkan atau `null` untuk dihapus.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`setFontColorObject(color)`

Menetapkan warna font untuk format aturan format bersyarat. Meneruskan null akan menghapus pengaturan format warna font dari aturan.

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

Parameter

Nama	Jenis	Deskripsi
`color`	`Color`	Objek warna yang diinginkan atau `null` yang akan dihapus.

Pulang pergi

ConditionalFormatRuleBuilder — Builder, untuk perantaian.

`setGradientMaxpoint(color)`

Menghapus nilai maxpoint gradien aturan format bersyarat, dan menggunakan nilai maksimum nilai dalam rentang aturan. Juga menyetel warna maxpoint gradien ke warna input.

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

Parameter

Nama	Jenis	Deskripsi
`color`	`String`	Warna maxpoint yang akan ditetapkan.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`setGradientMaxpointObject(color)`

Menghapus nilai maxpoint gradien aturan format bersyarat, dan menggunakan nilai maksimum nilai dalam rentang aturan. Juga menyetel warna maxpoint gradien ke warna input.

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

Parameter

Nama	Jenis	Deskripsi
`color`	`Color`	Objek warna maxpoint yang akan ditetapkan.

Pulang pergi

ConditionalFormatRuleBuilder — Builder, untuk perantaian.

`setGradientMaxpointObjectWithValue(color, type, value)`

Menetapkan kolom maxpoint gradien aturan format bersyarat.

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

Parameter

Nama	Jenis	Deskripsi
`color`	`Color`	Warna maxpoint yang akan ditetapkan.
`type`	`InterpolationType`	Jenis interpolasi maxpoint yang akan ditetapkan.
`value`	`String`	Nilai maxpoint yang akan ditetapkan.

Pulang pergi

ConditionalFormatRuleBuilder — Builder, untuk perantaian.

`setGradientMaxpointWithValue(color, type, value)`

Menetapkan kolom maxpoint gradien aturan format bersyarat.

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

Parameter

Nama	Jenis	Deskripsi
`color`	`String`	Warna maxpoint yang akan ditetapkan.
`type`	`InterpolationType`	Jenis interpolasi maxpoint yang akan ditetapkan.
`value`	`String`	Nilai maxpoint yang akan ditetapkan.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`setGradientMidpointObjectWithValue(color, type, value)`

Menetapkan kolom titik tengah gradien aturan format bersyarat. Mengosongkan semua kolom titik tengah jika jenis interpolasi yang diteruskan adalah 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);

Parameter

Nama	Jenis	Deskripsi
`color`	`Color`	Warna titik tengah yang akan ditetapkan.
`type`	`InterpolationType`	Jenis interpolasi titik tengah yang akan ditetapkan atau `null` untuk dihapus.
`value`	`String`	Nilai titik tengah yang akan ditetapkan.

Pulang pergi

ConditionalFormatRuleBuilder — Builder, untuk perantaian.

`setGradientMidpointWithValue(color, type, value)`

Menetapkan kolom titik tengah gradien aturan format bersyarat. Mengosongkan semua kolom titik tengah jika jenis interpolasi yang diteruskan adalah 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);

Parameter

Nama	Jenis	Deskripsi
`color`	`String`	Warna titik tengah yang akan ditetapkan.
`type`	`InterpolationType`	Jenis interpolasi titik tengah yang akan ditetapkan atau `null` untuk dihapus.
`value`	`String`	Nilai titik tengah yang akan ditetapkan.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`setGradientMinpoint(color)`

Menghapus nilai minpoint gradien aturan format bersyarat, dan menggunakan nilai minimum nilai dalam rentang aturan. Juga menyetel warna titik minimum gradien ke warna input.

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

Parameter

Nama	Jenis	Deskripsi
`color`	`String`	Warna titik minimum yang akan ditetapkan.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`setGradientMinpointObject(color)`

Menghapus nilai minpoint gradien aturan format bersyarat, dan menggunakan nilai minimum nilai dalam rentang aturan. Juga menyetel warna titik minimum gradien ke warna input.

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

Parameter

Nama	Jenis	Deskripsi
`color`	`Color`	Objek warna titik minimum yang akan ditetapkan.

Pulang pergi

ConditionalFormatRuleBuilder — Builder, untuk perantaian.

`setGradientMinpointObjectWithValue(color, type, value)`

Menetapkan kolom minpoint gradien aturan format bersyarat.

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

Parameter

Nama	Jenis	Deskripsi
`color`	`Color`	Warna titik minimum yang akan ditetapkan.
`type`	`InterpolationType`	Jenis interpolasi titik minimum yang akan ditetapkan.
`value`	`String`	Nilai minpoint yang akan ditetapkan.

Pulang pergi

ConditionalFormatRuleBuilder — Builder, untuk perantaian.

`setGradientMinpointWithValue(color, type, value)`

Menetapkan kolom minpoint gradien aturan format bersyarat.

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

Parameter

Nama	Jenis	Deskripsi
`color`	`String`	Warna titik minimum yang akan ditetapkan.
`type`	`InterpolationType`	Jenis interpolasi titik minimum yang akan ditetapkan.
`value`	`String`	Nilai minpoint yang akan ditetapkan.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`setItalic(italic)`

Menetapkan teks miring untuk format aturan format bersyarat. Jika italic adalah true, aturan akan mencetak miring teks jika kondisi terpenuhi; jika false, aturan akan menghapus cetak miring yang ada jika kondisi terpenuhi. Meneruskan null akan menghapus huruf miring pengaturan format dari aturan.

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

Parameter

Nama	Jenis	Deskripsi
`italic`	`Boolean`	Apakah teks harus dicetak miring atau tidak jika kondisi format terpenuhi; `null` menghapus setelan ini.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`setRanges(ranges)`

Menetapkan satu atau beberapa rentang tempat aturan format bersyarat ini diterapkan. Operasi ini menggantikan rentang yang ada. Menyetel array kosong akan menghapus semua rentang yang ada. Aturan harus memiliki setidaknya satu rentang.

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

Parameter

Nama	Jenis	Deskripsi
`ranges`	`Range[]`	Rentang tempat aturan format bersyarat ini diterapkan.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`setStrikethrough(strikethrough)`

Menetapkan coretan teks untuk format aturan format bersyarat. Jika strikethrough adalah true, teks aturan yang dicoret jika kondisi terpenuhi; jika false, aturannya akan menghapus format coretan yang ada jika kondisi terpenuhi. Lulus dalam null menghapus setelan format yang dicoret dari aturan.

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

Parameter

Nama	Jenis	Deskripsi
`strikethrough`	`Boolean`	Apakah teks harus dicoret atau tidak jika kondisi formatnya met; `null` menghapus setelan ini.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`setUnderline(underline)`

Menetapkan teks yang menggarisbawahi untuk format aturan format bersyarat. Jika underline adalah true, aturan akan menggarisbawahi teks jika kondisinya terpenuhi; jika false, aturan akan menghapus garis bawah yang ada jika kondisi terpenuhi. Meneruskan null akan menghapus garis bawah pengaturan format dari aturan.

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

Parameter

Nama	Jenis	Deskripsi
`underline`	`Boolean`	Apakah teks harus digarisbawahi jika kondisi format terpenuhi; `null` menghapus setelan ini.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`whenCellEmpty()`

Menetapkan aturan format bersyarat untuk dipicu saat sel kosong.

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

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`whenCellNotEmpty()`

Menetapkan aturan format bersyarat untuk dipicu saat sel tidak kosong.

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

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`whenDateAfter(date)`

Menetapkan aturan format bersyarat untuk dipicu jika tanggal jatuh setelah nilai yang diberikan.

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

Parameter

Nama	Jenis	Deskripsi
`date`	`Date`	Tanggal terbaru.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`whenDateAfter(date)`

Menetapkan aturan format bersyarat untuk dipicu jika tanggal jatuh setelah tanggal relatif yang ditentukan.

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

Parameter

Nama	Jenis	Deskripsi
`date`	`RelativeDate`	Tanggal terbaru relatif terhadap jenis tanggal yang dipilih.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`whenDateBefore(date)`

Menetapkan aturan format bersyarat untuk dipicu jika tanggal jatuh sebelum tanggal yang ditentukan.

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

Parameter

Nama	Jenis	Deskripsi
`date`	`Date`	Tanggal paling awal yang tidak dapat diterima.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`whenDateBefore(date)`

Menetapkan aturan format bersyarat untuk dipicu jika tanggal jatuh sebelum tanggal relatif yang ditentukan.

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

Parameter

Nama	Jenis	Deskripsi
`date`	`RelativeDate`	Tanggal terbaru relatif terhadap jenis tanggal yang dipilih.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`whenDateEqualTo(date)`

Menetapkan aturan format bersyarat untuk dipicu saat tanggal sama dengan tanggal yang ditentukan.

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

Parameter

Nama	Jenis	Deskripsi
`date`	`Date`	Satu-satunya tanggal yang dapat diterima.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`whenDateEqualTo(date)`

Menetapkan aturan format bersyarat untuk dipicu saat tanggal sama dengan tanggal relatif yang ditentukan.

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

Parameter

Nama	Jenis	Deskripsi
`date`	`RelativeDate`	Tanggal terbaru relatif terhadap jenis tanggal yang dipilih.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`whenFormulaSatisfied(formula)`

Menetapkan aturan format bersyarat untuk dipicu saat formula yang diberikan bernilai 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);

Parameter

Nama	Jenis	Deskripsi
`formula`	`String`	Formula kustom yang bernilai `true` jika input valid.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`whenNumberBetween(start, end)`

Menetapkan aturan format bersyarat untuk dipicu saat suatu angka berada di antara, atau salah satu dari, dua nilai-nilai yang telah ditentukan.

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

Parameter

Nama	Jenis	Deskripsi
`start`	`Number`	Nilai terendah yang dapat diterima.
`end`	`Number`	Nilai tertinggi yang dapat diterima.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`whenNumberEqualTo(number)`

Menetapkan aturan format bersyarat untuk dipicu saat angka sama dengan nilai yang diberikan.

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

Parameter

Nama	Jenis	Deskripsi
`number`	`Number`	Satu-satunya nilai yang dapat diterima.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`whenNumberGreaterThan(number)`

Menetapkan aturan format bersyarat untuk dipicu saat angka lebih besar dari nilai yang diberikan.

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

Parameter

Nama	Jenis	Deskripsi
`number`	`Number`	Nilai tertinggi yang tidak dapat diterima.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`whenNumberGreaterThanOrEqualTo(number)`

Menetapkan aturan format bersyarat untuk dipicu saat angka lebih besar dari atau sama dengan yang diberikan dengan sejumlah nilai.

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

Parameter

Nama	Jenis	Deskripsi
`number`	`Number`	Nilai terendah yang dapat diterima.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`whenNumberLessThan(number)`

Menetapkan aturan format bersyarat yang akan dipicu jika angkanya lebih kecil dari yang ditentukan dengan sejumlah nilai.

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

Parameter

Nama	Jenis	Deskripsi
`number`	`Number`	Nilai terendah yang tidak dapat diterima.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`whenNumberLessThanOrEqualTo(number)`

Menetapkan aturan format bersyarat untuk dipicu saat angka kurang dari atau sama dengan yang diberikan dengan sejumlah nilai.

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

Parameter

Nama	Jenis	Deskripsi
`number`	`Number`	Nilai tertinggi yang dapat diterima.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`whenNumberNotBetween(start, end)`

Menetapkan aturan format bersyarat untuk dipicu saat suatu angka tidak berada di antara, dan tidak di antara keduanya dari dua nilai yang telah ditentukan.

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

Parameter

Nama	Jenis	Deskripsi
`start`	`Number`	Nilai terendah yang tidak dapat diterima.
`end`	`Number`	Nilai tertinggi yang tidak dapat diterima.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`whenNumberNotEqualTo(number)`

Menetapkan aturan format bersyarat untuk dipicu saat angka tidak sama dengan nilai yang diberikan.

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

Parameter

Nama	Jenis	Deskripsi
`number`	`Number`	Satu-satunya nilai yang tidak dapat diterima.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`whenTextContains(text)`

Menetapkan aturan format bersyarat untuk dipicu saat input berisi nilai yang diberikan.

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

Parameter

Nama	Jenis	Deskripsi
`text`	`String`	Nilai yang harus dimuat input.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`whenTextDoesNotContain(text)`

Menetapkan aturan format bersyarat untuk dipicu saat input tidak berisi string yang diberikan dengan sejumlah nilai.

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

Parameter

Nama	Jenis	Deskripsi
`text`	`String`	Nilai yang tidak boleh dimuat input.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`whenTextEndsWith(text)`

Menetapkan aturan format bersyarat untuk dipicu saat input diakhiri dengan nilai yang diberikan.

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

Parameter

Nama	Jenis	Deskripsi
`text`	`String`	Teks yang akan dibandingkan dengan bagian akhir string.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`whenTextEqualTo(text)`

Menetapkan aturan format bersyarat yang akan dipicu jika input sama dengan nilai yang diberikan.

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

Parameter

Nama	Jenis	Deskripsi
`text`	`String`	Satu-satunya nilai yang dapat diterima.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`whenTextStartsWith(text)`

Menetapkan aturan format bersyarat untuk dipicu saat input dimulai dengan nilai yang diberikan.

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

Parameter

Nama	Jenis	Deskripsi
`text`	`String`	Teks yang akan dibandingkan dengan awal string.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian

`withCriteria(criteria, args)`

Menetapkan aturan format bersyarat ke kriteria yang ditentukan oleh nilai BooleanCriteria, biasanya diambil dari criteria dan arguments suatu item aturan yang ada.

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

Parameter

Nama	Jenis	Deskripsi
`criteria`	`BooleanCriteria`	Jenis kriteria format bersyarat.
`args`	`Object[]`	Array argumen yang sesuai dengan tipe kriteria; jumlah argumen dan jenisnya cocok dengan metode `when...()` yang sesuai di atas.

Pulang pergi

ConditionalFormatRuleBuilder — builder, untuk perantaian