Date Picker¶
Last Updated: August 10, 2015
- class tethys_sdk.gizmos.DatePicker(name, display_text='', autoclose=False, calendar_weeks=False, clear_button=False, days_of_week_disabled='', end_date='', format='', min_view_mode='days', multidate=1, start_date='', start_view='month', today_button=False, today_highlight=False, week_start=0, initial='', disabled=False, error='', attributes={}, classes='')¶
Date pickers are used to make the input of dates streamlined and easy. Rather than typing the date, the user is presented with a calendar to select the date. This date picker was implemented using Bootstrap Datepicker.
- name¶
Name of the input element that will be used for form submission.
- Type
str, required
- display_text¶
Display text for the label that accompanies date picker.
- Type
str
- autoclose¶
Set whether datepicker auto closes when a date is selected.
- Type
bool
- calendar_weeks¶
Set whether calendar week numbers are shown on the left of the datepicker.
- Type
bool
- clear_button¶
Set whether the clear button is displayed or not.
- Type
bool
- days_of_week_disabled¶
Days of the week that are disabled 0-6 with 0 being Sunday and 6 being Saturday. Multiple days are comma separated (e.g.: '0,6').
- Type
str
- end_date¶
Last date that can be selected. All other dates after this date are shown as disabled.
- Type
str
- format¶
String representing date format. For valid formats see Bootstrap Datepicker documentation here.
- Type
str
- min_view_mode¶
Set the minimum view mode. Possible values are 'days', 'months', 'years'.
- Type
str
- multidate¶
Enables multi-selection of dates up to the number given.
- Type
int
- start_date¶
First date that can be selected. All other dates before this date are shown as disabled.
- Type
str
- start_view¶
View the date picker starts on. Valid values include 'month', 'year', and 'decade'.
- Type
str
- today_button¶
Set whether a today button is displayed or not.
- Type
bool
- today_highlight¶
Set whether to highlight the current date.
- Type
bool
- week_start¶
Set the day the week starts on 0-6, where 0 is Sunday and 6 is Saturday.
- Type
int
- initial¶
Initial date to appear in date picker.
- Type
str
- disabled¶
Disabled state of the date picker.
- Type
bool
- error¶
Error message for form validation.
- Type
str
- attributes¶
A dictionary representing additional HTML attributes to add to the primary element (e.g. {"onclick": "run_me();"}).
- Type
dict
- classes¶
Additional classes to add to the primary HTML element (e.g. "example-class another-class").
- Type
str
Controller Example
from tethys_sdk.gizmos import DatePicker # Date Picker Options date_picker = DatePicker(name='date1', display_text='Date', autoclose=True, format='MM d, yyyy', start_date='2/15/2014', start_view='decade', today_button=True, initial='February 15, 2014') date_picker_error = DatePicker(name='data2', display_text='Date', initial='10/2/2013', disabled=True, error='Here is my error text.') context = { 'date_picker': date_picker, 'date_picker_error': date_picker_error, }
Template Example
{% load tethys_gizmos %} {% gizmo date_picker %} {% gizmo date_picker_error %}