ExcelScript.DateTimeDataValidation interface
Représente les critères de validation des données de date.
Remarques
Exemples
/**
* 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
});
}
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 GreaterThan (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 forme de Date, d’objet Range ou de formule de chaîne (où la chaîne est soit une date/heure stringifiée au format ISO8601, une référence de cellule comme « =A1 », soit une formule comme « =MIN(A1, B1) »). Lors de la récupération de la valeur, elle est toujours retournée sous forme de formule de chaîne, par exemple : « =10 », « =A1 », « =SUM(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 GreaterThan. Lors de la définition de la valeur, elle peut être transmise sous forme de Date, d’objet Range ou de chaîne (où la chaîne est soit une date/heure stringifiée au format ISO8601, une référence de cellule comme " =A1 « , soit une formule comme « =MIN(A1, B1) »). Lors de la récupération de la valeur, elle est toujours retournée sous forme de formule de chaîne, par exemple : « =10 », « =A1 », « =SUM(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 GreaterThan (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 forme de Date, d’objet Range ou de formule de chaîne (où la chaîne est soit une date/heure stringifiée au format ISO8601, une référence de cellule comme « =A1 », soit une formule comme « =MIN(A1, B1) »). Lors de la récupération de la valeur, elle est toujours retournée sous forme de formule de chaîne, par exemple : « =10 », « =A1 », « =SUM(A1:B5) », etc.
formula1: string | Date | Range;Valeur de propriété
string | Date | ExcelScript.Range
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 GreaterThan. Lors de la définition de la valeur, elle peut être transmise sous forme de Date, d’objet Range ou de chaîne (où la chaîne est soit une date/heure stringifiée au format ISO8601, une référence de cellule comme " =A1 « , soit une formule comme « =MIN(A1, B1) »). Lors de la récupération de la valeur, elle est toujours retournée sous forme de formule de chaîne, par exemple : « =10 », « =A1 », « =SUM(A1:B5) », etc.
formula2?: string | Date | Range;Valeur de propriété
string | Date | ExcelScript.Range
operator
L’opérateur à utiliser pour la validation des données.
operator: DataValidationOperator;