sscheduler-slots

Flexible scheduler to find free time slots in the schedule of a resource (which could be a person, a meeting room, a car, etc...)

sscheduler can also intersect the availability of multiple resources in order to find the time slots at which all the resources are available.

Installation

npm install @leooxx/sscheduler-slots

Basic usage

As an example, let's say that we want to book a 1 hour appointment with a doctor in the month of february considering that:

• We can only book on weekdays from 9AM to 5PM

• We can't book between noon and 1PM (lunch time !)

• The doctor is on vacation the week of the 20th

• There are already two one-hour appointments booked on February 1st at 1PM and 2PM

import {Scheduler} from '@leooxx/sscheduler-slots';

const scheduler = new Scheduler();
const availability = scheduler.getAvailability({
    from: '2017-02-01',
    to: '2017-03-01',
    duration: 60,
    interval: 60,
    schedule: {
        weekdays: {
            slots: [
                { from: '09:00', to: '12:00' },
                { from: '14:00', to: '18:00' }
            ],
            unavailability: [
                { from: '12:00', to: '13:00' }
            ]
        },
        // replace hours for a specific date
        custom_schedule : [
        { 
          date: "2023-01-23", 
          slots : [{"from": "08:00", "to": "10:00"},{"from": "19:00", "to": "22:00"}] 
        }
        ],
        unavailability: [
            // two different types of unavailability structure
            { from: '2017-02-20 00:00', to: '2017-02-27 00:00' },
            { date: '2017-02-15', from: '12:00', to: '13:00' }
        ],
        allocated: [
          { from: '2017-02-01 13:00' , duration: 60 },
          { from: '2017-02-01 14:00' , duration: 60 }
        ]
    }
});

The returned value is a structure that looks like the following:

{
  '2017-02-01': [
    { time: '09:00', available: true },
    { time: '10:00', available: true }
    // ...
  ]
  // ...
}

Options

The possible options for the getAvailability function are:

Example:

{
  monday: {
    from: '09:00',
    to: '17:00',
    unavailability: [
      { from: '12:00', to: '13:00' }
    ]
  },
  custom_schedule: [
    { "date": "2017-01-23", "from": "12:00", "to": "17:00" },
  ]
}

Schedule intersection

Using the same example as before, let's say that we also need to book a room for our appointment.

So, we need to intersect the doctor's availability times with the room's availability times, considering that:

• We can only book the room on weekdays from 8AM to 8PM

• The room is out of service from February 6th to February 16th

import {Scheduler} from '@ssense/sscheduler';

const scheduler = new Scheduler();
const availability = scheduler.getIntersection({
    from: '2017-02-01',
    to: '2017-03-01',
    duration: 60,
    interval: 60,
    schedules: [
        // The doctor's schedule
        {
            weekdays: {
                from: '09:00', to: '17:00',
                unavailability: [
                    { from: '12:00', to: '13:00' }
                ]
            },
            unavailability: [
                { from: '2017-02-20 00:00', to: '2017-02-27 00:00' }
            ],
            allocated: [
              { from: '2017-02-01 13:00' , duration: 60 },
              { from: '2017-02-01 14:00' , duration: 60 }
            ]
        },

        // The room's schedule
        {
            weekdays: {
                from: '08:00', to: '20:00',
            },
            unavailability: [
                { from: '2017-02-06 00:00', to: '2017-02-16 00:00' }
            ]
        }
    ]
});

Build

npm install
gulp

Test

npm run compile
npm run test

publish

npm publish

Authors

• Mickael Burguet - Senior Developer - rundef
• Léo POITOUT - Tourist Developer

License

This project is licensed under the MIT License - see the LICENSE.md file for details.