@multisystemsuite/timezone-engine-shift-engine

Shift planning and payroll-safe UTC calculations for global workforce and manufacturing systems.

What it is used for

• Night-shift and rotating shift schedules across timezones
• Payroll hour calculation stored in UTC (audit-safe)
• HRMS attendance and manufacturing shift boards
• Workforce planning with IANA timezone accuracy

Install

npm install @multisystemsuite/timezone-engine-shift-engine

Usage

import {
  shiftPlanner,
  payrollTimeCalculator,
} from "@multisystemsuite/timezone-engine-shift-engine";

const planner = shiftPlanner("Asia/Kolkata");

planner.registerShift({
  id: "in-morning",
  name: "India Morning",
  timezone: "Asia/Kolkata",
  startTime: "06:00",
  endTime: "14:00",
  days: [1, 2, 3, 4, 5],
});

const active = planner.getActiveShifts(new Date());
const indiaShifts = planner.planShifts(new Date(), "Asia/Kolkata");

const payroll = payrollTimeCalculator(
  {
    id: "in-morning",
    name: "India Morning",
    timezone: "Asia/Kolkata",
    startTime: "06:00",
    endTime: "14:00",
    days: [1, 2, 3, 4, 5],
  },
  new Date(),
);

console.log(payroll.startUTC, payroll.endUTC, payroll.durationHours);

Key exports

| Export | Purpose | | -------------------------------------- | ------------------------------- | | shiftPlanner() | Create shift planner | | ShiftPlannerEngine.registerShift() | Register a shift definition | | ShiftPlannerEngine.getActiveShifts() | Shifts active on a date | | payrollTimeCalculator() | UTC shift boundaries + duration |

Related packages

• @multisystemsuite/timezone-engine-scheduler — underlying scheduler
• @multisystemsuite/timezone-engine-react — ShiftPlanner component

Keywords

timezone, shift, payroll, workforce, scheduling, hrms, night-shift

License

MIT