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	使用三元运算符 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

使用三元运算符 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