Skip to main content

Userdates are a resource that aggregate all events related to the working schedule of an employee. There are two types of events: (1) those related to the theoretical working hours of the employee (workcycle, holidays, workcycleExceptions) and (2) those related to the actual working hours of the employee (leaves, time-entries).

A Userdate aggregates:

  • theoretical hours indicated by the employee's workcycle.
  • overrides to the workcycle indicated by the holidays calendar given to the employee.
  • overrides to the workcycle indicated by workcycleExceptions.
  • actual hours from Lucca Timesheet.
  • leaves taken in Lucca Absences.

About durations

The interpretation of durations depends on the time unit applicable to the User.

For instance, '12:00:00' means:

  • A half-day (or 0.5 d) in days unit.
  • 12 hours in hours or time units.

The applicable unit is set on the User's WorkCycle.

source
enum<integer>
  • 1: WorkCycle
  • 2: Public Holidays
  • 3: WorkCycle Exception
  • 5: Leave (from Lucca Absences)
  • 6: Entry (from Lucca Timesheet)
Available options:
1,
2,
3,
5,
6
dtt
string<time>

Theoretical working time. The work duration the User should comply with on this day. It is the result of the workcycle, minus the potential public holidays, delta potential workcycle exception overrides.

Example:

"07:00:00"

drt
string<time>

Actual working time. The actual time the User spent working on this day. Results from the time-entries entered in Lucca Timesheet. If no time-entry has been entered, then defaults to the DTT value.

Example:

"04:15:00"

draj
string<time>

Leave duration.

Example:

"03:30:00"

isHoliday
boolean

Is this day a holiday in the User's holidays calendar?

isWeeklyRest
boolean

Is this the weekly rest day (most often, Sundays) in the User's workcycle?

items
UserDateItem · object[]

All events for this day and User.

am
object

Description of the first half of the day.

pm
object

Description of the second half of this day.

I