Class ConditionalFormatRuleBuilder

ConditionalFormatRuleBuilder

ตัวสร้างกฎการจัดรูปแบบตามเงื่อนไข 

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a number between 1 and 10.
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);

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
build()ConditionalFormatRuleสร้างกฎการจัดรูปแบบตามเงื่อนไขจากการตั้งค่าที่ใช้กับเครื่องมือสร้าง
copy()ConditionalFormatRuleBuilderแสดงค่ากําหนดของกฎที่สร้างไว้ล่วงหน้า
getBooleanCondition()BooleanConditionดึงข้อมูล BooleanCondition ของกฎหากกฎนี้ใช้เกณฑ์เงื่อนไขบูลีน
getGradientCondition()GradientConditionดึงข้อมูล GradientCondition ของกฎ หากกฎนี้ใช้เกณฑ์เงื่อนไขแบบไล่ระดับ
getRanges()Range[]ดึงข้อมูลช่วงที่มีการใช้กฎรูปแบบตามเงื่อนไขนี้
setBackground(color)ConditionalFormatRuleBuilderกำหนดสีพื้นหลังสำหรับรูปแบบของกฎรูปแบบตามเงื่อนไข
setBackgroundObject(color)ConditionalFormatRuleBuilderกำหนดสีพื้นหลังสำหรับรูปแบบของกฎรูปแบบตามเงื่อนไข
setBold(bold)ConditionalFormatRuleBuilderตั้งค่าข้อความเป็นตัวหนาสำหรับรูปแบบของกฎการจัดรูปแบบตามเงื่อนไข
setFontColor(color)ConditionalFormatRuleBuilderกำหนดสีแบบอักษรให้กับรูปแบบของกฎรูปแบบตามเงื่อนไข
setFontColorObject(color)ConditionalFormatRuleBuilderกำหนดสีแบบอักษรให้กับรูปแบบของกฎรูปแบบตามเงื่อนไข
setGradientMaxpoint(color)ConditionalFormatRuleBuilderล้างค่าจุดสูงสุดของการไล่ระดับของกฎการจัดรูปแบบตามเงื่อนไข และใช้ค่าสูงสุดในช่วงที่กฎกำหนดแทน
setGradientMaxpointObject(color)ConditionalFormatRuleBuilderล้างค่าจุดสูงสุดของการไล่ระดับของกฎการจัดรูปแบบตามเงื่อนไข และใช้ค่าสูงสุดในช่วงที่กฎกำหนดแทน
setGradientMaxpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderตั้งค่าฟิลด์จุดสูงสุดของการไล่ระดับสีของกฎการจัดรูปแบบตามเงื่อนไข
setGradientMaxpointWithValue(color, type, value)ConditionalFormatRuleBuilderตั้งค่าฟิลด์จุดสูงสุดของการไล่ระดับสีของกฎการจัดรูปแบบตามเงื่อนไข
setGradientMidpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderตั้งค่าฟิลด์จุดกึ่งกลางของไล่ระดับของกฎการจัดรูปแบบตามเงื่อนไข
setGradientMidpointWithValue(color, type, value)ConditionalFormatRuleBuilderตั้งค่าฟิลด์จุดกึ่งกลางของไล่ระดับของกฎการจัดรูปแบบตามเงื่อนไข
setGradientMinpoint(color)ConditionalFormatRuleBuilderล้างค่าจุดเริ่มต้นของเส้นลาดของกฎการจัดรูปแบบตามเงื่อนไข และใช้ค่าต่ำสุดในช่วงของกฎแทน
setGradientMinpointObject(color)ConditionalFormatRuleBuilderล้างค่าจุดเริ่มต้นของเส้นลาดของกฎการจัดรูปแบบตามเงื่อนไข และใช้ค่าต่ำสุดในช่วงของกฎแทน
setGradientMinpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderตั้งค่าฟิลด์จุดเริ่มต้นของเส้นลาดของกฎการจัดรูปแบบตามเงื่อนไข
setGradientMinpointWithValue(color, type, value)ConditionalFormatRuleBuilderตั้งค่าฟิลด์จุดเริ่มต้นของเส้นลาดของกฎการจัดรูปแบบตามเงื่อนไข
setItalic(italic)ConditionalFormatRuleBuilderตั้งค่าข้อความเป็นตัวเอียงสำหรับรูปแบบของกฎการจัดรูปแบบตามเงื่อนไข
setRanges(ranges)ConditionalFormatRuleBuilderตั้งค่าช่วงอย่างน้อย 1 ช่วงที่จะใช้กฎการจัดรูปแบบที่มีเงื่อนไขนี้
setStrikethrough(strikethrough)ConditionalFormatRuleBuilderตั้งค่าขีดทับข้อความสำหรับรูปแบบของกฎการจัดรูปแบบตามเงื่อนไข
setUnderline(underline)ConditionalFormatRuleBuilderตั้งค่าการขีดเส้นใต้ข้อความสำหรับรูปแบบของกฎการจัดรูปแบบตามเงื่อนไข
whenCellEmpty()ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อเซลล์ว่าง
whenCellNotEmpty()ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อเซลล์ไม่ว่างเปล่า
whenDateAfter(date)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อวันที่อยู่หลังค่าที่ระบุ
whenDateAfter(date)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อวันที่อยู่หลังวันที่ที่เกี่ยวข้อง
whenDateBefore(date)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อวันที่อยู่ก่อนวันที่ที่ระบุ
whenDateBefore(date)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อวันที่อยู่ก่อนวันที่ที่เกี่ยวข้อง
whenDateEqualTo(date)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อวันที่เท่ากับวันที่ที่ระบุ
whenDateEqualTo(date)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อวันที่เท่ากับวันที่แบบสัมพัทธ์ที่ระบุ
whenFormulaSatisfied(formula)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อสูตรที่ระบุให้ค่าเป็น true
whenNumberBetween(start, end)ConditionalFormatRuleBuilderตั้งค่ากฎรูปแบบเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขอยู่ในช่วงหรือเป็นค่าใดค่าหนึ่งจาก 2 ค่าที่ระบุ
whenNumberEqualTo(number)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขเท่ากับค่าที่ระบุ
whenNumberGreaterThan(number)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขมากกว่าค่าที่ระบุ
whenNumberGreaterThanOrEqualTo(number)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขมากกว่าหรือเท่ากับค่าที่ระบุ
whenNumberLessThan(number)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขน้อยกว่าค่าที่ระบุ
whenNumberLessThanOrEqualTo(number)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขน้อยกว่าหรือเท่ากับค่าที่ระบุ
whenNumberNotBetween(start, end)ConditionalFormatRuleBuilderตั้งค่ากฎรูปแบบเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขไม่ได้อยู่ในช่วงระหว่างและไม่ใช่ค่าใดค่าหนึ่งจาก 2 ค่าที่ระบุ
whenNumberNotEqualTo(number)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขไม่เท่ากับค่าที่ระบุ
whenTextContains(text)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่ออินพุตมีค่าที่ระบุ
whenTextDoesNotContain(text)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่ออินพุตไม่มีค่าที่ระบุ
whenTextEndsWith(text)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่ออินพุตลงท้ายด้วยค่าที่ระบุ
whenTextEqualTo(text)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่ออินพุตเท่ากับค่าที่ระบุ
whenTextStartsWith(text)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่ออินพุตเริ่มต้นด้วยค่าที่ระบุ
withCriteria(criteria, args)ConditionalFormatRuleBuilderตั้งค่ากฎรูปแบบแบบมีเงื่อนไขเป็นเกณฑ์ที่กําหนดโดยค่า BooleanCriteria ซึ่งโดยปกติแล้วนํามาจาก criteria และ arguments ของกฎที่มีอยู่

