iReport Ultimate Guide - Nimsoft Library

iReport Ultimate Guide6.2.4 Relative DatesiReport 5.0 introduces relative dates. This feature enables you create reports that to filter information based on a date rangerelative to the current system date. To do this, use the following template: where:• indicates the time span you want to use. Options include: DAY, WEEK, MONTH, QUARTER, SEMI, and YEAR.• indicates whether the time span occurs before or after the chosen time span.• indicates the number of the above-mentioned time spans you want to include in the filter.For example, if you want to look at Sales for the prior month, your expression would be MONTH - 1.Relative dates are sensitive to time zones. The relative date expression is calculated in the time zone of the logged-inuser.Only one property is configurable: the start day of the week does not depend on locale.The class attribute of JR Parameter of type Relative Date should have one of the following values:• net.sf.jasperreports.engine.rd.DateRange – if you want to use java.util.Date (Date only).For example: If you want to set a relative date as a default value expression of a JR parameter, use the following relative date-builderpattern:• new DateRangeBuilder("DAY-1").toDateRange()• new DateRangeBuilder(”WEEK").set(Timestamp.class).toDateRange()• new DateRangeBuilder("2012-08-01").toDateRange()• new DateRangeBuilder("2012-08-01 12:34:56").toDateRange();For queries, Relative dates are not supported by the $P{} function because it can handle only a limited number of classes(standard Java classes Integer, String etc.). Instead, a new implementation of pluggable functions and parameters inUR supports relative dates with $X{} functions.The following is a JRXML example that shows data from the previous day:Older reports which have date parameters will work just as before, and Relative Dates functionality will beunavailable. In order to make older reports support relative dates, you will need to modify the JRXML: change theparameter class, and, if needed, set a default value expression. In addition, remember to use the $X{} functioninstead of $P{}.104