Class DataValidationBuilder

DataValidationBuilder

Pembangun untuk aturan validasi data.

// Set the data validation for cell A1 to require a value from B1:B10.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
build()	DataValidation	Membuat aturan validasi data dari setelan yang diterapkan ke builder.
copy()	DataValidationBuilder	Membuat builder untuk aturan validasi data berdasarkan setelan aturan ini.
getAllowInvalid()	Boolean	Menampilkan true jika aturan menampilkan peringatan saat input gagal validasi data, atau false jika menolak input sepenuhnya.
getCriteriaType()	DataValidationCriteria	Mendapatkan jenis kriteria aturan seperti yang ditentukan dalam enum DataValidationCriteria.
getCriteriaValues()	Object[]	Mendapatkan array argumen untuk kriteria aturan.
getHelpText()	String	Mendapatkan teks bantuan aturan, atau null jika tidak ada teks bantuan yang ditetapkan.
requireCheckbox()	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan input berupa nilai boolean; nilai ini dirender sebagai kotak centang.
requireCheckbox(checkedValue)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan input berupa nilai yang ditentukan atau kosong.
requireCheckbox(checkedValue, uncheckedValue)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan input berupa salah satu nilai yang ditentukan.
requireDate()	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan tanggal.
requireDateAfter(date)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan tanggal setelah nilai yang diberikan.
requireDateBefore(date)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan tanggal sebelum nilai yang diberikan.
requireDateBetween(start, end)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan tanggal yang berada di antara, atau salah satu dari, dua tanggal yang ditentukan.
requireDateEqualTo(date)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan tanggal yang sama dengan nilai yang diberikan.
requireDateNotBetween(start, end)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan tanggal yang tidak berada di antara, dan bukan salah satu dari, dua tanggal yang ditentukan.
requireDateOnOrAfter(date)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan tanggal pada atau setelah nilai yang diberikan.
requireDateOnOrBefore(date)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan tanggal pada atau sebelum nilai yang diberikan.
requireFormulaSatisfied(formula)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan agar formula yang diberikan dievaluasi ke true.
requireNumberBetween(start, end)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan angka yang berada di antara, atau salah satu dari, dua angka yang ditentukan.
requireNumberEqualTo(number)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan angka yang sama dengan nilai yang diberikan.
requireNumberGreaterThan(number)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan angka yang lebih besar dari nilai yang diberikan.
requireNumberGreaterThanOrEqualTo(number)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan angka yang lebih besar dari atau sama dengan nilai yang diberikan.
requireNumberLessThan(number)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan angka yang kurang dari nilai yang diberikan.
requireNumberLessThanOrEqualTo(number)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan angka yang kurang dari atau sama dengan nilai yang diberikan.
requireNumberNotBetween(start, end)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan angka yang tidak berada di antara, dan tidak termasuk, dua angka yang ditentukan.
requireNumberNotEqualTo(number)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan angka yang tidak sama dengan nilai yang diberikan.
requireTextContains(text)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan input berisi nilai yang diberikan.
requireTextDoesNotContain(text)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan agar input tidak berisi nilai yang diberikan.
requireTextEqualTo(text)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan input sama dengan nilai yang diberikan.
requireTextIsEmail()	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan input dalam bentuk alamat email.
requireTextIsUrl()	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan input dalam bentuk URL.
requireValueInList(values)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan input sama dengan salah satu nilai yang diberikan.
requireValueInList(values, showDropdown)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan input sama dengan salah satu nilai yang diberikan, dengan opsi untuk menyembunyikan menu dropdown.
requireValueInRange(range)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan input sama dengan nilai dalam rentang yang diberikan.
requireValueInRange(range, showDropdown)	DataValidationBuilder	Menetapkan aturan validasi data untuk mewajibkan input sama dengan nilai dalam rentang yang diberikan, dengan opsi untuk menyembunyikan menu dropdown.
setAllowInvalid(allowInvalidData)	DataValidationBuilder	Menetapkan apakah akan menampilkan peringatan saat input gagal divalidasi data atau apakah akan menolak input sepenuhnya.
setHelpText(helpText)	DataValidationBuilder	Menetapkan teks bantuan yang muncul saat pengguna mengarahkan kursor ke sel tempat validasi data ditetapkan.
withCriteria(criteria, args)	DataValidationBuilder	Menetapkan aturan validasi data ke kriteria yang ditentukan oleh nilai DataValidationCriteria, biasanya diambil dari criteria dan arguments aturan yang ada.

