ExcelScript.DateTimeDataValidation interface

パッケージ:

ExcelScript

日付データの検証条件を表します。

注釈

例

/**
 * This script sets a validation rule that only allows for certain dates to be entered.
 */
function main(workbook: ExcelScript.Workbook) {
    // Get the range D2:D6 in the current worksheet.
    const selectedSheet = workbook.getActiveWorksheet();
    const range = selectedSheet.getRange("D2:D6");

    // Set a validation rule to only allow values that are dates in the year 2023.
    let dataValidation = range.getDataValidation();
    const dateValidationRule: ExcelScript.DateTimeDataValidation = {
        formula1: "1/1/2023",
        formula2: "12/31/2023",
        operator: ExcelScript.DataValidationOperator.between
    };
    dataValidation.setRule({ date: dateValidationRule});

    // Set an appropriate error message.
    dataValidation.setErrorAlert({ 
        showAlert: true, 
        title: "2023 date required", 
        message: "Please enter a date in the year 2023.", 
        style: ExcelScript.DataValidationAlertStyle.stop
    });
}

プロパティ

formula1	演算子プロパティが GreaterThan などの二項演算子に設定されている場合に、右側のオペランドを指定します (左側のオペランドは、ユーザーがセルに入力しようとする値です)。 Between と NotBetween の三項演算子を使用して、下限オペランドを指定します。 値を設定する場合は、Date、Range オブジェクト、または文字列式 (文字列はISO8601形式の文字列化された日付/時刻、"=A1" などのセル参照、または "=MIN(A1, B1)" などの数式) として渡すことができます。 値を取得すると、"=10"、"=A1"、"=SUM(A1:B5)"など、常に文字列式として返されます。
formula2	3 項演算子 Between と NotBetween を使用して、上限オペランドを指定します。 GreaterThan などの二項演算子では使用されません。 値を設定する場合は、Date、Range オブジェクト、または文字列 (文字列はISO8601形式の文字列化された日付/時刻、"=A1" などのセル参照、または "=MIN(A1, B1)" などの数式) として渡すことができます。 値を取得すると、"=10"、"=A1"、"=SUM(A1:B5)"など、常に文字列式として返されます。
operator	データの検証に使用する演算子。

プロパティの詳細

formula1

演算子プロパティが GreaterThan などの二項演算子に設定されている場合に、右側のオペランドを指定します (左側のオペランドは、ユーザーがセルに入力しようとする値です)。 Between と NotBetween の三項演算子を使用して、下限オペランドを指定します。 値を設定する場合は、Date、Range オブジェクト、または文字列式 (文字列はISO8601形式の文字列化された日付/時刻、"=A1" などのセル参照、または "=MIN(A1, B1)" などの数式) として渡すことができます。 値を取得すると、"=10"、"=A1"、"=SUM(A1:B5)"など、常に文字列式として返されます。

formula1: string | Date | Range;

プロパティ値

string | Date | ExcelScript.Range

formula2

3 項演算子 Between と NotBetween を使用して、上限オペランドを指定します。 GreaterThan などの二項演算子では使用されません。 値を設定する場合は、Date、Range オブジェクト、または文字列 (文字列はISO8601形式の文字列化された日付/時刻、"=A1" などのセル参照、または "=MIN(A1, B1)" などの数式) として渡すことができます。 値を取得すると、"=10"、"=A1"、"=SUM(A1:B5)"など、常に文字列式として返されます。

formula2?: string | Date | Range;

プロパティ値

string | Date | ExcelScript.Range

operator

データの検証に使用する演算子。

operator: DataValidationOperator;

プロパティ値

ExcelScript.DataValidationOperator