Продолжительность представлена в виде количества миллисекунд. Чтобы создать значение или понять значение, вам понадобится одна из следующих функций для преобразования строки в длительность и наоборот.
Вы можете добавить продолжительность к дате или значению даты/времени и обработать результат как новую дату/время, но только если это продолжительность календаря. Это не работает с продолжительностью работы.
Чтобы понять почему, давайте представим, что вы хотели добавить 16 часов к дате или дате/времени. Результат должен быть чуть меньше, чем через сутки. Однако при использовании продолжительности работы добавление 16 часов приведет к дате как минимум на 2 дня позже (может быть, больше, если она пересекает выходные), исходя из 8-часовой пятидневной рабочей недели Jira по умолчанию.
CALENDAR_DAYS
CALENDAR_DAYS(Duration)
Возвращает количество календарных дней, представленное значением продолжительности в виде десятичного числа.
|
Параметр |
Тип |
Описание |
|
Duration |
Текст/Каждый |
Значение выражено в формате Jira Duration (1д 3ч 30мин). |
|
→ Result |
Число |
Количество календарных дней. Может возвращать дробное число дней. |
Примеры:
- CALENDAR_DAYS(DURATION("10d")) → 10
- CALENDAR_DAYS(DURATION("12h")) → 0.5
CALENDAR_HOURS
CALENDAR_HOURS(Duration)
Возвращает количество часов, представленное значением продолжительности в виде десятичного числа.
|
Параметр |
Тип |
Описание |
|
Duration |
Текст/Каждый |
Значение выражено в формате Jira Duration (1д 3ч 30мин). |
|
→ Result |
Число |
Количество часов. Может возвращать дробное число часов. |
Примеры:
- CALENDAR_HOURS(DURATION("10d")) → 240
- CALENDAR_HOURS(DURATION("12h 45m")) → 12.75
CALENDAR_MINUTES
CALENDAR_MINUTES(Duration)
Возвращает количество минут, представленное значением длительности в виде десятичного числа.
|
Параметр |
Тип |
Описание |
|
Duration |
Текст/Каждый |
Значение выражено в формате Jira Duration (1д 3ч 30мин). |
|
→ Result |
Число |
Количество минут. Может возвращать дробное число минут. |
Пример:
- CALENDAR_MINUTES(DURATION("3h")) → 180
CALENDAR_SECONDS
CALENDAR_SECONDS(Duration)
Возвращает количество секунд, представленное значением длительности в виде десятичного числа.
|
Параметр |
Тип |
Описание |
|
Duration |
Текст/Каждый |
Значение выражено в формате Jira Duration (1д 3ч 30мин). |
|
→ Result |
Число |
Количество календарных секунд. Может возвращать дробное число секунд. |
Пример:
- CALENDAR_SECONDS(DURATION("1h")) → 3600
CALENDAR_DURATION
CALENDAR_DURATION(Start, Finish, Calendar)
Возвращает время, прошедшее между началом и окончанием в соответствии с выбранным календарем. Имейте в виду, что календари, предоставляемые Structure, не зависят от часового пояса пользователя (используется системный часовой пояс), но некоторые функции (например, DATETIME) зависят. Другие календари могут зависеть или не зависеть от часового пояса пользователя в зависимости от реализации.
|
Параметр |
Тип |
Описание |
|
Start |
Дата |
Дата или значение даты/времени для начала отсчета календарного времени. |
|
Finish |
Дата |
Дата или значение даты/времени для завершения подсчета календарного времени. |
|
Calendar (По желанию) |
Текст
|
Название календаря в текущей локали пользователя. Если этот параметр опущен, используется календарь по умолчанию (24/7), и результат будет равен (Готово — Начало). |
|
→ Result |
Число
|
Продолжительность в миллисекундах. |
Пример:
CALENDAR_DURATION(DATE("18/Jul/2022"), DATE("19/Jul/2022"), "Стандартный рабочий календарь 8/5") → 28800000 (8h in milliseconds)
DURATION
DURATION(Text)
Преобразует текстовое представление длительности календаря в число.
Эта функция игнорирует настройки рабочего времени Jira, поэтому DURATION("1w") = DURATION("7d") and DURATION("1d") = DURATION("24h").Чтобы учитывать рабочее время, используйте JIRA_DURATION.
|
Параметр |
Тип |
Описание |
|
Duration |
Число/Каждый
|
Значение выражено в формате Jira Duration (1д 3ч 30мин). |
|
→ Result |
Число
|
Продолжительность в миллисекундах. |
Примеры:
- DURATION("1w 2d 3h 4m")
- DURATION("3d")
FORMAT_DURATION
FORMAT_DURATION(Duration)
Преобразует значение длительности в формат Jira с числами, за которыми следуют символы, определяющие единицу времени.
|
Параметр |
Тип |
Описание |
|
Duration |
Число/Каждый
|
Значение продолжительности в числовом формате. |
|
→ Result |
Число
|
Значение продолжительности преобразовано в формат Jira Duration (1д 3ч 30мин). |
Пример:
- FORMAT_DURATION(DURATION("1w 1d")) → "1w 1d"
JIRA_DAYS
JIRA_DAYS(Duration)
Возвращает количество рабочих дней указанной продолжительности в соответствии с настройками Jira.
|
Параметр |
Тип |
Описание |
|
Duration |
Текст/Каждый
|
Значение выражено в формате Jira Duration (1д 3ч 30мин). |
|
→ Result |
Число
|
Количество рабочих дней. (По умолчанию один день равен 8 часам.) Может возвращать дробное число. |
Пример:
- JIRA_DAYS(DURATION("24h")) → 3
- JIRA_DAYS(DURATION("12h")) → 1.5
JIRA_DURATION
JIRA_DURATION(Text)
Преобразует текстовое представление продолжительности работы Jira в число.
Указанное время является рабочим временем согласно настройкам Jira. С настройками Jira по умолчанию JIRA_DURATION("1w") = JIRA_DURATION("5d") and JIRA_DURATION("1d") = JIRA_DURATION("8h"). Чтобы использовать календарное время, используйте DURATION.
|
Параметр |
Тип |
Описание |
|
Duration |
Текст/Каждый
|
Значение выражено в формате Jira Duration (1д 3ч 30мин). |
|
→ Result |
Число
|
Продолжительность в миллисекундах. |
Примеры:
- JIRA_DURATION("1w 2d 3h 4m")
- JIRA_DURATION("3d")
JIRA_WEEKS
JIRA_WEEKS(Duration)
Возвращает количество рабочих недель указанной продолжительности в соответствии с настройками Jira.
|
Параметр |
Тип |
Описание |
|
Duration |
Текст/Каждый
|
Значение выражено в формате Jira Duration (1д 3ч 30мин). |
|
→ Result |
Число
|
Количество рабочих дней. (По умолчанию одна неделя составляет 5 рабочих дней.) Может возвращать дробное число. |
Пример:
JIRA_WEEKS(JIRA_DURATION("10d")) → 2
JIRA_WEEKS(DURATION("5d")) → 3
По материалам Atlassian JIRA Structure: Duration Functions