How to Configure Holidays in Time Tracker

Holidays are displayed with a different color in Time Tracker calendar. They are also used in quota calculations when Monthly Quotas plugin is enabled to automatically calculate quotas based on the number of working days in a given month.

In Time Tracker 1.19.4.4996 and above holidays are configurable on the Group tab in the Holidays control. The setting is per group. If you use subgroups then each subgroup has its own holidays, which makes sense when you use international subgroups with different public holidays in each country.

The example above defines two holidays: January 1 and December 25 applicable in all years.

Holidays Specification

Holidays specification is a comma-separated list of holiday dates in format YYYY-MM-DD. A wild-card * can be used in any position of the year field to represent any digit. For example:

****-01-01,****-12-31,2019-04-20

The above means Jan 1 and Dec 31 are holidays in all years, while April 20 is only a holiday in 2019.

Holidays in Time Tracker below 1.19.4.4996

In prior versions, holidays were defined in localization files in $i18n_holidays array. They were not configurable by groups and required a system administrator to change a resource file. For example, for English language a change in the $i18n_holidays value in ./WEB_INF/resources/en.lang.php file was necessary. Below is a description of how it worked.

// format mm/dd
$i18n_holidays = array('01/01', '01/16', '02/20', '05/28', '07/04', '09/03', '10/10', '11/11', '11/24', '12/25');

Holidays is an array of day values represented as 2-digit month, a forward slash, and a 2-digit day. Suppose we wanted to introduce another holiday on December 26. For that, add 12/26 to $i18n_holidays array:

$i18n_holidays = array('01/01', '01/16', '02/20', '05/28', '07/04', '09/03', '10/10', '11/11', '11/24', '12/25', '12/26');

As a result, calendar now shows another holiday in December.

The $i18n_holidays array needs an adjustment as holidays change year after year. This works when you control Time Tracker installation and can change the files. If you don't, you can either enable or disable the Show holidays for your group (on the Group tab).

Time Tracker FAQ