เอกสารประกอบโดยละเอียด

build()

สร้างกฎการจัดรูปแบบตามเงื่อนไขจากการตั้งค่าที่ใช้กับเครื่องมือสร้าง

รีเทิร์น

ConditionalFormatRule — การนําเสนอกฎการจัดรูปแบบตามเงื่อนไข

copy()

แสดงค่ากําหนดของกฎที่สร้างไว้ล่วงหน้า

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างตามการตั้งค่าของกฎนี้

getBooleanCondition()

ดึงข้อมูล BooleanCondition ของกฎหากกฎนี้ใช้เกณฑ์เงื่อนไขบูลีน ไม่เช่นนั้นให้แสดงผล null 

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

รีเทิร์น

BooleanCondition — ออบเจ็กต์เงื่อนไขบูลีน หรือ null หากกฎไม่ได้ใช้เงื่อนไขบูลีน

getGradientCondition()

ดึงข้อมูล GradientCondition ของกฎ หากกฎนี้ใช้เกณฑ์เงื่อนไขแบบไล่ระดับ ไม่เช่นนั้นให้แสดงผล null 

// Log the gradient minimum color of the first conditional format rule of a
// sheet.
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());
}

รีเทิร์น

GradientCondition — ออบเจ็กต์เงื่อนไขไล่ระดับ หรือ null หากกฎไม่ได้ใช้เงื่อนไขไล่ระดับ

