This page last changed on Jun 29, 2009 by rosie@atlassian.com.

FishEye supports a wide variety of date expressions. A date has the two possible general forms:

  • DATE[]TIMEZONE[]DURATION, or
  • DATECONSTANT[+-]DURATION.

The TIMEZONE and DURATION parts are both optional.

TIMEZONE can be an offset from GMT HHMM or HH:MM, or simply the letter Z to denote GMT. If no timezone is given, the FishEye server's configured timezone is used.

DATE can be either of the following:

YYYY-MM-DDThh:mm:ss Specifies a time and date (separated by a T). The seconds part may contain a fractional component. A / can be used instead of - as a separator.
YYYY-MM-DD Specifies 00:00:00 on the given date. A / can be used instead of - as a separator.

DATECONSTANT can be any of:

now This very instant (at the time the expression was evaluated).
today
todaygmt
The instant at 00:00:00 today. (server-time* or GMT)
thisweek
thisweekgmt
The instant at 00:00:00 on the first day of this week. Sunday is considered the first day. (server-time* or GMT)
thismonth
thismonthgmt
The instant at 00:00:00 on the first day of this month. (server-time* or GMT)
thisyear
thisyeargmt
The instant at 00:00:00 on the first day of this year. (server-time* or GMT)

* The timezone used for server-time is part of the FishEye configuration

The syntax for DURATION is similar to the XML Schema duration type. It has the general form PnYnMnDTnHnMnS. See Section 3.2.6 of the XML Schema Datatypes document for more details.

Examples

2005-01-02 The start of the day on January 1, 2005 (server's timezone)
2005-01-02-0500 The start of the day on January 1, 2005 at GMT offset -0500 (New York)
2005-01-02T12:00:00Z Midday, January 1, 2005 GMT
today-P1D Yesterday (start of day)
today+P1D Start of tomorrow
thismonth-P1M Start of last month
thisyear+P1Y Start of next year
now-PT1H One hour ago
now+PT1H2M3S One hour, two minutes and three seconds from now
Document generated by Confluence on Jul 06, 2009 21:40