Package Exports
- @youngbeen/workday
- @youngbeen/workday/dist/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@youngbeen/workday) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
workday
Provides workday and holiday supports in pure JavaScript. Holiday plans are based on legal holiday plans, you can use custom local plans instead.
Tip: This repo will be updated every year with new year legal holiday plan released. Hence local dependency should be updated every year as well.
Install
npm install @youngbeen/workday
How-to
Wherever you want to use, import the apis you need. e.g.
import { isWeekend, getFollowWorkday } from '@youngbeen/workday'
Apis
Determine a date is workday or holiday
getDayType(date)
date - date to check, any valid date type
Example:
getDayType('2022-01-14') // -> 'workday'
getDayType('2022-01-16 10:23:32') // -> 'holiday'
getDayType(new Date())
Check a date is workday or not
isWorkday(date)
date - date to check, any valid date type
Example:
isWorkday('2022-01-14') // -> true
isWorkday('2022-01-16 10:23:32') // -> false
isWorkday(new Date())
Check a date is weekend or not
isWeekend(date)
date - date to check, any valid date type
Example:
isWeekend('2022-01-14') // -> false
isWeekend('2022-01-16 10:23:32') // -> true
isWeekend(new Date())
Get a date's following workday
getFollowWorkday(date)
date - a date, any valid date type
Example:
getFollowWorkday('2022-01-13') // return the 14th Jan 2022 by local timezone
getFollowWorkday('2022-01-14 10:23:32') // return the 17th Jan 2022 by local timezone
getFollowWorkday(new Date()) // return today's follow workday by local timezone
Get a date's next N workday
getComingWorkday(date, n)
date - a date, any valid date type n - count after the date, defaults to 1
Example:
getComingWorkday('2022-01-13') // return the first workday after 2022-01-13 by local timezone
getComingWorkday('2022-01-14 10:23:32', 3) // return the third workday after 2022-01-14 10:23:32 by local timezone
getComingWorkday(new Date(), 2) // return the second workday after today by local timezone
Get a date's following day
getFollowNatureDay(date)
date - a date, any valid date type
Example:
getFollowNatureDay('2022-01-13') // return the 14th Jan 2022 by local timezone
getFollowNatureDay('2022-01-14 10:23:32') // return the 15th Jan 2022 by local timezone
getFollowNatureDay(new Date()) // return today's follow day by local timezone
Get a date's next N day
getComingNatureDay(date, n)
date - a date, any valid date type n - count after the date, defaults to 1
Example:
getComingNatureDay('2022-01-13') // return the first day after 2022-01-13 by local timezone
getComingNatureDay('2022-01-14 10:23:32', 3) // return the third day after 2022-01-14 10:23:32 by local timezone
getComingNatureDay(new Date(), 2) // return the second day after today by local timezone
Get a date's next weekday X
getFollowWeekday(date, x)
date - a date, any valid date type
x - weekday, 0 - Sunday, 16 - MondaySaturday
Example:
getFollowWeekday('2022-01-13', 2) // return the next tuesday after 2022-01-13 by local timezone
getFollowWeekday('2022-01-14 10:23:32', 6) // return the next saturady after 2022-01-14 10:23:32 by local timezone
getFollowWeekday(new Date(), 0) // return the next sunday after today by local timezone