getRanges()

ดึงข้อมูลช่วงที่มีการใช้กฎรูปแบบตามเงื่อนไขนี้ 

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

รีเทิร์น

Range[] — ช่วงที่มีการใช้กฎการจัดรูปแบบตามเงื่อนไขนี้

setBackground(color)

กำหนดสีพื้นหลังสำหรับรูปแบบของกฎรูปแบบตามเงื่อนไข การส่ง null จะนำการตั้งค่ารูปแบบสีพื้นหลังออกจากกฎ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorStringสีที่ต้องการหรือ null เพื่อล้าง

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

setBackgroundObject(color)

กำหนดสีพื้นหลังสำหรับรูปแบบของกฎรูปแบบตามเงื่อนไข การส่ง null จะนำการตั้งค่ารูปแบบสีพื้นหลังออกจากกฎ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorColorวัตถุที่ต้องการเปลี่ยนสี หรือ null เพื่อล้าง

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสำหรับใช้ต่อเชื่อม

setBold(bold)

ตั้งค่าข้อความเป็นตัวหนาสำหรับรูปแบบของกฎการจัดรูปแบบตามเงื่อนไข หาก bold เป็น true กฎจะใส่ตัวหนาข้อความหากเป็นไปตามเงื่อนไข หากเป็น false กฎจะนำการใส่ตัวหนาที่มีอยู่ออกหากเป็นไปตามเงื่อนไข การส่ง null จะนําการตั้งค่ารูปแบบตัวหนาออกจากกฎ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
boldBooleanกำหนดว่าข้อความควรเป็นตัวหนาหรือไม่หากเป็นไปตามเงื่อนไขการจัดรูปแบบ null นำการตั้งค่านี้ออก

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

setFontColor(color)

กำหนดสีแบบอักษรให้กับรูปแบบของกฎรูปแบบตามเงื่อนไข การส่ง null จะนําการตั้งค่ารูปแบบสีแบบอักษรออกจากกฎ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorStringสีที่ต้องการหรือ null เพื่อล้าง

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

setFontColorObject(color)

กำหนดสีแบบอักษรให้กับรูปแบบของกฎรูปแบบตามเงื่อนไข การส่ง null จะนําการตั้งค่ารูปแบบสีแบบอักษรออกจากกฎ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorColorวัตถุที่ต้องการเปลี่ยนสี หรือ null เพื่อล้าง

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสำหรับใช้ต่อเชื่อม

setGradientMaxpoint(color)

ล้างค่าจุดสูงสุดของการไล่ระดับของกฎการจัดรูปแบบตามเงื่อนไข และใช้ค่าสูงสุดในช่วงที่กฎกำหนดแทน รวมถึงตั้งค่าสีจุดสูงสุดของการไล่ระดับเป็นสีอินพุต 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorStringสีของจุดสูงสุดที่จะตั้งค่า

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

setGradientMaxpointObject(color)

