_[Baremetrics](https://baremetrics.com) provides zero-setup subscription analytics & insights for Stripe, Braintree and Recurly. **[Get started today!](https://baremetrics.com)**_
npm install baremetrics-calendar---
The Baremetrics date range picker is a simplified solution for selecting both date ranges and single dates all from a single calender view. There aren't a billion options but the code is pretty basic and modular so feel free to edit however to meet your own needs.
Design by Chris Meeks
Code by Tyler van der Hoeven
View a demo
View in a live production app
Using the date picker is pretty simple, you've just got to make a couple choices and include a couple settings.
Create a div with a daterange class and then either the daterange--double or daterange--single classname for targeting the specific calendar you'd like to generate.
``html`
Next you've just gotta create a new Calendar instance.
`js
new Calendar({
element: $('.daterange--single'),
current_date: '2015-06-15',
format: {input: 'M/D/YYYY'},
required: false
});
new Calendar({
element: $('.daterange--double'),
earliest_date: '2000-01-1',
latest_date: moment(),
start_date: '2015-05-01',
end_date: '2015-05-31',
callback: function() {
var start = moment(this.start_date).format('ll'),
end = moment(this.end_date).format('ll');
console.debug('Start Date: '+ start +'\nEnd Date: '+ end);
}
});
`
- jQuery DOM object of the calendar div you're working on
- earliest_date
- The earliest date to show in the calendar
- latest_date
- The latest date to show in the calendar
- callback
- A function for whenever a new date is saved
- Inside you have access to object variables like and this.latest_date for doing things with your calendar's dates
- format [object]
- Object containing formatting strings for.. you guessed it.. formatting your dates
js
format: {
input: 'MMMM D, YYYY', // Format for the input fields
jump_month: 'MMMM', // Format for the month switcher
jump_year: 'YYYY' // Format for the year switcher
}
`
- days_array
- Array of the 7 strings you'd like to represent your days in the calendar
js
days_array: ['S','M','T','W','T','F','S']
`$3
- current_date
- The date to start the calendar on
- required
- Toggle if this field must have always have a valid selected date
- placeholder
- Set placeholder text (note this will only apply if the required key is set to ). The default will be whatever moment date format you're using. (i.e. 'M/D/YYYY')$3
- start_date [date YYYY-MM-DD]
- The date to start the selection on for the calendar
- end_date
- The date to end the selection on for the calendar
- same_day_range
- Allow a range selection of a single day
- format
- The double calendar adds the key to the format object for formatting the preset dates in the preset dropdown
- presets [boolean] or [object]
- If you don't want to show the preset link just set this to otherwise the default is true which will just give you a basic preset of.. yep.. presets. BOOM!
- Otherwise, if you want to customize it up you can include an array of preset objects. Something like:
`js
presets: [{
label: 'Last month',
start: moment().subtract(1, 'month').startOf('month'),
end: moment().subtract(1, 'month').endOf('month')
},{
label: 'Last year',
start: moment().subtract(1, 'year').startOf('year'),
end: moment().subtract(1, 'year').endOf('year')
}]
`---
Developing
I've included my signature gulpfile too so be sure and take a look at that as well.
bash
$ cd
$ npm install
$ gulp
``I also use pow and the powder gem to run my local dev environments but however you plan on wrangling that the gulpfile turns on a livereload server so as long as you have the files serving somehow any changes you make will show up instantly.