Calendars let AODocs calculate dates in business days instead of calendar days. A calendar defines the working week of your organization – for example, Monday to Friday – and its non-working days, such as public holidays and company closures.
Calendars are defined at the tenant level, so you can create one calendar per country or business unit – for example, France, Germany, Saudi Arabia – and reuse them across libraries. Library administrators then assign a calendar to each library, and every business-day calculation in that library uses it.
Note: Only super administrators can create, edit, and delete calendars. The calendar feature is activated on demand by AODocs support (feature flag enableCalendar). If you don't see the Calendars section in your tenant administration, contact AODocs support.
This article explains how to:
Automatically generated table of contents
Create a calendar
1. Open the AODocs tenant administration.
2. Under Configuration, select Calendars in the left panel. The list of calendars opens, showing each calendar's name, description, and the years for which non-working days are defined.
3. Click Create calendar.
4. Enter a Calendar name – for example, Emirates business days – and, if required, a Description.
5. Click Create. The calendar editor opens.
Define the working days
In the Business days section of the calendar editor, select the days of the week that are usually worked in your organization.
By default, Monday to Friday are selected. You can adapt the pattern to any working week – for example, Sunday to Thursday.
Add non-working days
In the Non-working days section, define the dated exceptions to the weekly pattern: public holidays, company closures, and other days off. Use the Non-working days in year selector to view the non-working days of each year.
Click Add non-working days. In the Add non-working day dialog, you can add non-working days in three ways.
Import public holidays
1. Select the Public holiday tab.
2. Select a Country.
3. Select one or more Years (you can import up to 10 years ahead).
4. Click Add. The official public holidays of the selected country are added to the calendar for each selected year.
Add a single day
1. Select the Single day tab.
2. Enter a Day name – for example, a company closure day.
3. Pick the Date.
4. Click Add.
Add a date range
1. Select the Date range tab.
2. Enter a Date range name – for example, an end-of-year closure week.
3. Pick the Start and End dates. Each day in the range is added as a non-working day.
4. Click Add.
Understand the non-working day tags
Each non-working day appears in the list with its name, date, and a tag indicating its origin:
| Tag | Meaning |
| Public holiday | Imported from the official public holiday data of the selected country. |
| Custom | Added manually as a single day or a date range. |
| Movable date | The exact date may change – for example, holidays based on lunar observation. Check and update these dates once they're confirmed. |
Notes:
– A calendar can have only one entry per date. If you add a custom non-working day on a date that already has an imported public holiday, the custom entry replaces it.
– Imported public holidays are a snapshot: they aren't updated automatically. Re-import a year or edit the dates manually if the official dates change.
Tip: Import public holidays for several years ahead so that long-running deadlines are calculated correctly across year boundaries.
Save your changes
Click Save in the calendar editor header. The Save button is available only when you have unsaved changes; click Discard changes to revert them.
If you navigate away with unsaved changes, AODocs asks you to confirm.
You can switch between calendars with the calendar name drop-down in the editor breadcrumb.
Delete a calendar
In the list of calendars, click the delete button next to a calendar, then confirm.
Important: You can't delete a calendar that's used by one or more libraries. The error message lists the libraries that use it. Ask the library administrators to remove the calendar from their library's general settings first, then delete it.
Troubleshooting
I don't see the Calendars section in the tenant administration. The calendar feature isn't activated on your AODocs tenant. It's activated on demand by AODocs support (feature flag enableCalendar).
A public holiday is tagged "Movable date". The date is based on an estimate – for example, holidays confirmed by lunar observation. The date is used as-is in calculations; verify it once the official date is confirmed and update the calendar if needed.
I can't delete a calendar. The calendar is still assigned to one or more libraries. Remove it from those libraries' general settings first.