Skip to main content
Skip table of contents

Calendars

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. 

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

Editing the times in Gantt does not change the workload scheme in 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.

Need help or have questions? Contact Tempo Support.

Basic Structure

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

CODE
{
  "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):

CODE
{
  "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: 

CODE
{"monday": []}

Exceptions

Exceptions are defined for exact dates:

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

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

CODE
{
    "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

CODE
{
    "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
{
    "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

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



JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.