ล้างค่าจุดสูงสุดของการไล่ระดับของกฎการจัดรูปแบบตามเงื่อนไข และใช้ค่าสูงสุดในช่วงที่กฎกำหนดแทน รวมถึงตั้งค่าสีจุดสูงสุดของการไล่ระดับเป็นสีอินพุต 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorColorออบเจ็กต์สีจุดสูงสุดที่จะตั้งค่า

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสำหรับใช้ต่อเชื่อม

setGradientMaxpointObjectWithValue(color, type, value)

ตั้งค่าฟิลด์จุดสูงสุดของการไล่ระดับสีของกฎการจัดรูปแบบตามเงื่อนไข 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorColorสีของจุดสูงสุดที่จะตั้งค่า
typeInterpolationTypeประเภทการหาค่าเฉลี่ยด้วยจุดสูงสุดที่จะตั้งค่า
valueStringค่าสูงสุดที่จะตั้งค่า

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสำหรับใช้ต่อเชื่อม

setGradientMaxpointWithValue(color, type, value)

ตั้งค่าฟิลด์จุดสูงสุดของการไล่ระดับสีของกฎการจัดรูปแบบตามเงื่อนไข 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorStringสีของจุดสูงสุดที่จะตั้งค่า
typeInterpolationTypeประเภทการหาค่าเฉลี่ยด้วยจุดสูงสุดที่จะตั้งค่า
valueStringค่าสูงสุดที่จะตั้งค่า

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

setGradientMidpointObjectWithValue(color, type, value)

ตั้งค่าฟิลด์จุดกึ่งกลางของไล่ระดับของกฎการจัดรูปแบบตามเงื่อนไข ล้างช่องจุดกึ่งกลางทั้งหมดหากประเภทการอินเตอร์โพเลชันที่ส่งผ่านคือ null 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorColorสีของจุดกึ่งกลางที่จะตั้งค่า
typeInterpolationTypeประเภทการหาค่าเฉลี่ยระหว่างจุดเพื่อตั้งค่า หรือ null เพื่อล้าง
valueStringค่ากลางที่จะตั้งค่า

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสำหรับใช้ต่อเชื่อม

setGradientMidpointWithValue(color, type, value)

ตั้งค่าฟิลด์จุดกึ่งกลางของไล่ระดับของกฎการจัดรูปแบบตามเงื่อนไข ล้างช่องจุดกึ่งกลางทั้งหมดหากประเภทการอินเตอร์โพเลชันที่ส่งผ่านคือ null 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorStringสีของจุดกึ่งกลางที่จะตั้งค่า
typeInterpolationTypeประเภทการหาค่าเฉลี่ยระหว่างจุดเพื่อตั้งค่า หรือ null เพื่อล้าง
valueStringค่ากลางที่จะตั้งค่า

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

setGradientMinpoint(color)

ล้างค่าจุดเริ่มต้นของเส้นลาดของกฎการจัดรูปแบบตามเงื่อนไข และใช้ค่าต่ำสุดในช่วงของกฎแทน รวมถึงตั้งค่าสีจุดต่ำสุดของการไล่ระดับสีเป็นสีอินพุต 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorStringสีของจุดต่ำสุดที่จะตั้งค่า

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

setGradientMinpointObject(color)

ล้างค่าจุดเริ่มต้นของเส้นลาดของกฎการจัดรูปแบบตามเงื่อนไข และใช้ค่าต่ำสุดในช่วงของกฎแทน รวมถึงตั้งค่าสีจุดต่ำสุดของการไล่ระดับสีเป็นสีอินพุต 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorColorออบเจ็กต์สีจุดต่ำสุดที่จะตั้งค่า

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสำหรับใช้ต่อเชื่อม

setGradientMinpointObjectWithValue(color, type, value)

ตั้งค่าฟิลด์จุดเริ่มต้นของเส้นลาดของกฎการจัดรูปแบบตามเงื่อนไข 

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere from theme accent 1 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorColorสีของจุดต่ำสุดที่จะตั้งค่า
typeInterpolationTypeประเภทการหาค่าเฉลี่ยเชิงเส้นขั้นต่ำที่จะตั้งค่า
valueStringค่าต่ำสุดที่จะตั้งค่า

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสำหรับใช้ต่อเชื่อม

setGradientMinpointWithValue(color, type, value)

