Excel.DateTimeDataValidation interface

包:
excel

表示日期数据验证条件。

注解

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