Package: django-datetime-widget
django-datetime-widget======================.. image:: https://pypip.in/v/django-datetime-widget/badge.png:target: https://crate.io/packages/django-datetime-widget.. image:: https://pypip.in/d/django-datetime-widget/badge.png:target: https://crate.io/packages/django-datetime-widget``django-datetime-widget``  is a simple and clean picker widget for DateField, Timefiled and DateTimeField in Django framework. It is based on `Bootstrap datetime picker<https://github.com/smalot/bootstrap-datetimepicker>`_, supports both Bootstrap 3 and Bootstrap 2 .``django-datetime-widget`` is perfect when you use a DateField, TimeField or DateTimeField in your model/form where is necessary to display the corresponding picker with a specific date/time format. Now it support django localization.Available widgets-----------------*  **DateTimeWidget** : display the input with the calendar and time picker.*  **DateWidget** : display the input only with the calendar picker.*  **TimeWidget** : display the input only with the time picker.`See Demo page <http://bit.ly/django-datetime-widget-demo-page>`_Requirements------------* `Bootstrap  <http://getbootstrap.com/>`_ 2.0.4+ and 3.2.0* `jQuery <http://jquery.com/>`_ 1.7.1+Screenshots===========* Decade year view.. image:: https://raw.github.com/smalot/bootstrap-datetimepicker/master/screenshot/standard_decade.pngThis view allows to select the year in a range of 10 years.* Year view.. image:: https://raw.github.com/smalot/bootstrap-datetimepicker/master/screenshot/standard_year.pngThis view allows to select the month in the selected year.* Month view.. image:: https://raw.github.com/smalot/bootstrap-datetimepicker/master/screenshot/standard_month.pngThis view allows to select the day in the selected month.* Day view.. image:: https://raw.github.com/smalot/bootstrap-datetimepicker/master/screenshot/standard_day.pngThis view allows to select the hour in the selected day.* Hour view.. image:: https://raw.github.com/smalot/bootstrap-datetimepicker/master/screenshot/standard_hour.pngThis view allows to select the preset of minutes in the selected hour.The range of 5 minutes (by default) has been selected to restrict buttons quantity to an acceptable value, but it can be overrided by the <code>minuteStep</code> property.* Day view - meridian.. image:: https://raw.github.com/smalot/bootstrap-datetimepicker/master/screenshot/standard_day_meridian.pngMeridian is supported in both the day and hour views.To use it, just enable the <code>showMeridian</code> property.* Hour view - meridian.. image:: https://raw.github.com/smalot/bootstrap-datetimepicker/master/screenshot/standard_hour_meridian.pngInstallation------------#. Install django-datetime-widget using pip. For example::pip install django-datetime-widget#. Add  ``datetimewidget`` to your INSTALLED_APPS.If you want to use localization:#. Set USE_L10N = True, USE_TZ = True  and USE_I18N = True in settings.py#. Add 'django.middleware.locale.LocaleMiddleware' to MIDDLEWARE_CLASSES in settings.py#. When you create the widget add usel10n = True like attribute : DateTimeWidget(usel10n=True)Basic Configuration-------------------#. Create your model-form and set  DateTimeWidget widget to your DateTimeField  ::from datetimewidget.widgets import DateTimeWidgetclass yourForm(forms.ModelForm):class Meta:model = yourModelwidgets = {#Use localization and bootstrap 3'datetime': DateTimeWidget(attrs={'id':"yourdatetimeid"}, usel10n = True, bootstrap_version=3)}#. Download `twitter bootstrap <http://getbootstrap.com/>`_  to your static file folder.#. Add in your form template links to jquery, bootstrap and form.media::<head>....<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.8.3/jquery.min.js"></script><link href="{{ STATIC_URL }}css/bootstrap.css" rel="stylesheet" type="text/css"/><script src="{{ STATIC_URL }}js/bootstrap.js"></script>{{ form.media }}....</head><body><form  action="" method="POST">{% csrf_token %}{{ form.as_table }}<input id="submit" type="submit" value="Submit"></form></body>#. Optional: you can add option dictionary to DatetimeWidget to customize your input, for example to have date time with meridian::dateTimeOptions = {'format': 'dd/mm/yyyy HH:ii P','autoclose': True,'showMeridian' : True}widgets = {#NOT Use localization and set a default format'datetime': DateTimeWidget(options = dateTimeOptions)}!!! If you add 'format' into options and in the same time set usel10n as True the first one is ignored. !!!Options=======The options attribute can accept the following:* formatString.  Default: 'dd/mm/yyyy hh:ii'The date format, combination of  P, hh, HH , ii, ss, dd, yy, yyyy.* P : meridian in upper case ('AM' or 'PM') - according to locale file* ss : seconds, 2 digits with leading zeros* ii : minutes, 2 digits with leading zeros* hh : hour, 2 digits with leading zeros - 24-hour format* HH : hour, 2 digits with leading zeros - 12-hour format* dd : day of the month, 2 digits with leading zeros* yy : two digit representation of a year* yyyy : full numeric representation of a year, 4 digits* weekStartInteger.  Default: 0Day of the week start. '0' (Sunday) to '6' (Saturday)* startDateDate.  Default: Beginning of timeThe earliest date that may be selected; all earlier dates will be disabled.* endDateDate.  Default: End of timeThe latest date that may be selected; all later dates will be disabled.* daysOfWeekDisabledString.  Default:  ''Days of the week that should be disabled. Values are 0 (Sunday) to 6 (Saturday). Multiple values should be comma-separated. Example: disable weekends:  '0,6'.* autocloseString.  Default: 'true'Whether or not to close the datetimepicker immediately when a date is selected.* startViewInteger.  Default: 2The view that the datetimepicker should show when it is opened.Accepts values of :* '0'  for the hour view* '1'  for the day view* '2'  for month view (the default)* '3'  for the 12-month overview* '4'  for the 10-year overview. Useful for date-of-birth datetimepickers.* minViewInteger. Default: 0The lowest view that the datetimepicker should show.* maxViewInteger. Default: 4The highest view that the datetimepicker should show.* todayBtnBoolean.  Default: FalseIf true , displays a "Today" button at the bottom of the datetimepicker to select the current date.  If true, the "Today" button will only move the current date into view.* todayHighlightBoolean.  Default: FalseIf true, highlights the current date.* minuteStepInteger.  Default: 5The increment used to build the hour view. A button is created for each <code>minuteStep</code> minutes.* pickerPositionString. Default: 'bottom-right' (other supported value : 'bottom-left')This option allows to place the picker just under the input field for the component implementation instead of the default position which is at the bottom right of the button.* showMeridianBoolean. Default: FalseThis option will enable meridian views for day and hour views.* clearBtnBoolean.  Default: FalseIf true, displays a "Clear" button at the rigth side of the input value.CHANGELOG---------* 0.9.3V* FIX #48* Python 3 support* 0.9.2V* FIX #46* 0.9.1V* python options are correct converted to the javascript options.* FIX #38 #40.* code refactor and bug fixes.* 0.9V* Update bootstrap datetime picker to the last version.* CLOSE #20 (support bootstrap 2 and 3).* CLOSE #17 TimeWidget.* CLOSE #16 DateWidget.* new clear button at the rigth side of the input value.* add dateTimeExample django project.* 0.6V* Add Clear button* Fix TypeError bug* Support localization* Update static file with last commit of bootstrap-datetime-picker* update js lib, native localization, thanks to @quantum13* autoclose is true by defaultContribute----------1. Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug. There is a `Contributor Friendly`_ tag for issues that should be ideal for people who are not very familiar with the codebase yet.* If you feel uncomfortable or uncertain about an issue or your changes, feel free to email @asaglimbeni and he will happily help you via email, Skype, remote pairing or whatever you are comfortable with.2. Fork develop branch from `the repository`_ on GitHub to start making your changes to the **develop** branch (or branch off of it).3. Please, shows that the bug was fixed or that the feature works as expected.4. Send a pull request and bug the maintainer until it gets merged and published. :)5. Your changes will be released on the next version of django_datetime_widget!.. _`the repository`: https://github.com/asaglimbeni/django-datetime-widget.. _Contributor Friendly: https://github.com/asaglimbeni/django-datetime-widget/issues?direction=desc&labels=Contributor+Friendly&page=1&sort=updated&state=openTODO----#. widget for DateTime range.