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 задает операнд нижней границы. При задании значения его можно передать в виде даты, объекта Range или строковой формулы (где строка представляет собой строковую дату и время в ISO8601 формате, ссылку на ячейку, например "=A1", или формулу, например "=MIN(A1, B1)"). При получении значения оно всегда будет возвращаться в виде строковой формулы, например "=10", "=A1", "=SUM(A1:B5)" и т. д.
formula2	С помощью троиочных операторов Between и NotBetween задает операнд верхней границы. Не используется с двоичными операторами, такими как GreaterThan. При задании значения его можно передать в виде даты, объекта Range или строки (где строка представляет собой строковую дату и время в ISO8601 формате, ссылку на ячейку, например "=A1", или формулу, например "=MIN(A1, B1)"). При получении значения оно всегда будет возвращаться в виде строковой формулы, например "=10", "=A1", "=SUM(A1:B5)" и т. д.
operator	Оператор, используемый для проверки данных.

Сведения о свойстве

formula1

Задает правый операнд, если свойству оператора присвоен двоичный оператор, например GreaterThan (левый операнд — это значение, которое пользователь пытается ввести в ячейке). С помощью троиочных операторов Between и NotBetween задает операнд нижней границы. При задании значения его можно передать в виде даты, объекта Range или строковой формулы (где строка представляет собой строковую дату и время в ISO8601 формате, ссылку на ячейку, например "=A1", или формулу, например "=MIN(A1, B1)"). При получении значения оно всегда будет возвращаться в виде строковой формулы, например "=10", "=A1", "=SUM(A1:B5)" и т. д.

formula1: string | Date | Range;

Значение свойства

string | Date | ExcelScript.Range

formula2

С помощью троиочных операторов Between и NotBetween задает операнд верхней границы. Не используется с двоичными операторами, такими как GreaterThan. При задании значения его можно передать в виде даты, объекта Range или строки (где строка представляет собой строковую дату и время в ISO8601 формате, ссылку на ячейку, например "=A1", или формулу, например "=MIN(A1, B1)"). При получении значения оно всегда будет возвращаться в виде строковой формулы, например "=10", "=A1", "=SUM(A1:B5)" и т. д.

formula2?: string | Date | Range;

Значение свойства

string | Date | ExcelScript.Range

operator

Оператор, используемый для проверки данных.

operator: DataValidationOperator;

Значение свойства

ExcelScript.DataValidationOperator