Class DataValidationBuilder

Membuat aturan validasi data dari setelan yang diterapkan pada builder.

Return

DataValidation — representasi dari aturan validasi data

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

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

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

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

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

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

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

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

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

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai

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

Parameter

Return

DataValidationBuilder — builder ini, untuk rantai

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

Return

DataValidationBuilder — builder ini, untuk rantai