Items are scheduled within the Gantt chart based on the work schedule outlined in the Calendar. You can select or customize the calendar to be used from the General Configuration screen.
Gantt comes with two predefined calendars: "Standard" (40-hour work week, 9:00-17:00 every workday) and "24 Hour" (all time marked as working time). Jira administrators can edit the available calendars or create additional calendars by clicking Manage Work Calendars.
Default Calendar
Select which calendar will be selected by default when new charts are created. Unless you change this setting, the Standard calendar will be used.
Tempo Workload Schemes
If you've connected Structure and Planner by Tempo, any workload schemes created in Planner will be available to use as calendars in Gantt.
Adjusting Start Times
By default, calendars based on workload schemes use a 9:00 am start time each day. You can adjust the start times by clicking Edit in the Actions column.
If you enter a start time that is too late in the day to complete the number of working hours specified in the workload scheme, you will receive an error. If you save the calendar with existing errors, the start time for that day will be set to 12:00 am.
Creating and Editing Calendars
Calendar format
A calendar is defined by a code in JSON format, which sets the working periods for each day of the week and lists exceptions. Details about the JSON format are provided below.
Basic Structure
Every calendar consists either of a week schedule or list of exceptions, or both:
{
"week": ...,
"exceptions": ...
}
All calendar definitions should be wrapped in curly braces: { }
Week schedule
Week schedule is defined by specifying work ranges for every weekday (monday, tuesday, wednesday, thursday, friday, saturday, sunday):
{
"week": {
"monday": [
{
"start": 900,
"finish": 1300
},
{
"start": 1400,
"finish": 1715
}
],
"tuesday": [
{
"start": 900,
"finish": 1300
},
{
"start": 1400,
"finish": 1715
}
]
}}
Time is written using HHMM format, where HH is hour (0-24) and MM is minutes, for example: `1730` for 17:30 (5:30 pm) and `930` for 9:30.
You may skip a weekday either by skipping its definition completely or providing an empty list of ranges:
{"monday": []}
Exceptions
Exceptions are defined for exact dates:
"exceptions": [
{
"date": 20210301,
"workPeriods": []
},
{
"date": 20210305,
"workPeriods": [
{
"start": 900,
"finish": 1300
},
{
"start": 1400,
"finish": 1715
}]
}
]
Dates are written using YYYYMMDD format, where YYYY is a 4-digit year, MM is a month (1-12) and DD is a day (0-31).
The workPeriods parameter can be empty, which means it is a day off, or can contain custom start and finish times, which will override the times you have defined in the main scheme.
Hierarchy
You can also organize calendars into a hierarchy via the "Based on" property, so you can create more specific calendars, based on a general calendar ("Standard", for example).
Deleting Calendars
Deleting a calendar cannot be undone! Please be careful when doing so, as it could impact other Gantt charts that are assigned to that calendar.
Example Calendars
Here are some of our most popular calendar examples.
US 10 Federal Holidays Calendar
5-day work week, 8 hours per day, valid until 2025
{
"week": {
"monday": [{
"start": 900,
"finish": 1700
}],
"tuesday": [{
"start": 900,
"finish": 1700
}],
"wednesday": [{
"start": 900,
"finish": 1700
}],
"thursday": [{
"start": 900,
"finish": 1700
}],
"friday": [{
"start": 900,
"finish": 1700
}]
},
"exceptions": [ {
"date": 20210101, "workPeriods": [] }, {
"date": 20220101, "workPeriods": [] }, {
"date": 20230101, "workPeriods": [] }, {
"date": 20240101, "workPeriods": [] }, {
"date": 20250101, "workPeriods": [] }, {
"date": 20210118, "workPeriods": [] }, {
"date": 20220117, "workPeriods": [] }, {
"date": 20230116, "workPeriods": [] }, {
"date": 20240115, "workPeriods": [] }, {
"date": 20250120, "workPeriods": [] }, {
"date": 20210215, "workPeriods": [] }, {
"date": 20220221, "workPeriods": [] }, {
"date": 20230220, "workPeriods": [] }, {
"date": 20240219, "workPeriods": [] }, {
"date": 20250217, "workPeriods": [] }, {
"date": 20210402, "workPeriods": [] }, {
"date": 20220415, "workPeriods": [] }, {
"date": 20230407, "workPeriods": [] }, {
"date": 20240329, "workPeriods": [] }, {
"date": 20250418, "workPeriods": [] }, {
"date": 20210531, "workPeriods": [] }, {
"date": 20220530, "workPeriods": [] }, {
"date": 20230529, "workPeriods": [] }, {
"date": 20240527, "workPeriods": [] }, {
"date": 20250526, "workPeriods": [] }, {
"date": 20240704, "workPeriods": [] }, {
"date": 20250704, "workPeriods": [] }, {
"date": 20230704, "workPeriods": [] }, {
"date": 20220704, "workPeriods": [] }, {
"date": 20210705, "workPeriods": [] }, {
"date": 20210906, "workPeriods": [] }, {
"date": 20220905, "workPeriods": [] }, {
"date": 20230904, "workPeriods": [] }, {
"date": 20240902, "workPeriods": [] }, {
"date": 20250901, "workPeriods": [] }, {
"date": 20211125, "workPeriods": [] }, {
"date": 20221124, "workPeriods": [] }, {
"date": 20231123, "workPeriods": [] }, {
"date": 20241128, "workPeriods": [] }, {
"date": 20251127, "workPeriods": [] }, {
"date": 20211224, "workPeriods": [] }, {
"date": 20221226, "workPeriods": [] }, {
"date": 20231225, "workPeriods": [] }, {
"date": 20241225, "workPeriods": [] }, {
"date": 20251225, "workPeriods": [] }
] }
UK (England and Wales) Holiday Calendar
5-day work week, 8 hours per day, bank holidays for 2023
{
"week": {
"monday": [{
"start": 900,
"finish": 1700
}],
"tuesday": [{
"start": 900,
"finish": 1700
}],
"wednesday": [{
"start": 900,
"finish": 1700
}],
"thursday": [{
"start": 900,
"finish": 1700
}],
"friday": [{
"start": 900,
"finish": 1700
}]
},
"exceptions": [ {
"date": 20230102, "workPeriods": [] }, {
"date": 20230407, "workPeriods": [] }, {
"date": 20230410, "workPeriods": [] }, {
"date": 20230501, "workPeriods": [] }, {
"date": 20230508, "workPeriods": [] }, {
"date": 20230529, "workPeriods": [] }, {
"date": 20230828, "workPeriods": [] }, {
"date": 20231225, "workPeriods": [] }, {
"date": 20231226, "workPeriods": [] }
] }
Germany Holiday Calendar
5-day work week, 8 hours per day, national holidays for 2023
{
"week": {
"monday": [{
"start": 900,
"finish": 1700
}],
"tuesday": [{
"start": 900,
"finish": 1700
}],
"wednesday": [{
"start": 900,
"finish": 1700
}],
"thursday": [{
"start": 900,
"finish": 1700
}],
"friday": [{
"start": 900,
"finish": 1700
}]
},
"exceptions": [ {
"date": 20230101, "workPeriods": [] }, {
"date": 20230407, "workPeriods": [] }, {
"date": 20230410, "workPeriods": [] }, {
"date": 20230501, "workPeriods": [] }, {
"date": 20230518, "workPeriods": [] }, {
"date": 20230529, "workPeriods": [] }, {
"date": 20231003, "workPeriods": [] }, {
"date": 20231225, "workPeriods": [] }, {
"date": 20231226, "workPeriods": [] }
] }
Israel Holiday Calendar
5-day work week, 8 hours per day, public holidays for 2023
{
"week": {
"sunday": [{
"start": 900,
"finish": 1700
}],
"monday": [{
"start": 900,
"finish": 1700
}],
"tuesday": [{
"start": 900,
"finish": 1700
}],
"wednesday": [{
"start": 900,
"finish": 1700
}],
"thursday": [{
"start": 900,
"finish": 1700
}]
},
"exceptions": [ {
"date": 20230406, "workPeriods": [] }, {
"date": 20230412, "workPeriods": [] }, {
"date": 20230426, "workPeriods": [] }, {
"date": 20230526, "workPeriods": [] }, {
"date": 20230925, "workPeriods": [] }, {
"date": 20230930, "workPeriods": [] }, {
"date": 20231007, "workPeriods": [] }
] }