A Django widget for the Tempus Dominus Bootstrap 4 DateTime picker.
Project description
Django Tempus Dominus
Django Tempus Dominus provides Django widgets for the Tempus Dominus Bootstrap 4 DateTime date and time picker. Why yet another date and time picker for Django? None supported the Tempus Dominus date and time picker, which is actively developed and feature rich. It is a successor to the popular bootstrap-datetimepicker JavaScript library.
Installation
-
From PyPI:
pip install django-tempus-dominus -
From source:
git clone git+https://github.com/FlipperPA/django-tempus-dominus.git
pip install -e django-tempus-dominus
Usage & Settings
A Django setting is provided to use the browser's localized date and time configuration:
TEMPUS_DOMINUS_LOCALIZE(default:False): ifTrue, widgets will be translated to the selected browser language and use the localized date and time formats.
Three widgets are provided:
DatePicker- Defaults to
YYYY-MM-DD - Defaults to
LifTEMPUS_DOMINUS_LOCALIZEis True
- Defaults to
DateTimePicker- Defaults to
YYYY-MM-DD HH:mm:ss - Defaults to
L LTSifTEMPUS_DOMINUS_LOCALIZEis True
- Defaults to
TimePicker- Defaults to
HH:mm:ss - Defaults to
LTSifTEMPUS_DOMINUS_LOCALIZEis True
- Defaults to
In your Django form, you can use the widgets like this:
import datetime
from django import forms
from tempus_dominus.widgets import DatePicker, TimePicker, DateTimePicker
class MyForm(forms.Form):
date_field = forms.DateField(widget=DatePicker())
date_field_required_with_min_max_date = forms.DateField(
required=True,
widget=DatePicker(
options={
'minDate': '2009-01-20',
'maxDate': '2017-01-20',
}
),
)
time_field = forms.TimeField(
widget=TimePicker(
options={
'enabledHours': [9, 10, 11, 12, 13, 14, 15, 16],
}
),
)
datetime_field = forms.DateTimeField(
widget=DateTimePicker(
options={
'minDate': (datetime.date.today() + datetime.timedelta(days=1)).strftime('%Y-%m-%d'), # Tomorrow
'useCurrent': True,
'collapse': False,
}
),
)
The options dictionary will be passed to Tempus Dominus. A full list of options is available here.
Then in your template, include jQuery, {{ form.media }}, and render the form:
<html>
<head>
<script crossorigin="anonymous" integrity="sha384-xBuQ/xzmlsLoJpyjoggmTEz8OWUFM0/RC5BsqQBDX2v5cMvDHcMakNTNrHIW2I5f" src="https://code.jquery.com/jquery-3.2.1.min.js"></script>
{{ form.media }}
</head>
<body>
<form method="post" action=".">
{% csrf_token %}
{{ form.as_p }}
</form>
</body>
</html>
Change Log
- 5.0.1.2: Documentation clean up.
- 5.0.1.1: Option to l10n and i18n to all pickers (thank you, @AxTheB).
- 5.0.1.0: Upgrade to Tempus Dominus full release version
5.0.1. Fix bug for populating initial values (thank you, @ianastewart). - 0.1.2: UX enhancement: auto-dismiss dialog if the input loses focus.
- 0.1.1: Bug fixes.
- 0.1.0: Initial release.
Maintainer
- Timothy Allen (https://github.com/FlipperPA)
Contributors (Thank You!)
- Ian Stewart (https://github.com/ianastewart)
- Václav 'ax' Hůla (https://github.com/AxTheB)
- waymou (https://github.com/waymao)
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django-tempus-dominus-5.0.1.2.tar.gz
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 2f5832713decd45d612a40d13f8920c11451284e577eb98a9108995aafcc4324 |
|
| MD5 | 968ca7d5ec680aebf231e7be29eed61c |
|
| BLAKE2b-256 | a10aefab6703109abc1ff2370f6560bfc84e90ef4e63da13ce08b53804566da8 |
Hashes for django_tempus_dominus-5.0.1.2-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 5266b725f8bb4811074a856b3c26b79f498b8deac0ff9ec3886ee84278648d9e |
|
| MD5 | 23930cb17c28ee3c4b61ac113158541a |
|
| BLAKE2b-256 | 63311021a424bd16ebc4683e69179c01f471355c28fdad78822cdb3b51497d53 |
