@krishnapawar/date-time-slots

$3

>date-time-slots (timeSlot) is a user-friendly JavaScript library for Node.js that simplifies the handling of time slots in projects. It provides easy-to-use methods to convert, manipulate, and generate time slots. Here's a quick rundown:
This library aims to make working with time slots in Node.js projects straightforward and efficient. Developers can easily integrate it into their applications for effective time management.

$3

``shh
npm i date-time-slots
`
`shh
npm i @krishnapawar/date-time-slots
`

1 Time Conversion:

* railwayToNormalTimeConvert and formatTimeIn24Hour convert railway time to normal time and vice versa.
* normalToRailwayTimeConvert changes normal time to railway time.

`javaScript
railwayToNormalTimeConvert("13:00");
formatTimeIn24Hour("13:00");
normalToRailwayTimeConvert("01:00 AM");
`

$3

>railwayToNormalTimeConvert method covert railway time into normal time example
`javaScript

railwayToNormalTimeConvert("13:00");
`
>we can also use same as formatTimeIn24Hour method covert railway time into normal time example
`javaScript

formatTimeIn24Hour("13:00");
`

>also apposite method same as normalToRalwayTimeConvert method covert normal time into railway time example
`javaScript

normalToRalwayTimeConvert("01:00 AM");
`
2 Generating Time Slots:

* timeSlot generates an array of time slots based on provided start and end times.
You can customize the duration and format of the slots.
`javaScript
let slots = timeSlot({ starting_time: '12:00', ending_time: '17:00', duration: 15 });
`
* Additional options include handling current time, specific dates, and blocking slots.
`javaScript
let slots = timeSlot({ isCurrent: true, date: "2023-11-05", starting_time: '12:00', ending_time: '17:00' });
`

>timeSlot method covert into simple time slot it take three argument in json starting_time,ending_time,and duration, and it give output in array example ['12:00','12:15','12:30','12:45','01:00','01:15']
> example paylode { duration:15, date: "2023-11-05"T10:13:02.481Z, isCurrent: true, starting_time: '12:00', ending_time: '17:00' }
`javaScript

let data = timeSlot({starting_time: '12:00', ending_time: '17:00' } );
`
>we can pass time as 12 hour format or 24 format is this method it give as same output.
`javaScript

let data = timeSlot({starting_time: '11:00 PM', ending_time: '01:00 AM' } );
`
>If we want check time with current time and show only remening slot only. then we have to use keyword (isCurrent:true) in this object.
`javaScript

let data = timeSlot({ isCurrent: true, starting_time: '12:00', ending_time: '17:00' } );

`
>If we want check time with current time and current date then we have to pass date as well in the object with {
date:"2023-10-04",
isCurrent:true
} and it show only remening slot only in current.
`javaScript

let data = timeSlot({ date: "2023-11-05", isCurrent: true, starting_time: '12:00', ending_time: '17:00' } );

`
>By default It make 15 minuts time slot If you want to change time slot duration you can chang using keyword => duration:30,

`javaScript

let data = timeSlot({ duration: 15, date: "2023-11-05", isCurrent: true, starting_time: '12:00', ending_time: '17:00' } );
`
>If you want show slot current time to next slot then use keyword next:true.
`javaScript

let data = timeSlot({
duration: 15,
date: "2023-11-05",
isCurrent: true,
starting_time: '12:00',
ending_time: '17:00',
next:true
} );
`
>if you want slot in 24 hour time you can use keyword =>isNotRailwayTime:true, It give you time slot in 24 hour time.
`javaScript

let data = timeSlot({
duration: 15,
date: "2023-11-05",
isCurrent: true,
starting_time: '12:00',
ending_time: '17:00',
next:true,
isNotRailwayTime:true,
} );
`
>If you want to block time slot with pertitucler date we have to use =>
blockSchedule:[
// "12:15 PM",
// "12:30 PM",
// "12:45 PM",
"12:00",
"14:00",
]
with array object with block slot and date with keyword =>date:"2023-10-04". exmaple
`javaScript

