ExcelScript.DateTimeDataValidation interface

Paket:

ExcelScript

Stellt die Datumsdatenüberprüfungskriterien dar.

Hinweise

Beispiele

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

Eigenschaften

formula1	Gibt den rechten Operanden an, wenn die Operatoreigenschaft auf einen binären Operator wie GreaterThan festgelegt ist (der linke Operand ist der Wert, den der Benutzer in die Zelle eingeben möchte). Gibt mit den ternären Operatoren Between und NotBetween den operanden unteren Grenzwert an. Beim Festlegen des Werts kann er als Date- oder Range-Objekt oder Zeichenfolgenformel übergeben werden (wobei die Zeichenfolge entweder ein Zeichenfolgen-Datums-/Uhrzeitformat im format ISO8601, ein Zellbezug wie "=A1" oder eine Formel wie "=MIN(A1, B1)") ist. Beim Abrufen des Werts wird er immer als Zeichenfolgenformel zurückgegeben, z. B. "=10", "=A1", "=SUMME(A1:B5)" usw.
formula2	Gibt mit den ternären Operatoren Between und NotBetween den oberen Begrenzungsoperanden an. Wird nicht mit den binären Operatoren verwendet, z. B. GreaterThan. Beim Festlegen des Werts kann er als Date- oder Range-Objekt oder als Zeichenfolge übergeben werden (wobei die Zeichenfolge entweder ein mit Zeichenfolgen versehenes Datum/uhrzeit im format ISO8601, ein Zellbezug wie "=A1" oder eine Formel wie "=MIN(A1, B1)") ist. Beim Abrufen des Werts wird er immer als Zeichenfolgenformel zurückgegeben, z. B. "=10", "=A1", "=SUMME(A1:B5)" usw.
operator	Der Operator, der zum Überprüfen der Daten verwendet wird.

Details zur Eigenschaft

formula1

Gibt den rechten Operanden an, wenn die Operatoreigenschaft auf einen binären Operator wie GreaterThan festgelegt ist (der linke Operand ist der Wert, den der Benutzer in die Zelle eingeben möchte). Gibt mit den ternären Operatoren Between und NotBetween den operanden unteren Grenzwert an. Beim Festlegen des Werts kann er als Date- oder Range-Objekt oder Zeichenfolgenformel übergeben werden (wobei die Zeichenfolge entweder ein Zeichenfolgen-Datums-/Uhrzeitformat im format ISO8601, ein Zellbezug wie "=A1" oder eine Formel wie "=MIN(A1, B1)") ist. Beim Abrufen des Werts wird er immer als Zeichenfolgenformel zurückgegeben, z. B. "=10", "=A1", "=SUMME(A1:B5)" usw.

formula1: string | Date | Range;

Eigenschaftswert

string | Date | ExcelScript.Range

formula2

Gibt mit den ternären Operatoren Between und NotBetween den oberen Begrenzungsoperanden an. Wird nicht mit den binären Operatoren verwendet, z. B. GreaterThan. Beim Festlegen des Werts kann er als Date- oder Range-Objekt oder als Zeichenfolge übergeben werden (wobei die Zeichenfolge entweder ein mit Zeichenfolgen versehenes Datum/uhrzeit im format ISO8601, ein Zellbezug wie "=A1" oder eine Formel wie "=MIN(A1, B1)") ist. Beim Abrufen des Werts wird er immer als Zeichenfolgenformel zurückgegeben, z. B. "=10", "=A1", "=SUMME(A1:B5)" usw.

formula2?: string | Date | Range;

Eigenschaftswert

string | Date | ExcelScript.Range

operator

Der Operator, der zum Überprüfen der Daten verwendet wird.

operator: DataValidationOperator;

Eigenschaftswert

ExcelScript.DataValidationOperator