Dokumentasi mendetail

build()

Membuat aturan validasi data dari setelan yang diterapkan ke builder.

Pulang pergi

DataValidation — representasi aturan validasi data

---

copy()

Membuat builder untuk aturan validasi data berdasarkan setelan aturan ini.

// Change existing data validation rules that require a date in 2013 to require
// a date in 2014.
const oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
const newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
const rules = range.getDataValidations();

for (let i = 0; i < rules.length; i++) {
  for (let j = 0; j < rules[i].length; j++) {
    const rule = rules[i][j];

    if (rule != null) {
      const criteria = rule.getCriteriaType();
      const args = rule.getCriteriaValues();

      if (criteria === SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN &&
          args[0].getTime() === oldDates[0].getTime() &&
          args[1].getTime() === oldDates[1].getTime()) {
        // Create a builder from the existing rule, then change the dates.
        rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();
      }
    }
  }
}
range.setDataValidations(rules);

Pulang pergi

DataValidationBuilder — builder berdasarkan setelan aturan ini

---

getAllowInvalid()

Menampilkan true jika aturan menampilkan peringatan saat input gagal validasi data, atau false jika menolak input sepenuhnya. Default untuk aturan validasi data baru adalah true.

Pulang pergi

Boolean — true jika aturan mengizinkan input yang gagal validasi data; false jika tidak

---

getCriteriaType()

Mendapatkan jenis kriteria aturan seperti yang ditentukan dalam enum DataValidationCriteria. Untuk mendapatkan argumen untuk kriteria, gunakan getCriteriaValues(). Untuk menggunakan nilai ini guna membuat atau mengubah aturan validasi data, lihat withCriteria(criteria, args).

// Log information about the data validation rule for cell A1.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.');
}

Pulang pergi

DataValidationCriteria — jenis kriteria validasi data

---

getCriteriaValues()

Mendapatkan array argumen untuk kriteria aturan. Untuk mendapatkan jenis kriteria, gunakan getCriteriaType(). Untuk menggunakan nilai ini guna membuat atau mengubah aturan validasi data, lihat withCriteria(criteria, args).

// Log information about the data validation rule for cell A1.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.');
}

Pulang pergi

Object[] — array argumen yang sesuai dengan jenis kriteria aturan; jumlah argumen dan jenisnya cocok dengan metode require...() yang sesuai dari class DataValidationBuilder

---

getHelpText()

Mendapatkan teks bantuan aturan, atau null jika tidak ada teks bantuan yang ditetapkan.

Pulang pergi

String — teks bantuan aturan, atau null jika tidak ada teks bantuan yang ditetapkan

---

requireCheckbox()

Menetapkan aturan validasi data untuk mewajibkan input berupa nilai boolean; nilai ini dirender sebagai kotak centang.

// Set the data validation for cell A1 to require a boolean value; the value is
// rendered as a checkbox.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation().requireCheckbox().build();
cell.setDataValidation(rule);

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireCheckbox(checkedValue)

Menetapkan aturan validasi data untuk mewajibkan input berupa nilai yang ditentukan atau kosong. Jika input cocok dengan nilai yang ditentukan, sel akan dirender sebagai kotak centang yang dicentang. Jika input kosong, sel dirender sebagai kotak centang yang tidak dicentang.

// Set the data validation for cell A1 to require a custom checked value that is
// rendered as a checkbox.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED').build();
cell.setDataValidation(rule);

Parameter

Nama	Jenis	Deskripsi
checkedValue	Object	Nilai yang ditetapkan ke kotak yang dicentang.

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireCheckbox(checkedValue, uncheckedValue)

Menetapkan aturan validasi data untuk mewajibkan input berupa salah satu nilai yang ditentukan. Jika inputnya adalah checkedValue, sel akan dirender sebagai kotak centang yang dicentang. Jika inputnya adalah uncheckedValue, sel dirender sebagai kotak centang yang tidak dicentang.

