Skip to main content

Create a work calendar

Create a work calendar so that time-based fields count only your team's working hours, without breaks and holidays.

Before you begin​

  • Jira permission: Jira admin (Administer Jira global permission).

  • FieldCraft: installed, with an active license.

  • Your site has fewer than 10 work calendars. At the limit, FieldCraft shows New Calendar could not be created because the maximum number has been reached.

Name the calendar​

  1. Go to Settings (βš™) > Marketplace apps > FieldCraft: Custom Fields, and select the Settings tab.

  2. Select Work calendars. The list of calendars opens.

  3. Select Create work calendar. An empty calendar form opens.

  4. In Name, enter a name your fields will show, for example Office hours Berlin.

  5. In Time zone, select the zone the working hours are in.

    The work calendar form for 8/5, Mon-Fri, 09:00 - 17:00 with its name, time zone, working hours from 09:00 to 17:00 on weekdays and Add break buttons

Set the working time​

  1. For each working day, set from: and to: times. Leave both empty for a day off.

  2. To add a break, select Add break on that day. It starts as 12:00 to 13:00. Change the times if you need to.

  3. Under Holidays (N), pick a date in Holiday to add, and select Add. Repeat for each holiday.

    The end of the work calendar form: 40h of working hours per week and the Holidays date picker with its Add button

  4. Check Total working hours per week, and select Save.

Result: You see Work calendar saved. Back to list shows it with your other calendars.

You can now select it as the work calendar of a Time in Status, Time Between or Countdown field.

Start from a template​

Next to Create work calendar, open the menu and select a template:

  • Create "24/7, Mon-Sun, 00:00 - 00:00" calendar

  • Create "8/5, Mon-Fri, 09:00 - 17:00" calendar

You see Created and the calendar's name. The templates use the Berlin time zone, so edit the calendar if your team works elsewhere.

If the calendar doesn't save​

FieldCraft marks each field to fix and shows Fix the marked fields to save.

MessageWhat to do
Give the calendar a name.Enter a name
Choose the time zone its working hours are in.Select a time zone
Set both times, or clear both for a day off.Fill in the missing time, or clear both
Ends before it starts. …For a night shift, use 00:00 to 00:00 with a break from the shift's end to its start
A break needs both times. Remove it if it isn't needed.Fill in the break, or select Remove

A day with the same start and end time saves as 0 hours. For the whole day, use 00:00 to 00:00.

A calendar with no working hours on any day still saves, with the warning Work calendar saved without working hours. Every field that uses it counts 0 until you add working hours to at least one day, and those fields' configuration pages say so under the calendar picker.