django-flatpickr

This django widget contains Date-Picker, Time-Picker, DateTime-Picker input widgets with date-range-picker functionality for django version >= 2.0. The widget implements flatpickr to display date-pickers in django model forms and custom forms which can be configured easily for date-range selection. For Bootstrap date-picker see django-bootstrap-datepicker-plus.

Demo

• Custom Form.
• Model Form.
• Generic View (without Model Form).
• With django-crispy-forms.
• With django-filter.
• With dynamic formsets.
• In a Modal Window.

Getting Started

• Follow the Getting Started documentation.
• Pass llms.txt/llms-full.txt to your coding agent.

Usage

Usage in Custom Form

# File: forms.py
from django_flatpickr.widgets import DatePickerInput, TimePickerInput, DateTimePickerInput
from .models import Event
from django import forms

class ToDoForm(forms.Form):
    todo = forms.CharField(widget=forms.TextInput())
    date = forms.DateField(widget=DatePickerInput())
    time = forms.TimeField(widget=TimePickerInput())
    datetime = forms.DateTimeField(widget=DateTimePickerInput())

• Usage in Model Form.
• Usage in Generic View (without a Model Form).

Implement date-range-picker

DatePickers can be linked together to select a date-range, time-range or date-time-range without writing a single line of JavaScript.

# File: forms.py
from django_flatpickr.widgets 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(),
            "end_date": DatePickerInput(range_from="start_date"),
            "start_time": TimePickerInput(),
            "end_time": TimePickerInput(range_from="start_time"),
        }

• Read the full Usage doc for django-filter, django-crispy-forms, dynamic formsets and modal examples.

Customization

• Customize options, theme and localization.
• Use a custom template for the widget input.

Contributing

• CONTRIBUTING.md.
• CODE_OF_CONDUCT.md.

License

This project is licensed under the MIT LICENSE.