// Set the data validation for cell A1 to require custom checked values that are
// rendered as a checkbox.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireCheckbox('APPROVED', 'PENDING')
                 .build();
cell.setDataValidation(rule);

Parameter

Nama	Jenis	Deskripsi
checkedValue	Object	Nilai yang ditetapkan ke kotak yang dicentang.
uncheckedValue	Object	Nilai yang ditetapkan ke kotak yang tidak dicentang.

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireDate()

Menetapkan aturan validasi data untuk mewajibkan tanggal.

// Set the data validation for cell A1 to require a date.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation().requireDate().build();
cell.setDataValidation(rule);

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireDateAfter(date)

Menetapkan aturan validasi data untuk mewajibkan tanggal setelah nilai yang diberikan. Kolom waktu objek Date diabaikan; hanya kolom hari, bulan, dan tahun yang digunakan.

// Set the data validation for cell A1 to require a date after January 1, 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateAfter(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parameter

Nama	Jenis	Deskripsi
date	Date	Tanggal terakhir yang tidak dapat diterima.

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireDateBefore(date)

Menetapkan aturan validasi data untuk mewajibkan tanggal sebelum nilai yang diberikan. Kolom waktu objek Date diabaikan; hanya kolom hari, bulan, dan tahun yang digunakan.

// Set the data validation for cell A1 to require a date before January 1, 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateBefore(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parameter

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

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireDateBetween(start, end)

Menetapkan aturan validasi data untuk mewajibkan tanggal yang berada di antara, atau salah satu dari, dua tanggal yang ditentukan. Kolom waktu objek Date diabaikan; hanya kolom hari, bulan, dan tahun yang digunakan.

// Set the data validation for cell A1 to require a date in 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation()
        .requireDateBetween(new Date('1/1/2013'), new Date('12/31/2013'))
        .build();
cell.setDataValidation(rule);

Parameter

Nama	Jenis	Deskripsi
start	Date	Tanggal paling awal yang dapat diterima.
end	Date	Tanggal terakhir yang dapat diterima.

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireDateEqualTo(date)

Menetapkan aturan validasi data untuk mewajibkan tanggal yang sama dengan nilai yang diberikan. Kolom waktu objek Date diabaikan; hanya kolom hari, bulan, dan tahun yang digunakan.

// Set the data validation for cell A1 to require a date equal to January 1,
// 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateEqualTo(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parameter

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

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireDateNotBetween(start, end)

Menetapkan aturan validasi data untuk mewajibkan tanggal yang tidak berada di antara, dan bukan salah satu dari, dua tanggal yang ditentukan. Kolom waktu objek Date diabaikan; hanya kolom hari, bulan, dan tahun yang digunakan.

// Set the data validation for cell A1 to require a date not in 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation()
        .requireDateNotBetween(new Date('1/1/2013'), new Date('12/31/2013'))
        .build();
cell.setDataValidation(rule);

Parameter

Nama	Jenis	Deskripsi
start	Date	Tanggal paling awal yang tidak dapat diterima.
end	Date	Tanggal terakhir yang tidak dapat diterima.

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireDateOnOrAfter(date)

Menetapkan aturan validasi data untuk mewajibkan tanggal pada atau setelah nilai yang diberikan. Kolom waktu objek Date diabaikan; hanya kolom hari, bulan, dan tahun yang digunakan.

// Set the data validation for cell A1 to require a date on or after January 1,
// 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateOnOrAfter(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parameter

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

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireDateOnOrBefore(date)

Menetapkan aturan validasi data untuk mewajibkan tanggal pada atau sebelum nilai yang diberikan. Kolom waktu objek Date diabaikan; hanya kolom hari, bulan, dan tahun yang digunakan.

// Set the data validation for cell A1 to require a date on or before January 1,
// 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateOnOrBefore(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parameter

Nama	Jenis	Deskripsi
date	Date	Tanggal terakhir yang dapat diterima.

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireFormulaSatisfied(formula)

Menetapkan aturan validasi data untuk mewajibkan agar formula yang diberikan dievaluasi ke true.

// Set the data validation for cell A1 to equal B1 with a custom formula.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireFormulaSatisfied('=EQ(A1,B1)')
                 .build();
