Поделиться через


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"

Дата вчера.