Compartilhar via


Excel.DateFilterCondition enum

Enumerando todas as condições aceitas pelas quais um filtro de data pode ser aplicado. Usado para configurar o tipo de PivotFilter que é aplicado ao campo.

Comentários

[ Conjunto de API: ExcelApi 1.12 ]

Exemplos

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

Campos

after = "After"

A data é após a data do comparador.

Critérios necessários: {comparator}. Critérios opcionais: {wholeDays}.

afterOrEqualTo = "AfterOrEqualTo"

A data é posterior ou igual à data do comparador.

Critérios necessários: {comparator}. Critérios opcionais: {wholeDays}.

allDatesInPeriodApril = "AllDatesInPeriodApril"

A data é em abril.

allDatesInPeriodAugust = "AllDatesInPeriodAugust"

A data é em agosto.

allDatesInPeriodDecember = "AllDatesInPeriodDecember"

A data é em dezembro.

allDatesInPeriodFebruary = "AllDatesInPeriodFebruary"

A data é em fevereiro.

allDatesInPeriodJanuary = "AllDatesInPeriodJanuary"

A data é em janeiro.

allDatesInPeriodJuly = "AllDatesInPeriodJuly"

A data é em julho.

allDatesInPeriodJune = "AllDatesInPeriodJune"

A data é em junho.

allDatesInPeriodMarch = "AllDatesInPeriodMarch"

A data é em março.

allDatesInPeriodMay = "AllDatesInPeriodMay"

A data é em maio.

allDatesInPeriodNovember = "AllDatesInPeriodNovember"

A data é em novembro.

allDatesInPeriodOctober = "AllDatesInPeriodOctober"

A data é em outubro.

allDatesInPeriodQuarter1 = "AllDatesInPeriodQuarter1"

A data está no trimestre 1.

allDatesInPeriodQuarter2 = "AllDatesInPeriodQuarter2"

A data está no trimestre 2.

allDatesInPeriodQuarter3 = "AllDatesInPeriodQuarter3"

A data está no trimestre 3.

allDatesInPeriodQuarter4 = "AllDatesInPeriodQuarter4"

A data está no trimestre 4.

allDatesInPeriodSeptember = "AllDatesInPeriodSeptember"

A data é em setembro.

before = "Before"

A data é antes da data do comparador.

Critérios necessários: {comparator}. Critérios opcionais: {wholeDays}.

beforeOrEqualTo = "BeforeOrEqualTo"

A data é anterior ou igual à data do comparador.

Critérios necessários: {comparator}. Critérios opcionais: {wholeDays}.

between = "Between"

Entre lowerBound e upperBound datas.

Critérios necessários: {lowerBound, upperBound}. Critérios opcionais: {wholeDays, exclusive}.

equals = "Equals"

É igual ao critério do comparador.

Critérios necessários: {comparator}. Critérios opcionais: {wholeDays, exclusive}.

lastMonth = "LastMonth"

A data é mês passado.

lastQuarter = "LastQuarter"

A data é o último trimestre.

lastWeek = "LastWeek"

A data foi na semana passada.

lastYear = "LastYear"

A data é do ano passado.

nextMonth = "NextMonth"

A data será no próximo mês.

nextQuarter = "NextQuarter"

A data será no próximo trimestre.

nextWeek = "NextWeek"

A data é na próxima semana.

nextYear = "NextYear"

A data será no ano que vem.

thisMonth = "ThisMonth"

A data é este mês.

thisQuarter = "ThisQuarter"

A data é este trimestre.

thisWeek = "ThisWeek"

A data é esta semana.

thisYear = "ThisYear"

A data é este ano.

today = "Today"

A data é hoje.

tomorrow = "Tomorrow"

A data é amanhã.

unknown = "Unknown"

DateFilterCondition é desconhecido ou sem suporte.

yearToDate = "YearToDate"

A data está no mesmo ano até agora.

yesterday = "Yesterday"

A data é ontem.