monim67/django-bootstrap-datepicker-plusPublic

NotificationsYou must be signed in to change notification settings
Fork62
Star222

Bootstrap3/Bootstrap4/Bootstrap5 DatePickerInput, TimePickerInput, DateTimePickerInput, MonthPickerInput, YearPickerInput with date-range-picker functionality for django >= 2.0

pypi.python.org/pypi/django-bootstrap-datepicker-plus

License

MIT license

222 stars 62 forks Branches Tags Activity

Star

Notifications

You must be signed in to change notification settings

Branches Tags

Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 98 Commits
.github		.github
.vscode		.vscode
dev		dev
docs		docs
src/bootstrap_datepicker_plus		src/bootstrap_datepicker_plus
tests		tests
.env.defaults		.env.defaults
.gitignore		.gitignore
.pre-commit-config.yaml		.pre-commit-config.yaml
.readthedocs.yaml		.readthedocs.yaml
LICENSE		LICENSE
README.rst		README.rst
poetry.lock		poetry.lock
pyproject.toml		pyproject.toml

Repository files navigation

django-bootstrap-datepicker-plus

This django widget contains Bootstrap 3, Bootstrap 4 and Bootstrap 5Date-Picker, Time-Picker, DateTime-Picker, Month-Picker and Year-Picker inputwith date-range-picker functionality for django version >= 2.0.The widget implementsbootstrap-datetimepicker v4to show bootstrap-datepicker in django model forms and custom formswhich can be configured easily for date-range selection.

If you are not using Bootstrap usedjango-flatpickr instead.

Demo

Getting Started

Follow theGetting Started doc.
Head over toUsage section to see how to use it in forms and views.
Read detailedDocumentation on ReadTheDocs
Looks complex to get started? Follow aQuick Walkthrough Tutorial
Getting errors? SeeTroubleshoot instructions

Usage

Usage in Generic View

# File: views.pyfrombootstrap_datepicker_plus.widgetsimportDateTimePickerInputfromdjango.viewsimportgenericfrom .modelsimportQuestionclassCreateView(generic.edit.CreateView):model=Questionfields= ["question_text","pub_date"]defget_form(self):form=super().get_form()form.fields["pub_date"].widget=DateTimePickerInput()returnform

Advanced Usage

Types of DatePickers

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

# File: forms.pyfrombootstrap_datepicker_plus.widgetsimportDatePickerInput,TimePickerInput,DateTimePickerInput,MonthPickerInput,YearPickerInputfromdjangoimportformsclassEventForm(forms.ModelForm):classMeta:model=Eventfields= ["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.

# File: forms.pyfrombootstrap_datepicker_plus.widgetsimportDatePickerInput,TimePickerInputfromdjangoimportformsclassEventForm(forms.ModelForm):classMeta:model=Eventfields= ["name","start_date","end_date","start_time","end_time"]widgets= {"start_date":DatePickerInput(),"end_date":DatePickerInput(range_from="start_date"),"start_time":TimePickerInput(),"end_time":TimePickerInput(range_from="start_time"),        }

Customization

Contributing

License

This project is licensed underMIT LICENSE file for details.

Acknowledgments

This project implementsEonasdan/bootstrap-datetimepicker to display date-pickers.The project was initially forked frompbucher/django-bootstrap-datepicker andlater reworked completely under MIT Licence.

About

Bootstrap3/Bootstrap4/Bootstrap5 DatePickerInput, TimePickerInput, DateTimePickerInput, MonthPickerInput, YearPickerInput with date-range-picker functionality for django >= 2.0

pypi.python.org/pypi/django-bootstrap-datepicker-plus