# Calender

## Purpose

The **Calendar** module provides a yearly calendar view for managing employee leave applications and public holidays. Users can view holidays, navigate between different years, submit new leave applications, and review all leave records.

---

# Navigation

```
Payroll
   └── Calendar
```

<div class="relative w-full mt-4 mb-1" id="bkmrk--1"><div class=""><div class="contents"><div class="relative"><div class="h-full min-h-0 min-w-0"><div class="h-full min-h-0 min-w-0"><div class="border border-token-border-light border-radius-3xl corner-superellipse/1.1 rounded-3xl"><div class="h-full w-full border-radius-3xl bg-token-bg-elevated-secondary corner-superellipse/1.1 overflow-clip rounded-3xl lxnfua_clipPathFallback"><div class="relative"><div class="pe-11 pt-3"><div class="relative z-0 flex max-w-full"><div class="q9tKkq_viewer cm-editor z-10 light:cm-light dark:cm-light flex h-full w-full flex-col items-stretch ͼs ͼ16" dir="ltr" id="bkmrk--2"><div class="cm-scroller"></div></div></div></div></div></div></div></div></div><div class=""><div class="">[![Screenshot 2026-07-03 113410.png](https://documentation.xccel.my/uploads/images/gallery/2026-07/scaled-1680-/screenshot-2026-07-03-113410.png)](https://documentation.xccel.my/uploads/images/gallery/2026-07/screenshot-2026-07-03-113410.png)</div></div></div></div></div></div>---

# Calendar Overview

The Calendar displays the complete calendar for the selected year, allowing users to view leave schedules and public holidays.

Users can:

- View the annual calendar.
- Navigate to previous or next year.
- View public holidays.
- Create a new leave application.
- Switch to List View to view all leave applications.

---

# Features

## 1. Year Navigation

Users can browse different calendar years using the navigation buttons.

### Functions

- Previous Year
- Next Year
- Display current selected year

**Purpose**

Allows users to review leave records and holidays across different years.

---

## 2. Holiday

Displays all public holidays configured in the system.

**Purpose**

Enable employees to view official holidays when planning leave applications.

---

## 3. Apply Leave

Creates a new leave application.

### Procedure

1. Click **Apply**.
2. Select the employee.
3. Select the leave type.
4. Enter the number of leave days.
5. Select the leave date(s).
6. Choose the leave length.
7. Select the application status.
8. Enter the reason for leave.
9. Upload supporting documents if required.
10. Click **Save** or **Submit**.

---

# Leave Application Fields

<div class="TyagGW_tableContainer" id="bkmrk-field-description-em"><div class="group TyagGW_tableWrapper flex flex-col-reverse w-fit" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="2169" data-start="1594"><thead data-end="1617" data-start="1594"><tr data-end="1617" data-start="1594"><th class="last:pe-10" data-col-size="sm" data-end="1602" data-start="1594">Field</th><th class="last:pe-10" data-col-size="md" data-end="1617" data-start="1602">Description</th></tr></thead><tbody data-end="2169" data-start="1644"><tr data-end="1687" data-start="1644"><td data-col-size="sm" data-end="1655" data-start="1644">Employee</td><td data-col-size="md" data-end="1687" data-start="1655">Employee applying for leave.</td></tr><tr data-end="1772" data-start="1688"><td data-col-size="sm" data-end="1701" data-start="1688">Leave Type</td><td data-col-size="md" data-end="1772" data-start="1701">Type of leave (Annual Leave, Medical Leave, Emergency Leave, etc.).</td></tr><tr data-end="1821" data-start="1773"><td data-col-size="sm" data-end="1780" data-start="1773">Days</td><td data-col-size="md" data-end="1821" data-start="1780">Total number of leave days requested.</td></tr><tr data-end="1879" data-start="1822"><td data-col-size="sm" data-end="1849" data-start="1822">Dates to Apply for Leave</td><td data-col-size="md" data-end="1879" data-start="1849">Leave start and end dates.</td></tr><tr data-end="1936" data-start="1880"><td data-col-size="sm" data-end="1895" data-start="1880">Leave Length</td><td data-col-size="md" data-end="1936" data-start="1895">Leave duration (Full Day, AM, or PM).</td></tr><tr data-end="2008" data-start="1937"><td data-col-size="sm" data-end="1946" data-start="1937">Status</td><td data-col-size="md" data-end="2008" data-start="1946">Current leave status (Draft, Pending, Approved, Rejected).</td></tr><tr data-end="2052" data-start="2009"><td data-col-size="sm" data-end="2018" data-start="2009">Reason</td><td data-col-size="md" data-end="2052" data-start="2018">Reason for applying for leave.</td></tr><tr data-end="2169" data-start="2053"><td data-col-size="sm" data-end="2086" data-start="2053">Supporting Document (URL/File)</td><td data-col-size="md" data-end="2169" data-start="2086">Optional supporting document, such as a medical certificate or approval letter.</td></tr></tbody></table>

</div></div>---

# Leave Length

<div class="TyagGW_tableContainer" id="bkmrk-option-description-f"><div class="group TyagGW_tableWrapper flex flex-col-reverse w-fit" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="2434" data-start="2192"><thead data-end="2216" data-start="2192"><tr data-end="2216" data-start="2192"><th class="last:pe-10" data-col-size="sm" data-end="2201" data-start="2192">Option</th><th class="last:pe-10" data-col-size="md" data-end="2216" data-start="2201">Description</th></tr></thead><tbody data-end="2434" data-start="2243"><tr data-end="2306" data-start="2243"><td data-col-size="sm" data-end="2254" data-start="2243">Full Day</td><td data-col-size="md" data-end="2306" data-start="2254">Employee is on leave for the entire working day.</td></tr><tr data-end="2369" data-start="2307"><td data-col-size="sm" data-end="2312" data-start="2307">AM</td><td data-col-size="md" data-end="2369" data-start="2312">Employee takes leave during the morning session only.</td></tr><tr data-end="2434" data-start="2370"><td data-col-size="sm" data-end="2375" data-start="2370">PM</td><td data-col-size="md" data-end="2434" data-start="2375">Employee takes leave during the afternoon session only.</td></tr></tbody></table>

</div></div>---

# Leave Status

<div class="TyagGW_tableContainer" id="bkmrk-status-description-d"><div class="group TyagGW_tableWrapper flex flex-col-reverse w-fit" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="2723" data-start="2457"><thead data-end="2481" data-start="2457"><tr data-end="2481" data-start="2457"><th class="last:pe-10" data-col-size="sm" data-end="2466" data-start="2457">Status</th><th class="last:pe-10" data-col-size="md" data-end="2481" data-start="2466">Description</th></tr></thead><tbody data-end="2723" data-start="2508"><tr data-end="2577" data-start="2508"><td data-col-size="sm" data-end="2516" data-start="2508">Draft</td><td data-col-size="md" data-end="2577" data-start="2516">Leave application has been created but not yet submitted.</td></tr><tr data-end="2627" data-start="2578"><td data-col-size="sm" data-end="2588" data-start="2578">Pending</td><td data-col-size="md" data-end="2627" data-start="2588">Waiting for manager or HR approval.</td></tr><tr data-end="2675" data-start="2628"><td data-col-size="sm" data-end="2639" data-start="2628">Approved</td><td data-col-size="md" data-end="2675" data-start="2639">Leave request has been approved.</td></tr><tr data-end="2723" data-start="2676"><td data-col-size="sm" data-end="2687" data-start="2676">Rejected</td><td data-col-size="md" data-end="2723" data-start="2687">Leave request has been rejected.</td></tr></tbody></table>

</div></div>---

# List View

The **List View** displays all leave applications in a tabular format for easier searching and management.

Typical information includes:

<div class="TyagGW_tableContainer" id="bkmrk-column-description-l"><div class="group TyagGW_tableWrapper flex flex-col-reverse w-fit" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="3225" data-start="2882"><thead data-end="2906" data-start="2882"><tr data-end="2906" data-start="2882"><th class="last:pe-10" data-col-size="sm" data-end="2891" data-start="2882">Column</th><th class="last:pe-10" data-col-size="sm" data-end="2906" data-start="2891">Description</th></tr></thead><tbody data-end="3225" data-start="2933"><tr data-end="2984" data-start="2933"><td data-col-size="sm" data-end="2945" data-start="2933">Leave No.</td><td data-col-size="sm" data-end="2984" data-start="2945">Leave application reference number.</td></tr><tr data-end="3014" data-start="2985"><td data-col-size="sm" data-end="2996" data-start="2985">Employee</td><td data-col-size="sm" data-end="3014" data-start="2996">Employee name.</td></tr><tr data-end="3056" data-start="3015"><td data-col-size="sm" data-end="3028" data-start="3015">Leave Type</td><td data-col-size="sm" data-end="3056" data-start="3028">Type of leave requested.</td></tr><tr data-end="3096" data-start="3057"><td data-col-size="sm" data-end="3070" data-start="3057">Leave Date</td><td data-col-size="sm" data-end="3096" data-start="3070">Approved leave period.</td></tr><tr data-end="3129" data-start="3097"><td data-col-size="sm" data-end="3104" data-start="3097">Days</td><td data-col-size="sm" data-end="3129" data-start="3104">Number of leave days.</td></tr><tr data-end="3170" data-start="3130"><td data-col-size="sm" data-end="3139" data-start="3130">Status</td><td data-col-size="sm" data-end="3170" data-start="3139">Current application status.</td></tr><tr data-end="3225" data-start="3171"><td data-col-size="sm" data-end="3186" data-start="3171">Applied Date</td><td data-col-size="sm" data-end="3225" data-start="3186">Date the application was submitted.</td></tr></tbody></table>

</div></div>**Purpose**

- Search leave applications.
- Filter leave records.
- Review leave history.
- Track application status.

---

# Summary

<div class="TyagGW_tableContainer" id="bkmrk-function-description"><div class="group TyagGW_tableWrapper flex flex-col-reverse w-fit" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="3729" data-start="3362"><thead data-end="3388" data-start="3362"><tr data-end="3388" data-start="3362"><th class="last:pe-10" data-col-size="sm" data-end="3373" data-start="3362">Function</th><th class="last:pe-10" data-col-size="md" data-end="3388" data-start="3373">Description</th></tr></thead><tbody data-end="3729" data-start="3416"><tr data-end="3477" data-start="3416"><td data-col-size="sm" data-end="3434" data-start="3416">Year Navigation</td><td data-col-size="md" data-end="3477" data-start="3434">Browse previous or next calendar years.</td></tr><tr data-end="3525" data-start="3478"><td data-col-size="sm" data-end="3488" data-start="3478">Holiday</td><td data-col-size="md" data-end="3525" data-start="3488">View company and public holidays.</td></tr><tr data-end="3575" data-start="3526"><td data-col-size="sm" data-end="3540" data-start="3526">Apply Leave</td><td data-col-size="md" data-end="3575" data-start="3540">Create a new leave application.</td></tr><tr data-end="3655" data-start="3576"><td data-col-size="sm" data-end="3595" data-start="3576">Leave Management</td><td data-col-size="md" data-end="3655" data-start="3595">Record leave details, reasons, and supporting documents.</td></tr><tr data-end="3729" data-start="3656"><td data-col-size="sm" data-end="3668" data-start="3656">List View</td><td data-col-size="md" data-end="3729" data-start="3668">View and manage all leave applications in a table format.</td></tr></tbody></table>

</div></div>---

# Workflow

```
Employee
      │
      ▼
Open Calendar
      │
      ▼
Click "Apply"
      │
      ▼
Complete Leave Application
      │
      ▼
Submit Application
      │
      ▼
Pending Approval
      │
      ▼
Approved / Rejected
      │
      ▼
Leave Recorded in Calendar
```