Date object property | Type | Description | Sample value |
|---|---|---|---|
formatDateTime | String | the date and time in Jira format used when display dates | 11/sep/16 1:15 PM |
formatDateTimePicker | String | the date and time in Jira format used in date picker | 11.09.2016 13:15 |
formatDate | String | the date in Jira Jira format used when display dates | 11/sep/16 |
formatDatePicker | String | the date in Jira format used in date picker | 11.09.2016 |
formatDateISO | String | the date in ISO 8601 'YYYY-MM-DD' format | 2016-09-11 |
formatTime | String | the time in Jira format used when display dates | 1:15 PM |
formatRelative | String | the date and time relative to now | Tomorrow |
day | Number | day as number | 3 |
dayLong | String | day in 'DD' format | 03 |
dayName | String | full day name | Monday |
dayAbbr | String | short day name | Mon |
week | Number | week number in year | 36 |
month | Number | month as number | 7 |
monthLong | String | month in 'MM' format | 07 |
monthName | String | full month name | December |
monthAbbr | String | short month name | Dec |
year | Number | year number | 2016 |
Operations on date object
On date object user can do math operations and modify final date value. For example user can add minutes, hours, days, weeks, months or set hour/minutes to exact value. See available operation below:
Date object methods | Description | Sample usage |
|---|---|---|
MODIFYING METHODS | ||
withMinutes(<integerValue>) | modifies the date by setting specified number of minutes. Integer value must be in the range [0,59] | $repeating.date.withMinutes(0) |
withHours(<integerValue>) | modifies the date by setting specified number of hours. Integer value must be in the range [0,23] | $repeating.date.withHours(12) |
withDay(<integerValue>) | modifies the date by setting specified day of month. Integer value must be in the range [1,31] | $repeating.date.withDay(20) |
withMonth(<integerValue>) | modifies the date by setting specified month of year. Integer value must be in the range [1,12] | $repeating.date.withMonth(10) |
withYear(<integerValue>) | modifies the date by setting specified year. | $repeating.date.withYear(2024) |
addMinutes(<integerValue>) | modifies the date by adding specified number of minutes | $repeating.date.addMinutes(15) |
addMinutesStrict(<integerValue>) | modifies the date by adding specified number of minutes with respecting non-working days | $repeating.date.addMinutesStrict(15) |
addHours(<integerValue>) | modifies the date by adding specified number of hours | $repeating.date.addHours(2) |
addHoursStrict(<integerValue>) | modifies the date by adding specified number of hours with respecting non-working days | $repeating.date.addHoursStrict(2) |
addDays(<integerValue>) | modifies the date by adding specified number of days | $repeating.date.addDays(2) |
addDaysStrict(<integerValue>) | modifies the date by adding specified number of days with respecting non-working days | $repeating.date.addDaysStrict(2) |
addWeeks(<integerValue>) | modifies the date by adding specified number of weeks | $repeating.date.addWeeks(1) |
addWeeksStrict(<integerValue>) | modifies the date by adding specified number of weeks with respecting non-working days | $repeating.date.addWeeksStrict(1) |
addMonths(<integerValue>) | modifies the date by adding specified number of months | $repeating.date.addMonths(15) |
addMonthsStrict(<integerValue>) | modifies the date by adding specified number of months with respecting non-working days | $repeating.date.addMonthsStrict(15) |
addYears(<integerValue>) | modifies the date by adding specified number of years | $repeating.date.addYears(1) |
addYearsStrict(<integerValue>) | modifies the date by adding specified number of years with respecting non-working days | $repeating.date.addYearsStrict(1) |
COMPARISON METHODS | ||
isBefore(<dateObject | dateString>) | check if the date is before given date Parameter can be other date object or date / date time in ISO format YYYY-MM-DD'T'hh:mm:ss | $repeating.date.isBefore($sourceIssue.dueDate) |
isAfter(<dateObject | dateString>) | check if the date is after given date Parameter can be other date object or date / date time in ISO format YYYY-MM-DD'T'hh:mm:ss | $repeating.date.isAfter('2018-09-13T13:30:00') |
isEqual(<dateObject | dateString>) | check if the date is equal to given date Parameter can be other date object or date / date time in ISO format YYYY-MM-DD'T'hh:mm:ss | $repeating.date.isEqual('2018-09-13') |
DISPLAY METHODS | ||
format(<formatInString>) | print the date and time in the given Joda DateTImeFormat | $repeating.date.format("yyyy-dd-MM"') |
Differences between strict and non-strict date modifications
Below is quick and simple comparison how strict mode with respecting non-working days differ from simple date modifications.
Repeating date is: 19/Sep/18 2:45 PM
Non-working days are: 20/Sep/18 and 21/Sep/18
$repeating.date.addDays(5) vs $repeating.date.addDaysStrict(5) 24/Sep/18 2:45 PM vs 26/Sep/18 2:45 PM $repeating.date.addMinutes(25) vs $repeating.date.addMinutesStrict(25) 19/Sep/18 3:10 PM vs 19/Sep/18 3:10 PM $repeating.date.addMinutes(4335) vs $repeating.date.addMinutesStrict(4335) (4335 minutes is equal to 3 days 15 minutes) 22/Sep/18 3:00 PM vs 24/Sep/18 3:00 PM $repeating.date.addHours(10) vs $repeating.date.addHoursStrict(10) 20/Sep/18 12:45 AM vs 22/Sep/18 12:45 AM $repeating.date.addHours(76) vs $repeating.date.addHoursStrict(76) (76 hours is equal to 3 days 4 hours) 22/Sep/18 6:45 PM vs 24/Sep/18 6:45 PM $repeating.date.addHours(82) vs $repeating.date.addHoursStrict(82) (82 hours is equal to 3 days 10 hours) 23/Sep/18 12:45 AM vs 25/Sep/18 12:45 AM $repeating.date.addMonths(2) vs $repeating.date.addMonthsStrict(2) 19/Nov/18 1:45 PM vs 21/Nov/18 1:45 PM $repeating.date.addYears(1) vs $repeating.date.addYearsStrict(1) 19/Sep/19 2:45 PM vs 21/Sep/19 2:45 PM
Sample date comparisons in velocity templates
Velocity expression | Sample value |
|---|---|
$repeating.date.isAfter('2018-09-13T13:30:00') | true |
$repeating.date.isEqual('2018-09-13') | true |
$repeating.date.isAfter($sourceIssue.dueDate) | false |
$sourceIssue.updatedDate.month < 8 | false |
#if($repeating.date.month > 4)Some value#{else}other value#end | Some value |