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 задает нижний предельный операнд. При задании значения его можно передать в виде даты или строковой формулы (строка — это строка даты и времени в ISO8601 формате, ссылка на ячейку вида "=A1" или формула вида "=МИН(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 задает нижний предельный операнд. При задании значения его можно передать в виде даты или строковой формулы (строка — это строка даты и времени в ISO8601 формате, ссылка на ячейку вида "=A1" или формула вида "=МИН(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