ตั้งค่าฟิลด์จุดเริ่มต้นของเส้นลาดของกฎการจัดรูปแบบตามเงื่อนไข 

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere from red 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorStringสีของจุดต่ำสุดที่จะตั้งค่า
typeInterpolationTypeประเภทการหาค่าเฉลี่ยเชิงเส้นขั้นต่ำที่จะตั้งค่า
valueStringค่าต่ำสุดที่จะตั้งค่า

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

setItalic(italic)

ตั้งค่าข้อความเป็นตัวเอียงสำหรับรูปแบบของกฎการจัดรูปแบบตามเงื่อนไข หาก italic เป็น true กฎจะใส่ตัวเอียงในข้อความหากเป็นไปตามเงื่อนไข หากเป็น false กฎจะนำตัวเอียงที่มีอยู่ออกหากเป็นไปตามเงื่อนไข การส่ง null จะนําการตั้งค่ารูปแบบตัวเอียงออกจากกฎ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
italicBooleanกำหนดว่าข้อความควรเอียงหรือไม่หากเป็นไปตามเงื่อนไขการจัดรูปแบบ null นำการตั้งค่านี้ออก

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

setRanges(ranges)

ตั้งค่าช่วงอย่างน้อย 1 ช่วงที่จะใช้กฎการจัดรูปแบบที่มีเงื่อนไขนี้ การดำเนินการนี้จะแทนที่ช่วงที่มีอยู่ การตั้งค่าอาร์เรย์ว่างจะล้างช่วงที่มีอยู่ กฎต้องมีช่วงอย่างน้อย 1 ช่วง 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
rangesRange[]ช่วงที่มีการใช้กฎการจัดรูปแบบตามเงื่อนไขนี้

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

setStrikethrough(strikethrough)

ตั้งค่าขีดทับข้อความสำหรับรูปแบบของกฎการจัดรูปแบบตามเงื่อนไข หาก strikethrough เป็น true กฎจะขีดทับข้อความหากเป็นไปตามเงื่อนไข หากเป็น false กฎจะนำการจัดรูปแบบขีดทับที่มีอยู่ออกหากเป็นไปตามเงื่อนไข การส่ง null จะนำการตั้งค่ารูปแบบขีดทับออกจากกฎ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
strikethroughBooleanกำหนดว่าข้อความควรขีดฆ่าหรือไม่หากเป็นไปตามเงื่อนไขการจัดรูปแบบ null นำการตั้งค่านี้ออก

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

setUnderline(underline)

ตั้งค่าการขีดเส้นใต้ข้อความสำหรับรูปแบบของกฎการจัดรูปแบบตามเงื่อนไข หาก underline เป็น true กฎจะขีดเส้นใต้ข้อความหากเป็นไปตามเงื่อนไข หากเป็น false กฎจะนำขีดเส้นใต้ที่มีอยู่ออกหากเป็นไปตามเงื่อนไข การส่งค่า null จะนําการตั้งค่ารูปแบบขีดล่างออกจากกฎ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
underlineBooleanข้อความควรขีดเส้นใต้หรือไม่หากเป็นไปตามเงื่อนไขการจัดรูปแบบ null นำการตั้งค่านี้ออก

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

whenCellEmpty()

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อเซลล์ว่าง 

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they are empty.
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);

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

whenCellNotEmpty()

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อเซลล์ไม่ว่างเปล่า 

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they are not empty.
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);

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

whenDateAfter(date)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อวันที่อยู่หลังค่าที่ระบุ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateDateวันที่ล่าสุด

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

whenDateAfter(date)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อวันที่อยู่หลังวันที่ที่เกี่ยวข้อง 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateRelativeDateวันที่ล่าสุดที่เกี่ยวข้องกับประเภทวันที่ที่เลือก

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

whenDateBefore(date)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อวันที่อยู่ก่อนวันที่ที่ระบุ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateDateวันที่ที่ยอมรับไม่ได้เร็วที่สุด

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

whenDateBefore(date)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อวันที่อยู่ก่อนวันที่ที่เกี่ยวข้อง 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateRelativeDateวันที่ล่าสุดที่เกี่ยวข้องกับประเภทวันที่ที่เลือก

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

