Date Picker¶
Use a date picker to pick a date within a range. A date picker is a compact form of the calendar.
Basic¶
Set mode='date' to show a date-picker.
Set initial date¶
Set value= to pre-select a date.
Dates must be in ISO 8601 format. Date-only strings (e.g. "1970-01-01") are treated as UTC, not local.
Set placeholder text¶
Set placeholder= to show placeholder text.
date = view(box('Deliver on', mode='date', placeholder='Delivery date'))
view(f'You picked {date}.')
Set min date¶
Set min= to specify a minimum date.
date = view(box('Pick a date', mode='date', value='2021-10-10', min='2019-01-01'))
view(f'You picked {date}.')
Set max date¶
Set max= to specify a maximum date.
date = view(box('Pick a date', mode='date', value='2021-10-10', max='2022-12-31'))
view(f'You picked {date}.')
Combine min and max date¶
Set both min= and max= to restrict selection between two dates.
date = view(box('Pick a date', mode='date', value='2021-10-10', min='2019-01-01', max='2022-12-31'))
view(f'You picked {date}.')
Set range¶
Set range= to a (min, max) tuple to restrict selection between two dates.
This is a shorthand notation for setting min= and max= individually.
date = view(box('Pick a date', mode='date', value='2021-10-10', range=('2019-01-01', '2022-12-31')))
view(f'You picked {date}.')
Mark as required¶
Add required to mode to indicate that input is required.
Handle changes immediately¶
Add live to mode to handle changes immediately.
date = '2021-10-10' # Initial value (UTC)
while True:
date = view(
box('Pick a date', mode='live date', value=date),
f'You picked {date} (UTC).',
)
Disable¶
Set disabled=True to disable.
