Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Items are scheduled within the Gantt chart based on the work schedule outlined in the Calendar. You can select or customize the calendar

...

by clicking the Settings button in the toolbar. The Calendar setting is on the General Configuration screen.Image Removed

...

Gantt comes with two predefined calendars: "Standard" (40-hour work week, 9:00-17:00 every workday) and "24 Hour" (all time is marked as working time). Jira administrators can edit the available calendars or create additional calendars by clicking selecting Manage Work Calendars.

...

Default Calendar

Select Choose which calendar will be selected by default when new charts are created. Unless you change this setting, the Standard calendar will be used. 

...

If you've connected Structure and Capacity Planner by Tempo, any workload schemes created in Planner will be available to use as calendars in Gantt.

...

Note

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.

Info
Editing

If you’re using Planner mode, editing the times in Gantt does not change the workload scheme in Capacity Planner.

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.

Include Page
IN:_Incl-text-support-ganttcloud
IN:_Incl-text-support-ganttcloud

Basic Structure

Every calendar consists either of a week schedule or list of exceptions, or both:

Code Block
{
  "week": ...,
  "exceptions": ...
}
Note

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):

...

Time is written using HHMM format, where HH is hour (0-24), and MM is minutes, for . For example: `1730` for 17:30 (5:30 pm) and `930` for 9:30.

...

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 it can contain custom start and finish times, which will override the times you have defined in the main scheme.

...

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).

Info

In this case, existing calendar-week schedule values are overridden

(i.e.

: for example, the definition for "wednesday" in a child calendar will override the "wednesday" schedule of its parent calendar

)

.

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.

...

Here are some of our most popular calendar examples.

US

...

Federal Holidays Calendar

5-day work week, 8 hours per day, valid until federal holidays for 2025

Code Block
{
    "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": 2021010120250101, "workPeriods": [] }, {
    "date": 2022010120250120, "workPeriods": [] }, {
    "date": 2023010120250217, "workPeriods": [] }, {
    "date": 2024010120250526, "workPeriods": [] }, {
    "date": 2025010120250619, "workPeriods": [] }, {
    "date": 2021011820250704, "workPeriods": [] }, {
    "date": 2022011720250901, "workPeriods": [] }, {
    "date": 2023011620251013, "workPeriods": [] }, {
    "date": 2024011520251111, "workPeriods": [] }, {
    "date": 2025012020251127, "workPeriods": [] }, {
    "date": 2021021520251225, "workPeriods": [] }, 
] }

UK (England and Wales) Holiday Calendar

5-day work week, 8 hours per day, bank holidays for 2025

Code Block
{
    "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

Code Block
{
    "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

Code Block
week": {
    "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": 2023040720250101, "workPeriods": [] }, {
    "date": 2023041020250418, "workPeriods": [] }, {
    "date": 2023050120250421, "workPeriods": [] }, {
    "date": 2023051820250505, "workPeriods": [] }, {
    "date": 2023052920250526, "workPeriods": [] }, {
    	"date": 2023100320250825, "workPeriods": [] }, {
    "date": 2023122520251225, "workPeriods": [] }, {
    "date": 20231226, "workPeriods": [] }
] }

...

Germany Holiday Calendar

5-day work week, 8 hours per day, public national holidays for 20232025

Code Block
{
    "week": {
        "sundaymonday": [{
            "start": 900,
            "finish": 1700
        }],
        "mondaytuesday": [{
            "start": 900,
            "finish": 1700
        }],
        "tuesdaywednesday": [{
            "start": 900,
            "finish": 1700
        }],
        "wednesdaythursday": [{
            "start": 900,
            "finish": 1700
        }],
        "thursdayfriday": [{
            "start": 900,
            "finish": 1700
        }]
     },
 
"finishexceptions": 1700[ {
    "date": 20250101, "workPeriods": }[] }, {
   }, "date": 20250418, "exceptionsworkPeriods": [] }, {
    "date": 2023040620250421, "workPeriods": [] }, {
    "date": 2023041220250501, "workPeriods": [] }, {
    "date": 2023042620250529, "workPeriods": [] }, {
    "date": 2023052620250609, "workPeriods": [] }, {
    	"date": 2023092520251003, "workPeriods": [] }, {
    "date": 2023093020251225, "workPeriods": [] }, {
	    "date": 2023100720251226, "workPeriods": [] }
] }

...