Structure.Gantt allows you to define different calendars for the following:
Default resource calendar
Individual resource calendar
This is especially useful when you need more precise planning for resources working on different schedules.
...
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 | ||||
|---|---|---|---|---|
|
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):
...
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. the definition for "wednesday" in a child calendar will override the "wednesday" schedule of its parent calendar). |
Time zones
Calendars don't have time zone information and should be written in your local time. Time zones are provided separately and are taken either from the current user profile TZ (for the Gantt chart, configured at the User Profile page) or from default or individual resource settings:
...
Deleting Calendars
Calendars can be deleted (even the ones that are used by other calendars as Based On or by Gantt charts). Gantt will continue to work properly, even if a specified calendar cannot be found: a hard-coded calendar definition, similar to a default version of "Standard" calendar, will be used. However, this is not normal and should be fixed.
...
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": [] },
{
"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": [] }
] } |
...
] } |
UK (England and Wales) Holiday Calendar
5-day work week, 8 hours per day, national bank holidays for 20232025
| 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": 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": [] }
] } |
...