Class DataValidationBuilder

DataValidationBuilder

Builder untuk aturan validasi data.

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

Metode

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

Dokumentasi mendetail

build()

Membuat aturan validasi data dari setelan yang diterapkan pada builder.

Return

DataValidation — representasi dari 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.
var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
var newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
var rules = range.getDataValidations();

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

    if (rule != null) {
      var criteria = rule.getCriteriaType();
      var 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);

Return

DataValidationBuilder — pembuat berdasarkan setelan aturan ini


getAllowInvalid()

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

Return

Booleantrue 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 bagi kriteria tersebut, 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var 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.')
}

Return

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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var 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.')
}

Return

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.

Return

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


requireCheckbox()

Menetapkan aturan validasi data untuk mengharuskan 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox().build();
cell.setDataValidation(rule);

Return

DataValidationBuilder — builder ini, untuk rantai


requireCheckbox(checkedValue)

Menetapkan aturan validasi data untuk mengharuskan input adalah nilai yang ditentukan atau kosong. Jika input cocok dengan nilai yang ditentukan, sel akan dirender sebagai kotak centang yang dicentang. Jika input kosong, sel akan 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED').build();
cell.setDataValidation(rule);

Parameter

NameJenisDeskripsi
checkedValueObjectNilai yang ditetapkan ke kotak yang dicentang.

Return

DataValidationBuilder — builder ini, untuk rantai


requireCheckbox(checkedValue, uncheckedValue)

Menetapkan aturan validasi data untuk mengharuskan input adalah salah satu nilai yang ditentukan. Jika inputnya adalah checkedValue, sel akan dirender sebagai kotak centang yang dicentang. Jika inputnya adalah uncheckedValue, sel akan 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED', 'PENDING').build();
cell.setDataValidation(rule);

Parameter

NameJenisDeskripsi
checkedValueObjectNilai yang ditetapkan ke kotak yang dicentang.
uncheckedValueObjectNilai yang ditetapkan ke kotak yang tidak dicentang.

Return

DataValidationBuilder — builder ini, untuk rantai


requireDate()

Menetapkan aturan validasi data untuk mewajibkan tanggal.

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

Return

