ExcelScript.FilterDatetime interface

Paquet:

ExcelScript

Représente la méthode de filtrage d’une date lorsque des valeurs sont filtrées.

Remarques

Exemples

/**
 * This script applies a filter to a PivotTable that filters it
 * to only show rows from between June 20th, 2022 and July 10th, 2022.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the "Date Recorded" field to filter. 
  // The data in this field must be dates in order for the filter to work.
  const pivot = workbook.getPivotTables()[0];
  const rowHierarchy = pivot.getRowHierarchy("Date Recorded");
  const rowField = rowHierarchy.getFields()[0];

  // Create the filter's date boundaries.
  let earliestDate: ExcelScript.FilterDatetime = {
    date: "2022-06-20",
    specificity: ExcelScript.FilterDatetimeSpecificity.day
  };
  let latestDate: ExcelScript.FilterDatetime = {
    date: "2022-07-10",
    specificity: ExcelScript.FilterDatetimeSpecificity.day
  };

  // Apply the date filter.
  rowField.applyFilter({
    dateFilter: {
      condition: ExcelScript.DateFilterCondition.between,
      lowerBound: earliestDate,
      upperBound: latestDate
    }
  });
}

Propriétés

date	Date au format ISO8601 utilisée pour filtrer des données.
specificity	Utilisation de la date pour conserver des données. Par exemple, si la date est 2005-04-02 et que la spécificité est définie sur « mois », l’opération de filtre conserve toutes les lignes dont la date est le mois d’avril 2005.

Détails de la propriété

date

Date au format ISO8601 utilisée pour filtrer des données.

date: string;

Valeur de propriété

string

specificity

Utilisation de la date pour conserver des données. Par exemple, si la date est 2005-04-02 et que la spécificité est définie sur « mois », l’opération de filtre conserve toutes les lignes dont la date est le mois d’avril 2005.

specificity: FilterDatetimeSpecificity;

Valeur de propriété

ExcelScript.FilterDatetimeSpecificity