Bootstrap3 compatible datetimepicker for Django projects.
Project description
- This package uses Bootstrap v3 datetimepicker widget version 2 provided by the following project:
- The correct formatting options for dates can be found here:
It works only with Bootstrap3. If you are using Bootstrap2 in your Django project, check out this: https://github.com/zokis/django-bootstrap-datetimepicker
Install
Run pip install django-bootstrap3-datetimepicker
Add 'bootstrap3_datetime' to your INSTALLED_APPS
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",
"pickTime": False}))
reminder = forms.DateTimeField(
required=False,
widget=DateTimePicker(options={"format": "YYYY-MM-DD HH:mm",
"pickSeconds": False}))
The options will be passed to the JavaScript datetimepicker instance. Available options are explained in the following documents:
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>
<link rel="stylesheet"
href="//netdna.bootstrapcdn.com/bootstrap/3.0.0/css/bootstrap.css">
<link rel="stylesheet"
href="//netdna.bootstrapcdn.com/bootstrap/3.0.0/css/bootstrap-theme.css">
<script src="//ajax.googleapis.com/ajax/libs/jquery/1.9.0/jquery.js">
</script>
<script src="//netdna.bootstrapcdn.com/bootstrap/3.0.0/js/bootstrap.js">
</script>
{{ form.media }}
</head>
<body>
<form method="post" role="form">
{% for field in form.visible_fields %}
<div id="div_{{ field.html_name }}"
class="form-group{% if field.errors %} has-error{% endif %}">
{{ field.label_tag }}
{{ field }}
<div class="text-muted pull-right">
<small>{{ field.help_text }}</small>
</div>
<div class="help-block">
{{ field.errors }}
</div>
</div>
{% endfor %}
{% for hidden in form.hidden_fields %}
{{ hidden }}
{% endfor %}
{% csrf_token %}
<div class="form-group">
<input type="submit" value="Submit" class="btn btn-primary" />
</div>
</form>
</body>
</html>
Bootstrap3 and jQuery have to be included along with {{ form.media }}
Release Notes
v2.2.3
Updated bootstrap-datetimepicker.js to version 2.1.30
v2.0.0
Includes bootstrap-datetimepicker.js version 2.1.11 with moment.js
The format strings have changed due to using moment.js
Requirements
Python >= 2.4
Django >= 1.3
Bootstrap >= 3.0
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for django-bootstrap3-datetimepicker-2.2.3.tar.gz
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | a4239a86e13187c213a4b73408216c8c743bbaa6b4366c5089c92496b74a8ba3 |
|
| MD5 | aa3ebcb31d4d637a97d60d55c2f47de9 |
|
| BLAKE2b-256 | 5b34d885178ae5859ad1e218e156e36b35a16de1a7f27b3fb5bce94552ec1578 |