DataValidationBuilder — builder ini, untuk rantai


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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateAfter(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

Parameter

NameJenisDeskripsi
dateDateTanggal terbaru yang tidak dapat diterima.

Return

DataValidationBuilder — builder ini, untuk rantai


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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateBefore(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

Parameter

NameJenisDeskripsi
dateDateTanggal paling awal yang tidak dapat diterima.

Return

DataValidationBuilder — builder ini, untuk rantai


requireDateBetween(start, end)

Menetapkan aturan validasi data untuk memerlukan 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateBetween(new Date('1/1/2013'), new Date('12/31/2013')).build();
cell.setDataValidation(rule);

Parameter

NameJenisDeskripsi
startDateTanggal paling awal yang dapat diterima.
endDateTanggal terbaru yang dapat diterima.

Return

DataValidationBuilder — builder ini, untuk rantai


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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateEqualTo(new Date('1/1/2013'))
    .build();
cell.setDataValidation(rule);

Parameter

NameJenisDeskripsi
dateDateSatu-satunya tanggal yang dapat diterima.

Return

DataValidationBuilder — builder ini, untuk rantai


requireDateNotBetween(start, end)

Menetapkan aturan validasi data untuk memerlukan tanggal yang tidak berada di antara, dan bukan 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateNotBetween(new Date('1/1/2013'), new Date('12/31/2013')).build();
cell.setDataValidation(rule);

Parameter

NameJenisDeskripsi
startDateTanggal paling awal yang tidak dapat diterima.
endDateTanggal terbaru yang tidak dapat diterima.

Return

DataValidationBuilder — builder ini, untuk rantai


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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateOnOrAfter(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

Parameter

NameJenisDeskripsi
dateDateTanggal paling awal yang dapat diterima.

Return

DataValidationBuilder — builder ini, untuk rantai


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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateOnOrBefore(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

Parameter

NameJenisDeskripsi
dateDateTanggal terbaru yang dapat diterima.

Return

DataValidationBuilder — builder ini, untuk rantai


requireFormulaSatisfied(formula)

Menetapkan aturan validasi data untuk mengharuskan formula yang diberikan bernilai true.

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

Parameter

NameJenisDeskripsi
formulaStringFormula kustom yang bernilai true jika inputnya valid.

Return

DataValidationBuilder — builder ini, untuk rantai


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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberBetween(1, 10).build();
cell.setDataValidation(rule);

Parameter

NameJenisDeskripsi
startNumberNilai terendah yang dapat diterima.
endNumberNilai tertinggi yang dapat diterima.

Return

DataValidationBuilder — builder ini, untuk rantai


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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberEqualTo(3.1415926536).build();
cell.setDataValidation(rule);

Parameter

NameJenisDeskripsi
numberNumberSatu-satunya nilai yang dapat diterima.

Return

DataValidationBuilder — builder ini, untuk rantai


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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThan(0).build();
cell.setDataValidation(rule);

Parameter

NameJenisDeskripsi
numberNumberNilai tertinggi yang tidak dapat diterima.

Return

DataValidationBuilder — builder ini, untuk rantai


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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThanOrEqualTo(0).build();
cell.setDataValidation(rule);

Parameter

NameJenisDeskripsi
numberNumberNilai terendah yang dapat diterima.

Return

DataValidationBuilder — builder ini, untuk rantai


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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberLessThan(0).build();
cell.setDataValidation(rule);

Parameter

NameJenisDeskripsi
numberNumberNilai terendah yang tidak dapat diterima.

Return

DataValidationBuilder — builder ini, untuk rantai


requireNumberLessThanOrEqualTo(number)

Menetapkan aturan validasi data untuk mewajibkan angka 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberLessThanOrEqualTo(0).build();
cell.setDataValidation(rule);

Parameter

NameJenisDeskripsi
numberNumberNilai tertinggi yang dapat diterima.

Return

DataValidationBuilder — builder ini, untuk rantai


requireNumberNotBetween(start, end)

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

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

Parameter

NameJenisDeskripsi
startNumberNilai terendah yang tidak dapat diterima.
endNumberNilai tertinggi yang tidak dapat diterima.

Return

DataValidationBuilder — builder ini, untuk rantai


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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberNotEqualTo(0).build();
cell.setDataValidation(rule);

Parameter

NameJenisDeskripsi
numberNumberSatu-satunya nilai yang tidak dapat diterima.

Return

DataValidationBuilder — builder ini, untuk rantai


requireTextContains(text)

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

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

Parameter

NameJenisDeskripsi
textStringNilai yang harus dimuat oleh input.

Return

DataValidationBuilder — builder ini, untuk rantai


requireTextDoesNotContain(text)

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

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

Parameter

NameJenisDeskripsi
textStringNilai yang tidak boleh berisi input.

Return

DataValidationBuilder — builder ini, untuk rantai


requireTextEqualTo(text)

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

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

Parameter

NameJenisDeskripsi
textStringSatu-satunya nilai yang dapat diterima.

Return

DataValidationBuilder — builder ini, untuk rantai


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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextIsEmail().build();
cell.setDataValidation(rule);

Return

DataValidationBuilder — builder ini, untuk rantai


requireTextIsUrl()

Menetapkan aturan validasi data untuk mengharuskan input dalam bentuk URL.

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

Return

DataValidationBuilder — builder ini, untuk rantai


requireValueInList(values)

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

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

Parameter

NameJenisDeskripsi
valuesString[]Array nilai yang dapat diterima.

Return

DataValidationBuilder — builder ini, untuk rantai


requireValueInList(values, showDropdown)

Menetapkan aturan validasi data untuk mengharuskan 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No'], false).build();
cell.setDataValidation(rule);

Parameter

NameJenisDeskripsi
valuesString[]Array nilai yang dapat diterima.
showDropdownBooleantrue jika spreadsheet akan menampilkan menu drop-down untuk nilai; false jika tidak.

Return

DataValidationBuilder — builder ini, untuk rantai


requireValueInRange(range)

Menetapkan aturan validasi data untuk mengharuskan input sama dengan nilai dalam rentang tertentu.

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

Parameter

NameJenisDeskripsi
rangeRangeRentang yang berisi nilai yang dapat diterima.

Return

DataValidationBuilder — builder ini, untuk rantai


requireValueInRange(range, showDropdown)

Menetapkan aturan validasi data untuk mengharuskan input setara dengan nilai dalam rentang yang diberikan, dengan opsi untuk menyembunyikan menu drop-down.

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

Parameter

NameJenisDeskripsi
rangeRangeRentang yang berisi nilai yang dapat diterima.
showDropdownBooleantrue jika spreadsheet akan menampilkan menu drop-down untuk nilai; false jika tidak.

Return

DataValidationBuilder — builder ini, untuk rantai


setAllowInvalid(allowInvalidData)

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

Parameter

NameJenisDeskripsi
allowInvalidDataBooleantrue jika aturan harus mengizinkan input yang gagal validasi data; false jika tidak.

Return

DataValidationBuilder — builder ini, untuk rantai


setHelpText(helpText)

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

Parameter

NameJenisDeskripsi
helpTextStringTeks bantuan yang akan disetel.

Return

DataValidationBuilder — builder ini, untuk rantai


withCriteria(criteria, args)

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

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

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

    if (rule != null) {
      var criteria = rule.getCriteriaType();
      var 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

NameJenisDeskripsi
criteriaDataValidationCriteriaJenis kriteria validasi data.
argsObject[]Array argumen yang sesuai dengan jenis kriteria; jumlah argumen dan jenisnya cocok dengan metode require...() terkait di atas.

Return

DataValidationBuilder — builder ini, untuk rantai