cell.setDataValidation(rule);

Parameter

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

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireNumberBetween(start, end)

Menetapkan aturan validasi data untuk mewajibkan angka yang berada di antara, atau salah satu dari, dua angka yang ditentukan.

// Set the data validation for cell A1 to require a number between 1 and 10.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberBetween(1, 10).build();
cell.setDataValidation(rule);

Parameter

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

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireNumberEqualTo(number)

Menetapkan aturan validasi data untuk mewajibkan angka yang sama dengan nilai yang diberikan.

// Set the data validation for cell A1 to require a number equal
// to 3.1415926536.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberEqualTo(Math.PI).build();
cell.setDataValidation(rule);

Parameter

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

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireNumberGreaterThan(number)

Menetapkan aturan validasi data untuk mewajibkan angka yang lebih besar dari nilai yang diberikan.

// Set the data validation for cell A1 to require a number greater than 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberGreaterThan(0).build();
cell.setDataValidation(rule);

Parameter

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

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireNumberGreaterThanOrEqualTo(number)

Menetapkan aturan validasi data untuk mewajibkan angka yang lebih besar dari atau sama dengan nilai yang diberikan.

// Set the data validation for cell A1 to require a number greater than or equal
// to 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireNumberGreaterThanOrEqualTo(0)
                 .build();
cell.setDataValidation(rule);

Parameter

Nama	Jenis	Deskripsi
number	Number	Nilai terendah yang dapat diterima.

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireNumberLessThan(number)

Menetapkan aturan validasi data untuk mewajibkan angka yang kurang dari nilai yang diberikan.

// Set the data validation for cell A1 to require a number less than 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberLessThan(0).build();
cell.setDataValidation(rule);

Parameter

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

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireNumberLessThanOrEqualTo(number)

Menetapkan aturan validasi data untuk mewajibkan angka yang kurang dari atau sama dengan nilai yang diberikan.

// Set the data validation for cell A1 to require a number less than or equal to
// 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireNumberLessThanOrEqualTo(0)
                 .build();
cell.setDataValidation(rule);

Parameter

Nama	Jenis	Deskripsi
number	Number	Nilai tertinggi yang dapat diterima.

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireNumberNotBetween(start, end)

Menetapkan aturan validasi data untuk mewajibkan angka yang tidak berada di antara, dan tidak termasuk, dua angka yang ditentukan.

// Set the data validation for cell A1 to require a number not between 1 and 10.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberNotBetween(1, 10).build();
cell.setDataValidation(rule);

Parameter

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

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireNumberNotEqualTo(number)

Menetapkan aturan validasi data untuk mewajibkan angka yang tidak sama dengan nilai yang diberikan.

// Set the data validation for cell A1 to require a number not equal to 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberNotEqualTo(0).build();
cell.setDataValidation(rule);

Parameter

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

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireTextContains(text)

Menetapkan aturan validasi data untuk mewajibkan input berisi nilai yang diberikan.

// Set the data validation for cell A1 to require any value that includes
// "Google".
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireTextContains('Google').build();
cell.setDataValidation(rule);

Parameter

Nama	Jenis	Deskripsi
text	String	Nilai yang harus ada dalam input.

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireTextDoesNotContain(text)

Menetapkan aturan validasi data untuk mewajibkan agar input tidak berisi nilai yang diberikan.

// Set the data validation for cell A1 to require any value that does not
// include "@".
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireTextDoesNotContain('@').build();
cell.setDataValidation(rule);

Parameter

Nama	Jenis	Deskripsi
text	String	Nilai yang tidak boleh ada dalam input.

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireTextEqualTo(text)

Menetapkan aturan validasi data untuk mewajibkan input sama dengan nilai yang diberikan.

// Set the data validation for cell A1 to require "Yes".
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireTextEqualTo('Yes').build();
cell.setDataValidation(rule);

Parameter

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

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireTextIsEmail()

Menetapkan aturan validasi data untuk mewajibkan input dalam bentuk alamat email.

// Set the data validation for cell A1 to require text in the form of an email
// address.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation().requireTextIsEmail().build();
cell.setDataValidation(rule);

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireTextIsUrl()