let data = timeSlot({
duration: 15,
date: "2023-11-05",
isCurrent: true,
starting_time: '12:00',
ending_time: '17:00',
next:true,
isNotRailwayTime:true,
blockSchedule:[
// "12:15 PM",
// "12:30 PM",
// "12:45 PM",
"12:00",
"14:00",
]
} );
`
3 Pair of Time Slots:

* startToEndTimeSlot generates pairs of start and end times based on given parameters.
Similar customization options are available.
`javaScript
let timePairs = startToEndTimeSlot("11:00 PM", "01:00 AM", { isCurrent: true, date: "2023-10-04" });
`

* startToEndTimeSlot method covert into pair of time slot in object format. it take three argument in startToEndTimeSlot() method, starting_time,ending_time, and object, and object is optional. we can pass time as 12 hour format or 24 format is this method it give as same output.
exmaple given below.
>12 hour format

`javaScript

let data =startToEndTimeSlot("11:00 PM","01:00 AM");

`
>24 hour format
`javaScript

let data =startToEndTimeSlot("11:00","'17:00'");

`
* If we want check time with current time and show only remening slot only. then we have to use keyword (isCurrent:true) in this object.
`javaScript

let data =startToEndTimeSlot("11:00 PM","01:00 AM",{
isCurrent:true
});

`
* If we want check time with current time and current date then we have to pass date as well in the object with {
date:"2023-10-04",
isCurrent:true
} and it show only remening slot only in current.
`javaScript

let data =startToEndTimeSlot("11:00 PM","01:00 AM",{
date:"2023-10-04",
isCurrent:true
});
`
* If you want to block time slot with pertitucler date we have to use =>blockSchedule:[{"slot": "9:15 PM - 9:30 PM"}] with array object with block slot and date with keyword =>date:"2023-10-04". exmaple
`javaScript

let data =startToEndTimeSlot("11:00 PM","01:00 AM",{
blockSchedule:[
{
"slot": "9:15 PM - 9:30 PM"
},
{
"slot": "9:45 PM - 10:00 PM"
}
],
date:"2023-10-04",
isCurrent:true
});
`
* By default It make 15 minuts time slot If you want to change time slot duration you can chang using keyword => duration:30,
`javaScript

let data =startToEndTimeSlot("11:00 PM","01:00 AM",{
blockSchedule:[
{
"slot": "9:15 PM - 9:30 PM"
},
{
"slot": "9:45 PM - 10:00 PM"
}
],
date:"2023-10-04",
isCurrent:true,
duration:30,
});
`
* if you want slot in 24 hour time you can use keyword =>isNotRailwayTime:true, It give you time slot in 24 hour time.
`javaScript

let data =startToEndTimeSlot("11:00 PM","01:00 AM",{
blockSchedule:[
{
"slot": "9:15 PM - 9:30 PM"
},
{
"slot": "9:45 PM - 10:00 PM"
}
],
date:"2023-10-04",
isCurrent:true,
duration:30,
isNotRailwayTime:true,
});
`
* If you want date with slot you can use key word =>withDate:true,
`javaScript

let data =startToEndTimeSlot("11:00 PM","01:00 AM",{
blockSchedule:[
{
"slot": "9:15 PM - 9:30 PM"
},
{
"slot": "9:45 PM - 10:00 PM"
}
],
date:"2023-10-04",
isCurrent:true,
withDate:true,
duration:30,
isNotRailwayTime:true,
});
`
* If we want response in start,end in form of keys and values object. then we have to use keyword =>startToEndObj:true,
`javaScript

let data =startToEndTimeSlot("11:00 PM","01:00 AM",{
blockSchedule:[
{
"start": "10:45",
"end": "11:00",
"date": "2023-11-13"
},
{
"start": "11:00",
"end": "11:15",
"date": "2023-11-13"
}
],
date:"2023-11-13",
isCurrent:true,
withDate:true,
duration:30,
isNotRailwayTime:true,
startToEndObj:true,
});
``