DataValidation 詳解

一、DataValidation 簡介

DataValidation（數據驗證）是指在數據輸入、輸出、處理等環節中對數據進行規則判斷，以保證數據的正確性和完整性。在編寫程序時，數據驗證常常是開發者必須遵循的基本原則之一。

數據驗證有很多種。通常使用的數據驗證包括輸入驗證、格式驗證、範圍驗證、唯一性驗證等等。數據驗證有助於提高數據的質量，防止不正確的數據被處理，減少數據處理過程中出現的錯誤。

二、使用 DataValidation

1. 輸入驗證

輸入驗證用於對數據輸入進行驗證，以保證數據正確性和完整性。例如，輸入必須是數字、長度必須在一定範圍內、輸入值必須存在等等。

要使用 DataValidation 進行輸入驗證，可以使用以下代碼：

function inputValidation() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var cell = sheet.getActiveCell();

  // 設置規則（這裡以驗證輸入值必須為數字為例）
  var rule = SpreadsheetApp.newDataValidation()
    .requireNumber()
    .build();

  // 應用規則到相應單元格
  cell.setDataValidation(rule);
}

上述函數用於對選中的單元格進行輸入驗證，驗證規則為輸入值必須為數字。使用 `newDataValidation()` 方法可以創建一個新的 DataValidation 規則，並使用 `.requireNumber()` 方法設置要求輸入值為數字。最後使用 `.build()` 方法生成規則，再使用 `setDataValidation()` 方法將該規則應用到選中單元格。

2. 格式驗證

格式驗證用於驗證數據的格式是否正確，例如日期格式、貨幣格式、電子郵件格式等等。格式驗證也可以被用來指定輸入格式的要求。

要使用 DataValidation 進行格式驗證，可以使用以下代碼：

function formatValidation() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var cell = sheet.getActiveCell();

  // 設置規則（這裡以驗證輸入值必須為日期格式為例）
  var rule = SpreadsheetApp.newDataValidation()
    .requireDate()
    .build();

  // 應用規則到相應單元格
  cell.setDataValidation(rule);
}

上述函數用於對選中的單元格進行格式驗證，驗證規則為輸入值必須為日期格式。使用 `newDataValidation()` 方法創建一個新的 DataValidation 規則，並使用 `.requireDate()` 方法設置要求輸入值為日期格式。最後使用 `.build()` 方法生成規則，再使用 `setDataValidation()` 方法將該規則應用到選中單元格。

3. 範圍驗證

範圍驗證用於驗證數據輸入是否在指定的範圍內，例如限制輸入值必須大於等於某個值，小於等於某個值等等。

要使用 DataValidation 進行範圍驗證，可以使用以下代碼：

function rangeValidation() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var cell = sheet.getActiveCell();

  // 設置規則（這裡以驗證輸入值必須大於等於 0、小於等於 100 為例）
  var rule = SpreadsheetApp.newDataValidation()
    .requireNumberBetween(0, 100)
    .build();

  // 應用規則到相應單元格
  cell.setDataValidation(rule);
}

上述函數用於對選中的單元格進行範圍驗證，驗證規則為輸入值必須大於等於 0、小於等於 100。使用 `newDataValidation()` 方法創建一個新的 DataValidation 規則，並使用 `.requireNumberBetween(start, end)` 方法設置要求輸入值在指定範圍內。最後使用 `.build()` 方法生成規則，再使用 `setDataValidation()` 方法將該規則應用到選中單元格。

4. 唯一性驗證

唯一性驗證用於驗證輸入值是否為唯一值，可以用來防止重複輸入或重複數據。例如，對於團隊名稱、學生姓名等可以使用唯一性驗證。

要使用 DataValidation 進行唯一性驗證，可以使用以下代碼：

function uniqueValidation() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var range = sheet.getDataRange();
  var cells = range.getValues();
  var cell = sheet.getActiveCell();

  var row = cell.getRow();
  var col = cell.getColumn();

  // 判斷當前輸入值是否已存在於其他單元格中
  for (var i = 0; i < cells.length; i++) {
    if (i == row - 1) {
      continue;
    }
    if (cells[i][col - 1] == cell.getValue()) {
      // 如果存在，則提示錯誤信息
      cell.setComment("輸入值必須唯一！");
      return;
    }
  }
  // 輸入值唯一，清空提示信息
  cell.clearComment();
}

上述函數用於對選中的單元格進行唯一性驗證。獲取當前工作表的全部數據，判斷當前輸入值是否已存在於其他單元格中，如果存在，則提示錯誤信息，否則清空提示信息。

三、總結

使用 DataValidation 可以有效提高數據的質量，防止不正確的數據被處理，減少數據處理過程中出現的錯誤。輸入驗證、格式驗證、範圍驗證、唯一性驗證是 DataValidation 常用的驗證方法，應該根據不同的需求選擇相應的驗證方法。