Menetapkan aturan validasi data untuk mewajibkan input dalam bentuk URL.

// Set the data validation for cell A1 to require text in the form of a URL.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation().requireTextIsUrl().build();
cell.setDataValidation(rule);

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireValueInList(values)

Menetapkan aturan validasi data untuk mewajibkan input sama dengan salah satu nilai yang diberikan.

// Set the data validation for cell A1 to require "Yes" or "No", with a dropdown
// menu.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireValueInList(['Yes', 'No'])
                 .build();
cell.setDataValidation(rule);

Parameter

Nama	Jenis	Deskripsi
values	String[]	Array nilai yang dapat diterima.

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireValueInList(values, showDropdown)

Menetapkan aturan validasi data untuk mewajibkan input sama dengan salah satu nilai yang diberikan, dengan opsi untuk menyembunyikan menu dropdown.

// Set the data validation for cell A1 to require "Yes" or "No", with no
// dropdown menu.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireValueInList(['Yes', 'No'], false)
                 .build();
cell.setDataValidation(rule);

Parameter

Nama	Jenis	Deskripsi
values	String[]	Array nilai yang dapat diterima.
showDropdown	Boolean	true jika spreadsheet harus menampilkan menu dropdown untuk nilai; false jika tidak.

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireValueInRange(range)

Menetapkan aturan validasi data untuk mewajibkan input sama dengan nilai dalam rentang yang diberikan.

// Set the data validation for cell A1 to require a value from B1:B10, with a
// dropdown menu.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Parameter

Nama	Jenis	Deskripsi
range	Range	Rentang yang berisi nilai yang dapat diterima.

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

requireValueInRange(range, showDropdown)

Menetapkan aturan validasi data untuk mewajibkan input sama dengan nilai dalam rentang yang diberikan, dengan opsi untuk menyembunyikan menu dropdown.

// Set the data validation for cell A1 to require value from B1:B10, with no
// dropdown menu.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule = SpreadsheetApp.newDataValidation()
                 .requireValueInRange(range, false)
                 .build();
cell.setDataValidation(rule);

Parameter

Nama	Jenis	Deskripsi
range	Range	Rentang yang berisi nilai yang dapat diterima.
showDropdown	Boolean	true jika spreadsheet harus menampilkan menu dropdown untuk nilai; false jika tidak.

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

setAllowInvalid(allowInvalidData)

Menetapkan apakah akan menampilkan peringatan saat input gagal divalidasi data atau apakah akan menolak input sepenuhnya. Default untuk aturan validasi data baru adalah true.

Parameter

Nama	Jenis	Deskripsi
allowInvalidData	Boolean	true jika aturan harus mengizinkan input yang gagal validasi data; false jika tidak.

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

setHelpText(helpText)

Menetapkan teks bantuan yang muncul saat pengguna mengarahkan kursor ke sel tempat validasi data ditetapkan.

Parameter

Nama	Jenis	Deskripsi
helpText	String	Teks bantuan yang akan ditetapkan.

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan

---

withCriteria(criteria, args)

Menetapkan aturan validasi data ke kriteria yang ditentukan oleh nilai DataValidationCriteria, biasanya diambil dari criteria dan arguments aturan yang ada.

// Change existing data validation rules that require a date in 2013 to require
// a date in 2014.
const oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
const newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
const rules = range.getDataValidations();

for (let i = 0; i < rules.length; i++) {
  for (let j = 0; j < rules[i].length; j++) {
    const rule = rules[i][j];

    if (rule != null) {
      const criteria = rule.getCriteriaType();
      const args = rule.getCriteriaValues();

      if (criteria === SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN &&
          args[0].getTime() === oldDates[0].getTime() &&
          args[1].getTime() === oldDates[1].getTime()) {
        // Create a builder from the existing rule, then change the dates.
        rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();
      }
    }
  }
}
range.setDataValidations(rules);

Parameter

Nama	Jenis	Deskripsi
criteria	DataValidationCriteria	Jenis kriteria validasi data.
args	Object[]	Array argumen yang sesuai dengan jenis kriteria; jumlah argumen dan jenisnya cocok dengan metode require...() yang sesuai di atas.

Pulang pergi

DataValidationBuilder — builder ini, untuk dirangkaikan