Excel.DateTimeDataValidation interface

日付データの入力規則を表します。

注釈

API セット: ExcelApi 1.8

使用元

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/22-data-validation/data-validation-types.yaml

function applyTime(sheet: Excel.Worksheet) {
    // Time must be between 9:00 AM and 5:00 PM.
    const basicRule: Excel.DateTimeDataValidation = {
        formula1: "9:00 AM",
        formula2: "5:00 PM",
        operator: Excel.DataValidationOperator.between
    };
    const rule: Excel.DataValidationRule = { time: basicRule };
    sheet.getRange("B6").dataValidation.rule = rule;
}

プロパティ

formula1

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

formula2

三項演算子 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 | Excel.Range

注釈

API セット: ExcelApi 1.8

formula2

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

formula2?: string | Date | Range;

プロパティ値

string | Date | Excel.Range

注釈

API セット: ExcelApi 1.8

operator

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

operator: Excel.DataValidationOperator | "Between" | "NotBetween" | "EqualTo" | "NotEqualTo" | "GreaterThan" | "LessThan" | "GreaterThanOrEqualTo" | "LessThanOrEqualTo";

プロパティ値

Excel.DataValidationOperator | "Between" | "NotBetween" | "EqualTo" | "NotEqualTo" | "GreaterThan" | "LessThan" | "GreaterThanOrEqualTo" | "LessThanOrEqualTo"

注釈

API セット: ExcelApi 1.8