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
...
Date object methods | Description | Sample usage | ||
---|---|---|---|---|
MODIFYING METHODS | ||||
withMinutes(<integerValue>) | modifies the date by setting specified number of minutes.
| $repeating.date.withMinutes(0) | ||
withHours(<integerValue>) | modifies the date by setting specified number of hours.
| $repeating.date.withHours(12) | ||
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
| $repeating.date.isEqal($sourceIssue.dueDate) | ||
isAfter(<dateObject | dateString>) | check if the date is after given date
| $repeating.date.isAfter('2018-09-13T13:30:00') | ||
isEqual(<dateObject | dateString>) | check if the date is equal to given date
| $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
...
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 |