Need help with django-bootstrap-datepicker-plus?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

monim67
178 Stars 42 Forks Apache License 2.0 55 Commits 40 Opened issues

Description

Bootstrap3/Bootstrap4 DatePickerInput, TimePickerInput, DateTimePickerInput, MonthPickerInput, YearPickerInput with date-range-picker functionality for django version 2.2, 2.1, 1.11, 1.10 and 1.8

Services available

!
?

Need anything else?

Contributors list

# 222,624
CSS
HTML
Shell
Django
34 commits
# 349,175
Python
HTML
dateran...
Django
9 commits
# 486,765
Python
HTML
dateran...
Django
2 commits
# 699
Python
HTML
Django
localis...
2 commits
# 6,414
React N...
Python
webrtc
webrtc-...
1 commit
# 356,047
dateran...
Django
C
C++
1 commit
# 143,717
Django
Bootstr...
aws-lam...
lambda
1 commit

django-bootstrap-datepicker-plus

This django widget contains Bootstrap 3 and Bootstrap 4 Date-Picker, Time-Picker, DateTime-Picker, Month-Picker and Year-Picker input with date-range-picker functionality for django version 2.1, 2.0, 1.11, 1.10 and 1.8. The widget implements

bootstrap-datetimepicker v4 
_ to show bootstrap-datepicker in django model forms and custom forms which can be configured easily for date-range selection.

| |build-status| |docs-status| |coverage| | |pyversions| |pypi-version| |license|

| |date-picker-image| |datetime-picker-image| |time-picker-image|


Demo


  • With Bootstrap 3 
    _.
  • With Bootstrap 4 
    _.

Getting Started


++++++++++++++++++++ Prerequisites ++++++++++++++++++++

  • Python >= 3.6
  • Django >= 1.8
  • Bootstrap >= 3
  • jquery >= 1.7.1

++++++++++++++++++++ Installing ++++++++++++++++++++

Install the PyPI package via pip

::

pip install django-bootstrap-datepicker-plus

Add

bootstrap_datepicker_plus
to the list of
INSTALLED_APPS
in your
settings.py
file.

.. code:: python

INSTALLED_APPS = [
    # Add the following
    'bootstrap_datepicker_plus',
]

This installation instruction assumes you have

jQuery
and Bootstrap JS/CSS files present in your template and you are using
form.media
in your django template. If not you have to configure your template.

++++++++++++++++++++ Next Steps ++++++++++++++++++++

  • Template configuration 
    _
  • Documentation on ReadTheDocs 
    _
  • Quick Walkthrough Tutorial 
    _
  • I am having errors 
    _

Usage


++++++++++++++++++++++++++++++ Usage in Generic View ++++++++++++++++++++++++++++++

.. code:: python

# File: views.py
from bootstrap_datepicker_plus import DateTimePickerInput
from django.views import generic
from .models import Question

class CreateView(generic.edit.CreateView): model = Question fields = ['question_text', 'pub_date'] def get_form(self): form = super().get_form() form.fields['pub_date'].widget = DateTimePickerInput() return form

++++++++++++++++++++++++++++++ Advanced Usage ++++++++++++++++++++++++++++++

  • Usage in Custom Form 
    _
  • Usage in Model Form 
    _

++++++++++++++++++++++++++++++ Types of DatePickers ++++++++++++++++++++++++++++++

The widget contains all types of date-picker you may ever need.

.. code:: python

# File: forms.py
from bootstrap_datepicker_plus import DatePickerInput, TimePickerInput, DateTimePickerInput, MonthPickerInput, YearPickerInput
from django import forms

class EventForm(forms.ModelForm): class Meta: model = Event fields = ['start_date', 'start_time', 'start_datetime', 'start_month', 'start_year'] widgets = { 'start_date': DatePickerInput(), 'start_time': TimePickerInput(), 'start_datetime': DateTimePickerInput(), 'start_month': MonthPickerInput(), 'start_year': YearPickerInput(), }

++++++++++++++++++++++++++++++ Implement date-range-picker ++++++++++++++++++++++++++++++

DatePickers can be linked to select a date-range or time-range.

.. code:: python

# File: forms.py
from bootstrap_datepicker_plus import DatePickerInput, TimePickerInput
from django import forms

class EventForm(forms.ModelForm): class Meta: model = Event fields = ['name', 'start_date', 'end_date', 'start_time', 'end_time'] widgets = { 'start_date':DatePickerInput().start_of('event days'), 'end_date':DatePickerInput().end_of('event days'), 'start_time':TimePickerInput().start_of('party time'), 'end_time':TimePickerInput().end_of('party time'), }

++++++++++++++++++++++++++++++ Customization ++++++++++++++++++++++++++++++

  • Datepicker Options 
    _
  • Input field HTML template 
    _
  • Language 
    _

Contributing


  • CONTRIBUTING.md 
    _.
  • CODE_OF_CONDUCT.md 
    _.

License


This project is licensed under Apache License 2.0 - see the

LICENSE 
_ file for details.

Acknowledgments


This project implements

Eonasdan/bootstrap-datetimepicker 
_ to display date-pickers. The project was initially forked from
pbucher/django-bootstrap-datepicker 
_.

.. |date-picker-image| image:: https://raw.githubusercontent.com/monim67/django-bootstrap-datepicker-plus/26d89a744d403a895422313a48c02885c4718251/images/date-picker.png :alt: Date-picker :width: 218px :height: 280px

.. |datetime-picker-image| image:: https://raw.githubusercontent.com/monim67/django-bootstrap-datepicker-plus/26d89a744d403a895422313a48c02885c4718251/images/datetime-picker.png :alt: Datetime-picker :width: 218px :height: 280px

.. |time-picker-image| image:: https://raw.githubusercontent.com/monim67/django-bootstrap-datepicker-plus/26d89a744d403a895422313a48c02885c4718251/images/time-picker.png :alt: Time-picker :width: 218px :height: 280px

.. |build-status| image:: https://github.com/monim67/django-bootstrap-datepicker-plus/workflows/build/badge.svg?event=push :target: https://github.com/monim67/django-bootstrap-datepicker-plus/actions?query=build :alt: Build Status :height: 20px

.. |docs-status| image:: https://readthedocs.org/projects/django-bootstrap-datepicker-plus/badge/?version=latest :target: https://django-bootstrap-datepicker-plus.readthedocs.io/en/latest/?badge=latest :alt: Documentation Status :height: 20px

.. |coverage| image:: https://coveralls.io/repos/github/monim67/django-bootstrap-datepicker-plus/badge.svg?branch=master :target: https://coveralls.io/github/monim67/django-bootstrap-datepicker-plus?branch=master :alt: Coverage Status :height: 20px

.. |pyversions| image:: https://img.shields.io/pypi/pyversions/django-bootstrap-datepicker-plus.svg :target: https://pypi.python.org/pypi/django-bootstrap-datepicker-plus :alt: Python Versions :height: 20px

.. |pypi-version| image:: https://badge.fury.io/py/django-bootstrap-datepicker-plus.svg :target: https://pypi.python.org/pypi/django-bootstrap-datepicker-plus :alt: PyPI version :height: 20px

.. |license| image:: https://img.shields.io/pypi/l/django-bootstrap-datepicker-plus.svg :target: https://pypi.python.org/pypi/django-bootstrap-datepicker-plus :alt: Licence :height: 20px

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.