Excel.DateFilterCondition enum

Перечисление, представляющее все допустимые условия, при которых можно применять фильтр по дате. Используется для настройки типа PivotFilter, применяемого к полю.

Комментарии

Набор API: ExcelApi 1.12

Используется

Примеры

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/38-pivottable/pivottable-pivotfilters.yaml

await Excel.run(async (context) => {
  // Add a date-based PivotFilter.

  // Get the PivotTable.
  const pivotTable = context.workbook.worksheets.getActiveWorksheet().pivotTables.getItem("Farm Sales");

  // PivotFilters can only be applied to PivotHierarchies that are being used for pivoting.
  // If it's not already there, add "Date Updated" to the hierarchies.
  let dateHierarchy = pivotTable.rowHierarchies.getItemOrNullObject("Date Updated");
  await context.sync();
  if (dateHierarchy.isNullObject) {
    dateHierarchy = pivotTable.rowHierarchies.add(pivotTable.hierarchies.getItem("Date Updated"));
  }

  // Apply a date filter to filter out anything logged before August.
  const filterField = dateHierarchy.fields.getItem("Date Updated");
  const dateFilter = {
    condition: Excel.DateFilterCondition.afterOrEqualTo,
    comparator: {
      date: "2020-08-01",
      specificity: Excel.FilterDatetimeSpecificity.month
    }
  };
  filterField.applyFilter({ dateFilter: dateFilter });

  await context.sync();
});

Поля

after = "After"

Дата после даты сравнения.

Требуемое условие: {comparator}. Необязательный критерий: {wholeDays}.

afterOrEqualTo = "AfterOrEqualTo"

Дата предшествует или равна дате сравнения.

Требуемое условие: {comparator}. Необязательный критерий: {wholeDays}.

allDatesInPeriodApril = "AllDatesInPeriodApril"

Дата в апреле.

allDatesInPeriodAugust = "AllDatesInPeriodAugust"

Дата - август.

allDatesInPeriodDecember = "AllDatesInPeriodDecember"

Дата - декабрь.

allDatesInPeriodFebruary = "AllDatesInPeriodFebruary"

Дата - февраль.

allDatesInPeriodJanuary = "AllDatesInPeriodJanuary"

Дата - январь.

allDatesInPeriodJuly = "AllDatesInPeriodJuly"

Дата - июль.

allDatesInPeriodJune = "AllDatesInPeriodJune"

Дата - июнь.

allDatesInPeriodMarch = "AllDatesInPeriodMarch"

Дата - март.

allDatesInPeriodMay = "AllDatesInPeriodMay"

Дата - май.

allDatesInPeriodNovember = "AllDatesInPeriodNovember"

Дата - ноябрь.

allDatesInPeriodOctober = "AllDatesInPeriodOctober"

Дата - октябрь.

allDatesInPeriodQuarter1 = "AllDatesInPeriodQuarter1"

Дата приходится на квартал 1.

allDatesInPeriodQuarter2 = "AllDatesInPeriodQuarter2"

Дата приходится на квартал 2.

allDatesInPeriodQuarter3 = "AllDatesInPeriodQuarter3"

Дата приходится на квартал 3.

allDatesInPeriodQuarter4 = "AllDatesInPeriodQuarter4"

Дата приходится на квартал 4.

allDatesInPeriodSeptember = "AllDatesInPeriodSeptember"

Дата - сентябрь.

before = "Before"

Дата предшествует дате сравнения.

Требуемое условие: {comparator}. Необязательный критерий: {wholeDays}.

beforeOrEqualTo = "BeforeOrEqualTo"

Дата предшествует дате компаратора или равна ей.

Требуемое условие: {comparator}. Необязательный критерий: {wholeDays}.

between = "Between"

Между lowerBound и upperBound датами.

Необходимые условия: {lowerBound, upperBound}. Необязательное условие: {wholeDays, exclusive}.

equals = "Equals"

Условие сравнения.

Требуемое условие: {comparator}. Необязательное условие: {wholeDays, exclusive}.

lastMonth = "LastMonth"

Дата — прошлый месяц.

lastQuarter = "LastQuarter"

Дата — последний квартал.

lastWeek = "LastWeek"

Дата - прошлая неделя.

lastYear = "LastYear"

Дата — прошлый год.

nextMonth = "NextMonth"

Дата следующего месяца.

nextQuarter = "NextQuarter"

Дата следующего квартала.

nextWeek = "NextWeek"

Дата на следующей неделе.

nextYear = "NextYear"

Дата - следующий год.

thisMonth = "ThisMonth"

Дата — этот месяц.

thisQuarter = "ThisQuarter"

Дата — этот квартал.

thisWeek = "ThisWeek"

Дата на этой неделе.

thisYear = "ThisYear"

Дата в этом году.

today = "Today"

Дата сегодня.

tomorrow = "Tomorrow"

Дата завтра.

unknown = "Unknown"

DateFilterCondition неизвестен или не поддерживается.

yearToDate = "YearToDate"

Дата с начала года.

yesterday = "Yesterday"

Дата — вчера.