ExcelScript.DateTimeDataValidation interface

Pacote:

ExcelScript

Representa os critérios de validação de dados de data.

Comentários

Exemplos

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

Propriedades

formula1	Especifica o operando à direita quando a propriedade do operador é definida como um operador binário como GreaterThan (o operando à esquerda é o valor que o usuário tenta inserir na célula). Com os operadores ternários Between e NotBetween, especifica o operando de limite inferior. Ao definir o valor, ele pode ser passado como uma Data, um objeto Range ou uma fórmula de cadeia de caracteres (em que a cadeia de caracteres é uma data/hora com string no formato ISO8601, uma referência de célula como "=A1" ou uma fórmula como "=MIN(A1, B1)"). Ao recuperar o valor, ele sempre será retornado como uma fórmula de cadeia de caracteres, por exemplo: "=10", "=A1", "=SUM(A1:B5)", etc.
formula2	Com os operadores ternários Between e NotBetween, especifica o operando de limite superior. Não é usado com os operadores binários, como GreaterThan. Ao definir o valor, ele pode ser passado como uma Data, um objeto Range ou uma cadeia de caracteres (em que a cadeia de caracteres é uma data/hora com string no formato ISO8601, uma referência de célula como "=A1" ou uma fórmula como "=MIN(A1, B1)"). Ao recuperar o valor, ele sempre será retornado como uma fórmula de cadeia de caracteres, por exemplo: "=10", "=A1", "=SUM(A1:B5)", etc.
operator	O operador a ser usado para validar os dados.

Detalhes da propriedade

formula1

Especifica o operando à direita quando a propriedade do operador é definida como um operador binário como GreaterThan (o operando à esquerda é o valor que o usuário tenta inserir na célula). Com os operadores ternários Between e NotBetween, especifica o operando de limite inferior. Ao definir o valor, ele pode ser passado como uma Data, um objeto Range ou uma fórmula de cadeia de caracteres (em que a cadeia de caracteres é uma data/hora com string no formato ISO8601, uma referência de célula como "=A1" ou uma fórmula como "=MIN(A1, B1)"). Ao recuperar o valor, ele sempre será retornado como uma fórmula de cadeia de caracteres, por exemplo: "=10", "=A1", "=SUM(A1:B5)", etc.

formula1: string | Date | Range;

Valor da propriedade

string | Date | ExcelScript.Range

formula2

Com os operadores ternários Between e NotBetween, especifica o operando de limite superior. Não é usado com os operadores binários, como GreaterThan. Ao definir o valor, ele pode ser passado como uma Data, um objeto Range ou uma cadeia de caracteres (em que a cadeia de caracteres é uma data/hora com string no formato ISO8601, uma referência de célula como "=A1" ou uma fórmula como "=MIN(A1, B1)"). Ao recuperar o valor, ele sempre será retornado como uma fórmula de cadeia de caracteres, por exemplo: "=10", "=A1", "=SUM(A1:B5)", etc.

formula2?: string | Date | Range;

Valor da propriedade

string | Date | ExcelScript.Range

operator

O operador a ser usado para validar os dados.

operator: DataValidationOperator;

Valor da propriedade

ExcelScript.DataValidationOperator