@multisystemsuite/timezone-engine-scheduler

Enterprise scheduling engine — meetings, business hours, shifts, holidays, and payroll timezone support.

What it is used for

• Smart meeting planner across global timezones
• Business hours and overlap detection
• Global workforce shifts and payroll hour calculation
• Holiday calendars per timezone
• HRMS, manufacturing shift planning, SaaS booking systems

Install

npm install @multisystemsuite/timezone-engine-scheduler

Usage

import {
  createSchedulerEngine,
  defaultSchedulerConfig,
} from "@multisystemsuite/timezone-engine-scheduler";

const scheduler = createSchedulerEngine({
  defaultTimezone: "UTC",
  businessHours: { start: "09:00", end: "17:00", days: [1, 2, 3, 4, 5] },
  slotDurationMinutes: 30,
  bufferMinutes: 15,
});

// Find meeting slots across NYC, London, Mumbai
const slots = scheduler.findAvailableSlots(
  ["America/New_York", "Europe/London", "Asia/Kolkata"],
  new Date(),
);

const best = scheduler.suggestMeetingTime(["America/New_York", "Asia/Kolkata"], new Date(), 60);

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

const { start, end } = scheduler.computeShiftHoursUTC(shift, new Date());

Key APIs

| API | Purpose | | --------------------------- | ------------------------------------------ | | findAvailableSlots() | Common free windows across timezones | | suggestMeetingTime() | Best single slot recommendation | | calculateMeetingOverlap() | Overlap duration between participants | | isBusinessHour() | Check if datetime is within business hours | | registerHoliday() | Block dates for scheduling | | computeShiftHoursUTC() | Payroll-safe UTC shift boundaries |

Related packages

• @multisystemsuite/timezone-engine-core — timezone conversion
• @multisystemsuite/timezone-engine-react — Scheduler UI component

Keywords

timezone, scheduling, meetings, business-hours, shifts, enterprise, hrms

License

MIT