Download this notebook from GitHub (right-click to download).

import datetime as dt
import panel as pn


The DateSlider widget allows selecting selecting a date value within a set bounds using a slider.

For more information about listening to widget events and laying out widgets refer to the widgets user guide. Alternatively you can learn how to build GUIs by declaring parameters independently of any specific widgets in the param user guide. To express interactivity entirely using Javascript without the need for a Python server take a look at the links user guide.


For layout and styling related parameters see the customization user guide.


  • as_datetime: Whether to return value as a date (default) or datetime

  • start (date or datetime): The range’s lower bound

  • end (date or datetime): The range’s upper bound

  • value (date or datetime): The selected value as a datetime type

  • value_throttled (datetime): The selected value as a datetime type throttled until mouseup

  • step (number): The selected step i the slider in milliseconds


  • bar_color (color): Color of the slider bar as a hexadecimal RGB value

  • direction (str): Whether the slider should go from left to right (‘ltr’) or right to left (‘rtl’)

  • disabled (boolean): Whether the widget is editable

  • name (str): The title of the widget

  • orientation (str): Whether the slider should be displayed in a ‘horizontal’ or ‘vertical’ orientation.

  • tooltips (boolean): Whether to display tooltips on the slider handle

  • format (string): The datetime’s format

date_slider = pn.widgets.DateSlider(name='Date Slider', start=dt.datetime(2019, 1, 1), end=dt.datetime(2019, 6, 1), value=dt.datetime(2019, 2, 8))


DateSlider.value returns a datetime type that can be read out or set like other widgets:

datetime.datetime(2019, 2, 8, 0, 0)


The DateSlider widget exposes a number of options which can be changed from both Python and Javascript. Try out the effect of these parameters interactively:

pn.Row(date_slider.controls(jslink=True), date_slider)
This web page was generated from a Jupyter notebook and not all interactivity will work on this website. Right click to download and run locally for full Python-backed interactivity.

Download this notebook from GitHub (right-click to download).