Metadata-Version: 2.1
Name: django4-bootstrap-daterangepicker
Version: 1.0.7
Summary: A Django form field and widget wrapper for bootstrap-daterangepicker
Home-page: https://github.com/jckw/django-bootstrap-daterangepicker/
Author: Yuri Malinov, Jack Weatherilt, D
Author-email: yurik.m@gmail.com, jackweatherilt@outlook.com, protasov.d.51@gmail.com
License: MIT
Keywords: daterangepicker django4 django daterange datetime date bootstrap picker
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Classifier: Environment :: Web Environment
Classifier: Framework :: Django :: 4.0
Description-Content-Type: text/markdown
License-File: LICENSE

# django-bootstrap-daterangepicker

This is Django form field wrapper for [bootstrap-daterangepicker](http://www.daterangepicker.com/), 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.

# Origin

This is unofficial package. No changes except [issue#23](https://github.com/jckw/django-bootstrap-daterangepicker/issues/23).

# Installation
1. `pip install django-bootstrap-daterangepicker`
2. Add `'bootstrap_daterangepicker'` to your `INSTALLED_APPS`
3. Add the resource links required for [bootstrap-daterangepicker](http://www.daterangepicker.com/) into the `<head>`  of the relevant HTML files

## Example usage
```python
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](http://getbootstrap.com/) >= 3
* [jQuery](http://www.jquery.com/) >= 1
* [Moment.js](http://momentjs.com/) >= 2.10.6
* [bootstrap-daterangepicker](http://www.daterangepicker.com/) >= 2
* [Django](https://www.djangoproject.com/) >= 4.0
