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.
npm install @digvan/sschedulerAs 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 '@digvan/sscheduler';
const scheduler = new Scheduler();
const schedule = {
from: '2019-01-10',
to: '2019-01-17',
duration: 60,
interval: 60,
timezone: "America/Los_Angeles",
schedule: {
weekdays: {
from: '08:00', to: '17:00',
unavailability: [
{ from: '12:00', to: '13:00' }
]
},
unavailability: [
// two different types of unavailability structure
{ from: '2019-01-20 00:00', to: '2019-01-27 00:00' },
{ date: '2019-01-15', from: '14:00', to: '15:00' }
],
allocated: [
{ from: '2019-02-01 13:00' , duration: 60 },
{ from: '2019-02-01 14:00' , duration: 60 }
]
}
};
console.log(scheduler.getAvailabilityWithTimezone(schedule, "America/Los_Angeles"));The returned value is a structure that looks like the following:
{
'2017-02-01': [
{ time: '09:00', available: true },
{ time: '10:00', available: true }
// ...
]
// ...
}The possible options for the getAvailability function are:
from (required)
The start date for which we want to get availability timesto (required)
The end date for which we want to get availability times (exclusive)interval (required)
The interval (in minutes) of the returned availability times. For example, a value of 15 would returns availability times such as *10:00*, *10:15*, *10:30*, *10:45*, etc..duration (required)
The duration (in minutes) for which we need the resource.schedule (required)
The schedule of the resource for each day of the week.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" },
]
}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 '@digvan/sscheduler';
const scheduler = new Scheduler();
const schedule1 = {
from: '2019-01-10',
to: '2019-01-17',
duration: 60,
interval: 60,
timezone: "America/Los_Angeles",
schedule: {
weekdays: {
from: '08:00', to: '17:00',
unavailability: [
{ from: '12:00', to: '13:00' }
]
},
unavailability: [
// two different types of unavailability structure
{ from: '2019-01-20 00:00', to: '2019-01-27 00:00' },
{ date: '2019-01-15', from: '14:00', to: '15:00' }
],
allocated: [
{ from: '2019-02-01 13:00' , duration: 60 },
{ from: '2019-02-01 14:00' , duration: 60 }
]
}
};
const schedule2 = {
from: '2019-01-10',
to: '2019-01-17',
duration: 60,
interval: 60,
timezone: "CET",
schedule: {
weekdays: {
from: '07:00', to: '18:00',
unavailability: [
{ from: '13:00', to: '14:00' }
]
},
unavailability: [
// two different types of unavailability structure
{ from: '2019-01-15 17:00', to: '2019-01-15 18:00' },
{ date: '2019-01-16', from: '17:00', to: '18:00' }
],
allocated: [
{ from: '2019-02-01 13:00' , duration: 60 },
{ from: '2019-02-01 14:00' , duration: 60 }
]
}
};
const availability = scheduler.getAvailabilityWithTimezone(schedule2, "America/Los_Angeles");npm install
gulpnpm run compile
npm run test- Mickael Burguet - Original author - ssense/sscheduler
- Matt Michel - ninjaPixel
- Khash Nejad - digvan
This project is licensed under the MIT License - see the LICENSE.md file for details.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent