django-bootstrap3-datetimepicker-3's Introduction

django-bootstrap3-datetimepicker

This package uses Bootstrap v3 datetimepicker widget version 4.

This project was originally a fork of tutorcruncher/django-bootstrap3-datetimepicker, it now has the following breaking changes:

Modified to work properly with Django 1.11 (didn't take into account previous versions)
js/css files are no longer included in the project, managing them is up to the user, eg. using grablib.
the widget no longer has js/css assets. these are left for you to deploy as you wish.
bug/warning fixes
remove support for python 2.6 and associated clean up

Install

pip install django-bootstrap3-datetimepicker-3

Example

forms.py

from bootstrap3_datetime.widgets import DateTimePicker
from django import forms

  class ToDoForm(forms.Form):
      todo = forms.CharField(
          widget=forms.TextInput(attrs={"class": "form-control"}))
      date = forms.DateField(
          widget=DateTimePicker(options={"format": "YYYY-MM-DD"}))
      reminder = forms.DateTimeField(
          required=False,
          widget=DateTimePicker(options={"format": "YYYY-MM-DD HH:mm"}))

The options will be passed to the JavaScript datetimepicker instance. Available options are explained in the following documents:

http://eonasdan.github.io/bootstrap-datetimepicker/

You don't need to set the language option, because it will be set the current language of the thread automatically.

template.html

<!DOCTYPE html>
<html>
  <head>
    <!-- load all required js/css yourself here -->
  </head>
  <body>
    <form method="post" role="form">
      {{ form|bootstrap }}
      {% csrf_token %}
      <div class="form-group">
        <input type="submit" value="Submit" class="btn btn-primary" />
      </div>
    </form>
  </body>
</html>