React Single Calendar

Description:

react-single-calendar is a very useful and easy to use date picker, no external dependency is needed for this. You can chagne theme of it's color, by simply editing css variables.

How to install?

npm i react-single-calendar

Implementation

import React, {useState} from 'react';
import SingleCalendar from 'react-single-calendar';


const App = () => {
    let [date, filterDate] = useState('');
    return (
        ....
        <SingleCalendar selectedDate={filterDate} />
    )
}
export default App;

In this date useState you will get the selectedDate, selectedDate is the props for SingleCalendar component. It will return this filterDate method, you can use your own method.

react-single-calendar returns a string value like March 21, 2019, if no formate has been provied. You can use Date.parse() method to convert it as a date.

react-single-calendar can be used with input field on, or off. If dateInput property is true, it will work as a form input field. If value is false you can open or close this component on a freedom of your own button click function

Getting Date Range

For getting date range, add a on for < SingleCalendar />, named as range={true}, by default range is false.

When using range, this filterDate method returns an array of to strings

Stateless or Functional Component

import React, {useState} from 'react';
import SingleCalendar from 'react-single-calendar';


const App = () => {
    let [date, filterDate] = useState('');
    return (
        ....
        <SingleCalendar selectedDate={filterDate} range={true} />
    )
}
export default App;

Class Component

import React from 'react';
import SingleCalendar from 'react-single-calendar';
class App extends React.Component {
  // let [nodes, setNodes] = useState(null);
  constructor(props) {
    super(props);
    this.state = {
      date: '21-09-2020',
      currentDate: "October 13, 2021"
    }
  }

  filterDate(date) {
    this.setState({
      date: date
    })
  }
  render() {
    return (
      <div>
        <SingleCalendar selectedDate={(date) => this.filterDate(date)} dateInput={true} />
      </div>
    )
  }
}

export default App;

In this example it the date variable will return:

Example: ['March 21, 2019', 'August 10, 2019']

Again you can use Date.parse() method, to gate a date value, or you can use this strings in your way.

Disable Future Dates

react-single-calendar has a feature to disable upcoming dates. For that you need to add upcoming as a prop and set the value to false. By default it is set to true.

<SingleCalendar selectedDate={filterDate} upcoming={false}/>

You can use this feature with date range also, see the below code:

<SingleCalendar selectedDate={filterDate} range={true} upcoming={false}/>

Theming:

On your css/ scss add this variables. You can customize your theme color and width, height through this css variables.

:root {
  --weekend: rgba(0, 0, 0, 0);
  --date-light: #f8f9fa;
  --date-primary: #5644c1;
  --date-success: #37d37d;
  --date-primaryLight: #eceaf5;
  --date-primaryTitle: #dbd8f0;
  --date-hover: #262769;
  --date-highlight: #f83854;
  --date-disabled:#c2c1cc;
  --date-width: 260px;
  --date-height: 280px;

These fields are added, for the range:

date-rangebg: is for highlighting dates between two selected dates
date-rangetext: changing color of text in range area
date-rangeDateBg: two main dates which will indicate "from" and "to" dates

  --date-rangebg:#8072d0;
  --date-rangetext:#f8f9fa;
  --date-rangeDateBg:#5644c1;
}

Options

Properties	Type	Description	Values
selectedDate	Function	Returns selected date or date range
format	String	Define the format of date, if not set it will return like Month day, year formate like "November 12, 1998", year will be always yyyy format and you can use your choice of seperator '-', '/' even 'a', 'b' also	dd-mm-yyyy, mm/dd/yyyy, **yyyy
currentDate	String	It need to be provided "month day, year" format, like "December 03, 2012" if not provided it will show date format on the input field	December 03, 2012
max	String	If you want to put a limit, like user cannot entry after this date, then you will use it as a max date limit, To use max you need to provide format option and the format of this max should be same as the format option	dd-mm-yyyy, mm/dd/yyyy, **yyyy
min	String	If you want to put a limit, like user cannot entry beyond this date, then you will use it as a min date limit, To use min you need to provide format option and the format of this min should be same as the format option	dd-mm-yyyy, mm/dd/yyyy, **yyyy
icons	Object	You can change the default icon of this library, by providing svg or image files, import calendar from './assets/calendar.svg'	icons={{ 'calendar': calendarIcon, 'done': tickIcon, 'reset': resetIcon, 'previous': prevIcon, 'next': nextIcon }}
upcoming	Boolean	By default its true, if set to false, means future dates will be hidden	true / false
range	Boolean	If true, will use as a date reange selector, but max option will not be applicable here	true / false
dateInput	Boolean	If true, calendar will have an input field, onFocus calendar will open, also calendar* proerty from icon will have a small icon beside this input field*	true / false
cssClass	String	If dateInput* is true this option will provide className to the input field, So if anyone using bootstrap and want to use form-control class, can provide from this option*	form-control myClass
cssClass	String	If This option will provide className to the input field, So if anyone using bootstrap and want to use form-control* class, can provide from this option*	form-control myClass
placeHolder	String	This option will provide placeholder text to the input field	placeHolder={'Enter your DOB' }

Raise an Issue

If you are facing any issue regarding installation and usage, raise your issue in Git repo.

https://github.com/devsubhajit/react-single-calendar/issues