Working Hours

Business hours calculations with break support

Edit and run examples against `ts-time-utils@4.4.1` in your browser.

Business Hours

Calculate working time accounting for schedules

index.ts

import { isWorkingTime, addWorkingDays, workingDaysBetween } from 'ts-time-utils/workingHours';

// Define working hours config
const config = {
  workingDays: [1, 2, 3, 4, 5], // Mon-Fri
  hours: { start: 9, end: 17 },
  breaks: [{ start: 12, end: 13 }] // Lunch break
};

// Check if currently working time
const monday10am = new Date('2025-09-15T10:00:00');
const saturday = new Date('2025-09-13T10:00:00');
const lunchTime = new Date('2025-09-15T12:30:00');

console.log('Mon 10am working?', isWorkingTime(monday10am, config));
// true

console.log('Saturday working?', isWorkingTime(saturday, config));
// false

console.log('During lunch?', isWorkingTime(lunchTime, config));
// false (during break)

// Add working days (skips weekends)
const friday = new Date('2025-09-12');
const afterWorkDays = addWorkingDays(friday, 3, config);
console.log('3 working days after Friday:', afterWorkDays.toDateString());
// Wednesday (skips Sat, Sun)

// Count working days between dates
const start = new Date('2025-09-01');
const end = new Date('2025-09-30');
console.log('Working days in Sep:', workingDaysBetween(start, end, config));

Console

Press Run to execute the example.