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.

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

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. 

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, but please reach out to us at support@almworks.com if you need assistance.

Basic Structure

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

{
  "week": ...,
  "exceptions": ...
}
CODE

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
        }
      ]
}
CODE

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": []}
CODE

Exceptions

Exceptions are defined for exact dates:

"exceptions": [
      {
        "date": 20210301,
        "workPeriods": []
      },
      {
        "date": 20210305,
        "workPeriods": [
       {
         "start": 900,
         "finish": 1300
       },
       {
         "start": 1400,
         "finish": 1715
       }]
      }
]
CODE

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

In this case, existing calendar-week schedule values are overridden (i.e. 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.

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": [] }
] }
CODE


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": [] }
] }
CODE


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": [] }
] }
CODE


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": [] }
] }
CODE