A Django form field and widget wrapper for bootstrap-daterangepicker
Project description
django-bootstrap-daterangepicker
This is Django form field wrapper for bootstrap-daterangepicker, for use with Bootstrap 3 and 4.
This module allows for: single date pickers, date range selectors and datetime range selectors.
Ranges are returned as tuples of format (start, end)
, where start
and end
are datetime.date or datetime.datetime objects depending on the field type.
The DateField is a replacement for Django's built-in forms.DateField
, with the only difference being that it accepts an optional clearable
parameter, and the default widget is the DatePickerWidget specified in this module.
Installation
pip install django-bootstrap-daterangepicker
- Add
'bootstrap_daterangepicker'
to yourINSTALLED_APPS
- Add the resource links required for bootstrap-daterangepicker into the
<head>
of the relevant HTML files
Example usage
from django import forms
from bootstrap_daterangepicker import widgets, fields
class DemoForm(forms.Form):
# Date Picker Fields
date_single_normal = fields.DateField()
date_single_with_format = fields.DateField(
input_formats=['%d/%m/%Y'],
widget=widgets.DatePickerWidget(
format='%d/%m/%Y'
)
)
date_single_clearable = fields.DateField(required=False)
# Date Range Fields
date_range_normal = fields.DateRangeField()
date_range_with_format = fields.DateRangeField(
input_formats=['%d/%m/%Y'],
widget=widgets.DateRangeWidget(
format='%d/%m/%Y'
)
)
date_range_clearable = fields.DateRangeField(required=False)
# DateTime Range Fields
datetime_range_normal = fields.DateTimeRangeField()
datetime_range_with_format = fields.DateTimeRangeField(
input_formats=['%d/%m/%Y (%I:%M:%S)'],
widget=widgets.DateTimeRangeWidget(
format='%d/%m/%Y (%I:%M:%S)'
)
)
datetime_range_clearable = fields.DateTimeRangeField(required=False)
Requirements
- Bootstrap >= 3
- jQuery >= 1
- Moment.js >= 2.10.6
- bootstrap-daterangepicker >= 2
- Django >= 1.8
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django-bootstrap-daterangepicker-1.0.6.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 56e0bbf5b334255c3e1f1fd3dd00182278ce8ece590962a9ed880bf296923349 |
|
MD5 | 033d7ffa8b8c381c5ef08367872bb491 |
|
BLAKE2b-256 | 8acb553238c0371ff86a6ef06e2fd8acdbe3f74f77eab27579151d8a046c0934 |
Hashes for django_bootstrap_daterangepicker-1.0.6-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2c09ac8205f41fd1df95e543d58d8fa635bb47eff4a2beed016173ebb70d79df |
|
MD5 | 0a1f2a3c8b299bd031441a6b5855f9ef |
|
BLAKE2b-256 | f8aefa0dde951a0b2292f728bf4664263617f65e9984a9202defb06a6b3892d7 |