Excel.DateTimeDataValidation interface

Représente les critères de validation des données de date.

Remarques

Jeu d’API : ExcelApi 1.8

Utilisateur

Exemples

// 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;
}

Propriétés

formula1

Spécifie l’opérande de droite lorsque la propriété de l’opérateur est définie sur un opérateur binaire tel que Supérieur à (l’opérande de gauche est la valeur que l’utilisateur tente d’entrer dans la cellule). Avec les opérateurs ternaires Between et NotBetween, spécifie l’opérande de limite inférieure. Lors de la définition de la valeur, elle peut être transmise sous la forme d’une date, d’un objet Range ou d’une formule de chaîne (où la chaîne est soit une date/heure stringifiée au format ISO8601, une référence de cellule telle que « =A1 » ou une formule telle que « =MIN(A1, B1) »). Lors de la récupération de la valeur, elle sera toujours renvoyée sous forme de formule de chaîne, par exemple : « =10 », « =A1 », « =SOMME(A1 :B5) », etc.

formula2

Avec les opérateurs ternaires Between et NotBetween, spécifie l’opérande de limite supérieure. N’est pas utilisé avec les opérateurs binaires, tels que Supérieur à. Lors de la définition de la valeur, elle peut être transmise sous la forme d’une date, d’un objet Range ou d’une chaîne (où la chaîne est soit une date/heure stringifiée au format ISO8601, une référence de cellule telle que « =A1 » ou une formule telle que « =MIN(A1, B1) »). Lors de la récupération de la valeur, elle sera toujours renvoyée sous forme de formule de chaîne, par exemple : « =10 », « =A1 », « =SOMME(A1 :B5) », etc.

operator

L’opérateur à utiliser pour la validation des données.

Détails de la propriété

formula1

Spécifie l’opérande de droite lorsque la propriété de l’opérateur est définie sur un opérateur binaire tel que Supérieur à (l’opérande de gauche est la valeur que l’utilisateur tente d’entrer dans la cellule). Avec les opérateurs ternaires Between et NotBetween, spécifie l’opérande de limite inférieure. Lors de la définition de la valeur, elle peut être transmise sous la forme d’une date, d’un objet Range ou d’une formule de chaîne (où la chaîne est soit une date/heure stringifiée au format ISO8601, une référence de cellule telle que « =A1 » ou une formule telle que « =MIN(A1, B1) »). Lors de la récupération de la valeur, elle sera toujours renvoyée sous forme de formule de chaîne, par exemple : « =10 », « =A1 », « =SOMME(A1 :B5) », etc.

formula1: string | Date | Range;

Valeur de propriété

string | Date | Excel.Range

Remarques

Jeu d’API : ExcelApi 1.8

formula2

Avec les opérateurs ternaires Between et NotBetween, spécifie l’opérande de limite supérieure. N’est pas utilisé avec les opérateurs binaires, tels que Supérieur à. Lors de la définition de la valeur, elle peut être transmise sous la forme d’une date, d’un objet Range ou d’une chaîne (où la chaîne est soit une date/heure stringifiée au format ISO8601, une référence de cellule telle que « =A1 » ou une formule telle que « =MIN(A1, B1) »). Lors de la récupération de la valeur, elle sera toujours renvoyée sous forme de formule de chaîne, par exemple : « =10 », « =A1 », « =SOMME(A1 :B5) », etc.

formula2?: string | Date | Range;

Valeur de propriété

string | Date | Excel.Range

Remarques

Jeu d’API : ExcelApi 1.8

operator

L’opérateur à utiliser pour la validation des données.

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

Valeur de propriété

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

Remarques

Jeu d’API : ExcelApi 1.8