CalendarJS
A simple and light weight JavaScript calendar generator.
Installation
Install with npm:
$ npm install --save @skolacode/calendar-js
Install with yarn:
$ yarn add @skolacode/calendar-js
Usage
import { getCalendar } from '@skolacode/calendar-js'
const july2022Calendar = getCalendar(6, 2022)
console.log(july2022Calendar)
/**
response:
{
calendar: [
[
{
date: 2022-06-25T16:00:00.000Z,
day: 26,
weekday: 'Sunday',
isCurrentMonth: false
},
...
],
[...],
....
month: 6,
year: 2022,
next: { month: 7, year: 2022 },
previous: { month: 5, year: 2022 }
}
*/
Methods
getCalendar(month: number, year: number, options?: IOptions): ICalendar
Parameters
Name | Type | Required | Default | Description |
---|---|---|---|---|
month | Number | Yes | - | The month of the calendar (0 to 11). 0 = January, 1 = February |
year | Number | Yes | - | The year of the calendar |
options.startingDay | TStartingDay | No | 1 | The starting day of the week (0 to 6). 0 = Sunday, 1 = Monday |
options.extraWeek | Boolean | No | true | Calendar rows are fixed to 6 regardless of all the 6th week consists of days for next month |
daysInMonth(month: number, year: number): number
Return the total number of days in a month.
Parameters
Name | Type | Required | Default | Description |
---|---|---|---|---|
month | Number | Yes | - | The month of the calendar (0 to 11). 0 = January, 1 = February |
year | Number | Yes | - | The year of the calendar |
Types
type TWeekdays = 'Sunday' | 'Monday' | 'Tuesday' | 'Wednesday' | 'Thursday' | 'Friday' | 'Saturday';
type TDate = {
date: Date,
day: number,
isCurrentMonth: boolean,
weekday: TWeekdays,
};
interface ICalendar {
calendar: TDate[][];
month: number;
year: number;
next: {
month: number,
year: number,
};
previous: {
month: number,
year: number,
};
}
export type TStartingDay = 0 | 'SUNDAY' | 'Sunday' | 'sunday' | 1 | 'MONDAY' | 'Monday' | 'monday' | 2 | 'TUESDAY' | 'Tuesday' | 'tuesday' | 3 | 'WEDNESDAY' | 'Wednesday' | 'wednesday' | 4 | 'THURSDAY' | 'Thursday' | 'thursday' | 5 | 'FRIDAY' | 'Friday' | 'friday' | 6 | 'SATURDAY' | 'Saturday' | 'saturday';
export interface IOptions {
startingDay?: TStartingDay | number;
extraWeek?: boolean;
}
Contributing
Pull Request:
- Fork this repo
- Create new branch for bug fixes or new feature
- Create/update test files
- Make sure build run successfully
Contribution are always open. Report issues or feature requests on GitHub Issues