Skip to content

Latest commit

 

History

History
87 lines (59 loc) · 2.21 KB

README.rst

File metadata and controls

87 lines (59 loc) · 2.21 KB
Raw

Nepali DateTime Field

Highly motivated package from Django's DateField & DateTimeField. The library is intended to provide Bikram Sambat Date Time fields for Django's Model and Form.

Note: Currently only supports DateField. DateTimeField will be supported soon in future releases.

The package is dependent on nepali-datetime package and the UI for the date picker is implemented from https://github.com/leapfrogtechnology/nepali-date-picker.

Supports: Django 2.0+

Installation

$ pip install django-nepali-datetime-field

Quick start

  1. Add nepali_datetime_field to your INSTALLED_APPS list:

    INSTALLED_APPS = [
    ...
    'nepali_datetime_field',
]

  2. Importing NepaliDateField model field to models.py file:

    from nepali_datetime_field.models import NepaliDateField

class YourModel(models.Model):
    ...
    nepali_date = NepaliDateField()

  3. Importing NepaliDateField form field to forms.py file:

    from nepali_datetime_field.forms import NepaliDateField

class YourForm(forms.Form):
    ...
    nepali_date = NepaliDateField()

  4. Whenever using NepaliDateField form field, don't forget to add Widget's media on the <head> section of the html as below:

    <html>
<head>
...
{{ form.media }}
...
</head>
<body>
...
{{ form }}
...
</body>
</html>

  5. Querying the model field:

    import nepali_datetime

nepali_date = nepali_datetime.date(1995,10,1)

# get query
YourModel.objects.get(nepali_date=nepali_date)

# filter query
YourModel.objects.filter(nepali_date=nepali_date)

# date range query
from_date = nepali_datetime.date(1990,1,1)
to_date = nepali_datetime.date(1999,12,30)
YourModel.objects.filter(nepali_date__range=(from_date, to_date))

More Usage

Check some of the usage details in example_app/tests.py.

Demo

Play around with the live demo here.