ApplyRelativeDateRangeFilter Method (WorksheetFilterSettings)

Applies a RelativeDateRangeFilter to the column.

Syntax

C#

public RelativeDateRangeFilter ApplyRelativeDateRangeFilter( 
   int relativeColumnIndex,
   RelativeDateRangeOffset offset,
   RelativeDateRangeDuration duration
)

Parameters

relativeColumnIndex

A zero based column index relative to the Region

offset

The offset of relative filter. This combined with the duration determines the full range of accepted dates.

duration

The duration of the full range of accepted dates.

Exceptions

Exception	Description
System.ComponentModel.InvalidEnumArgumentException	offset is not defined in the RelativeDateRangeOffset enumeration.
System.ComponentModel.InvalidEnumArgumentException	duration is not defined in the RelativeDateRangeDuration enumeration.
System.InvalidOperationException	If the Region was not set.
System.ArgumentOutOfRangeException	If the relativeColumnIndex is outside of the Region.

Remarks

The RelativeDateRangeFilter allows you to filter in dates which are in the previous, current, or next time period relative to the date when the filter was applied. The time periods available are day, week, month, quarter, year. So when using the previous filter type with a day duration, a 'yesterday' filter is created. Or when using a current filter type with a year duration, a 'this year' filter is created. However, these filters compare the data against the date when the filter was created. So a 'this year' filter created in 1999 will filter in all cells containing dates in 1999, even if the workbook is opened in 2012.

Requirements

Target Platforms: Android 4.4+, iOS 8+

Development Environments: Visual Studio 2015+, Visual Studio for Mac Preview, Xamarin for Visual Studio 4.2+