Если у вас есть правила, которые были созданы на сервере до ноября 2018 года (сервер 4.1.5), то это для вас. Если вы используете облако, это неприменимо, и вместо того, чтобы читать это, вы можете пойти и насладиться чашкой чая и шоколадом.

Функции и атрибуты даты находятся в разделе справки по датам.

Предупреждение

Хотя следующий синтаксис продолжает работать, настоятельно рекомендуется использовать новый синтаксис дат. Он не только проще в использовании, но и более мощный, и в нем исправлено множество ошибок.

Автоматизация для Jira позволяет вам управлять датами и форматировать их внутри полей, которые поддерживают интеллектуальные значения, created, updated, duedate, resolutiondate, а также пользовательские поля Date Picker, например {{issue.MyDateFieldName}} или {{issue.customfield_12356}}.

Форматирование дат

Вы можете указать формат даты двумя способами:

Указание формата

// Для форматирования значения поля даты

{{# issue.resolutiondate}} longDateTime {{/}}

{{# issue.MyDateFieldName}} longDateTime {{/}}

// Если другие поля не указаны, вы можете включить формат

{{#now}} longDateTime {{/}}

 // Когда вы указываете часовой пояс или функцию для управления нужной датой

// чтобы явно обозначить формат и заключить значение в двойные кавычки.

{{#now}} format = “longDateTime”, зона = Australia/Sydney {{/}}

Есть несколько встроенных форматов, или вы можете указать свой собственный:

Формат

Четверг, 1 ноября 1979 г., 6:23:12 EST

Заметки

По умолчанию (не указано)

Nov 1, 1979 6:23:12 AM

Если формат не указан, по умолчанию используется mediumDateTime. Это может не работать, если используется как ввод для некоторых полей.

toMillis

310303392034

Сколько миллисекунд прошло с эпохи

toSeconds

310303392

Сколько секунд прошло с эпохи

toMinutes

5171723

Сколько минут прошло с эпохи

toHours

86195

Сколько часов прошло с эпохи

toDays

3591

Сколько дней прошло с эпохи

 

Часовой пояс

По умолчанию даты для часового пояса отображаются как «UTC». Это часовой пояс серверов Jira для OnDemand / Cloud и часовой пояс по умолчанию, используемый при назначении запланированных триггеров.

Чтобы указать другой часовой пояс, вам нужно добавить параметр:

// Выводит время в Сиднее, когда задача была создана.

{{# issue.created}} зона = Австралия / Сидней {{/}}

Часовые пояса доступны в документации Joda.

Укажите часовой пояс пользователя:

// Печатает время в часовом поясе репортеров.

{{# issue.created}} зона = {{reporter.timeZone}} {{/}}

Язык (локаль)

По умолчанию даты указаны на английском языке. Чтобы указать другой языковой стандарт, укажите параметр:

// Выводит время в Сиднее, когда проблема была создана.

{{# issue.created}} locale = ru_RU {{/}}

Доступные языковые стандарты доступны в документации Java.

Управление датами

Управляйте датами, устанавливая определенные части даты или добавляя / вычитая из нее значения:

// Добавляет 7 дней к текущему времени

{{#now}} func = plusDays (7) {{/ now}}

// Вы можете связать функции.

// Устанавливает день на первое ноября

{{# issue.created}} func = withDayOfMonth (1) .withMonthOfYear (11) {{/}}

Расчет рабочих дней

Для работы с рабочими днями встроены два набора функций – вы можете либо плюс / минус рабочие дни с текущей даты, либо найти ближайший рабочий день к текущей дате.

// На следующий рабочий день

{{#now}} func = toBusinessDay () {{/}}

// На следующий рабочий день через 3 дня

{{#now}} func = plusDays (3) .toBusinessDay () {{/}}

// Предыдущий рабочий день

{{#now}} func = toBusinessDayBackwards () {{/}}

// Добавляет 6 рабочих дней к сегодняшнему дню

{{#now}} func = plusBusinessDays (6) {{/}}

// Количество рабочих дней между моментом создания задачи и сегодняшним днем

{{#now}} func = businessDaysBetween ({{issue.created}}), format = “toDays” {{/}}

Расчет разницы между двумя датами

Используйте формат «toSecond» и функцию «minusSeconds», чтобы вычесть одну дату из другой. Затем используйте один из форматов, который показывает, сколько секунд, минут, часов или дней. Также существует сокращенный метод daysBetween с более простым синтаксисом.

// Количество часов с момента создания проблемы

{{#now}} func = minusSeconds ({{# issue.created}} toSeconds {{/}}), format = “toHours” {{/}}

// Количество дней между двумя датами

{{#now}} func = daysBetween ({{issue.created}}), format = “toDays” {{/}}

Примеры

// 1 мая этого года

{{#now}} func = withDayOfMonth (1) .withMonthOfYear (5) {{/}}

 

// 1 мая следующего года

{{#now}} func = withDayOfMonth (1) .withMonthOfYear (5) .plusYears (1) {{/}}

// Последний день мая

{{#now}} func = withDayOfMonth (1) .withMonthOfYear (6) .minusDays (1) {{/}}

// Первый рабочий день мая

{{#now}} func = withDayOfMonth (1) .withMonthOfYear (5) .toBusinessDay () {{/}}

// Последний рабочий день мая

{{#now}} func = withDayOfMonth (1) .withMonthOfYear (6) .minusDays (1)

.toBusinessDayBackwards () {{/}}

По материалам Automation for Jira – Server: Archived date functions

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *