Metadata-Version: 2.1
Name: django-bootstrap-daterangepicker
Version: 1.0.4
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
Author-email: yurik.m@gmail.com, jackweatherilt@outlook.com
License: MIT
Keywords: django daterange datetime date bootstrap picker
Platform: UNKNOWN
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
Requires-Dist: django
Requires-Dist: python-dateutil

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.

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
-------------

.. code:: 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/>`__ >= 1.8