whenDateEqualTo(date)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อวันที่เท่ากับวันที่ที่ระบุ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateDateวันที่ที่ยอมรับได้เพียงวันเดียว

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

whenDateEqualTo(date)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อวันที่เท่ากับวันที่แบบสัมพัทธ์ที่ระบุ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateRelativeDateวันที่ล่าสุดที่เกี่ยวข้องกับประเภทวันที่ที่เลือก

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

whenFormulaSatisfied(formula)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อสูตรที่ระบุให้ค่าเป็น true 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
formulaStringสูตรที่กําหนดเองซึ่งประเมินเป็น true หากอินพุตถูกต้อง

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

whenNumberBetween(start, end)

ตั้งค่ากฎรูปแบบเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขอยู่ในช่วงหรือเป็นค่าใดค่าหนึ่งจาก 2 ค่าที่ระบุ 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
startNumberค่าต่ำสุดที่ยอมรับได้
endNumberค่าสูงสุดที่ยอมรับได้

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

whenNumberEqualTo(number)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขเท่ากับค่าที่ระบุ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberค่าเดียวที่ยอมรับได้

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

whenNumberGreaterThan(number)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขมากกว่าค่าที่ระบุ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberค่าสูงสุดที่ไม่ยอมรับ

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

whenNumberGreaterThanOrEqualTo(number)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขมากกว่าหรือเท่ากับค่าที่ระบุ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberค่าต่ำสุดที่ยอมรับได้

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

whenNumberLessThan(number)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขน้อยกว่าค่าที่ระบุ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberค่าต่ำสุดที่ไม่ยอมรับ

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

whenNumberLessThanOrEqualTo(number)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขน้อยกว่าหรือเท่ากับค่าที่ระบุ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberค่าสูงสุดที่ยอมรับได้

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

whenNumberNotBetween(start, end)

ตั้งค่ากฎรูปแบบเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขไม่ได้อยู่ในช่วงระหว่างและไม่ใช่ค่าใดค่าหนึ่งจาก 2 ค่าที่ระบุ 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
startNumberค่าต่ำสุดที่ไม่ยอมรับ
endNumberค่าสูงสุดที่ไม่ยอมรับ

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

whenNumberNotEqualTo(number)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขไม่เท่ากับค่าที่ระบุ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberค่าเดียวที่ไม่ยอมรับ

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

whenTextContains(text)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่ออินพุตมีค่าที่ระบุ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringค่าที่อินพุตต้องมี

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

whenTextDoesNotContain(text)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่ออินพุตไม่มีค่าที่ระบุ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringค่าที่อินพุตต้องไม่มี

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

whenTextEndsWith(text)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่ออินพุตลงท้ายด้วยค่าที่ระบุ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringข้อความที่จะเปรียบเทียบกับส่วนท้ายของสตริง

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

whenTextEqualTo(text)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่ออินพุตเท่ากับค่าที่ระบุ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringค่าเดียวที่ยอมรับได้

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

whenTextStartsWith(text)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่ออินพุตเริ่มต้นด้วยค่าที่ระบุ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringข้อความที่จะเปรียบเทียบกับต้นของสตริง

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม

withCriteria(criteria, args)

ตั้งค่ากฎรูปแบบแบบมีเงื่อนไขเป็นเกณฑ์ที่กําหนดโดยค่า BooleanCriteria ซึ่งโดยปกติแล้วนํามาจาก criteria และ arguments ของกฎที่มีอยู่ 

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
criteriaBooleanCriteriaประเภทของเกณฑ์การจัดรูปแบบตามเงื่อนไข
argsObject[]อาร์เรย์ของอาร์กิวเมนต์ที่เหมาะสมกับประเภทเกณฑ์ จำนวนอาร์กิวเมนต์และประเภทของอาร์กิวเมนต์ต้องตรงกับเมธอด when...() ที่เกี่ยวข้องด้านบน

รีเทิร์น

ConditionalFormatRuleBuilder — ตัวสร้างสําหรับการต่อเชื่อม