Date Range Field

Introduction

A Date range field can be placed inside a Report date parameter to make it easier for an end-user to select a date range, rather than having to specify a from and to date. The report date parameter is then updated with the from and to dates of the selected period.

To add a date range field, right-click the widget and choose Add field from the pop-up menu.

Date Range Field Properties

An example of date range field properties is represented in the image below:

Date range field properties have only a General section.

General Section

Label

The Label property specifies the text that is displayed beside the date range field.

Type

Type determines the sort of range which the end-user can select.

Type	Behavior	Example	Range
Year	Allows the end-user to select a calendar year.¹	2019	1 January 2019 to 31 December 2019
Quarter²	Allows the end-user to select a quarter of the year.	2019 > 2	1 April 2019 to 30 June 2019
Month²	Allows the end-user to select a month of the year.	2019 > May	1 May 2019 to 31 May 2019
Week²	Allows the end-user to select a week of the year.	2019 > Week 19	5 May 2019 to 12 May 2019
Period²	The Period date range field is being deprecated. It is recommended that you use one of the other types of date range field.

Notes
¹ The year will be between the Min. year and Max. year (inclusive) specified in the report date parameter widget.
² You also need to add a Year date range field if you use a date range field of this type. – The end-user will need to choose the year before they can choose a date range field of this type. – The end-user can only choose one of these types, plus the year.