Open this notebook in Jupyterlite | 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.

Discover more on using widgets to add interactivity to your applications in the how-to guides on interactivity. Alternatively, learn how to set up callbacks and (JS-)links between parameters or how to use them as part of declarative UIs with Param.


For details on other options for customizing the component see the layout and styling how-to guides.


  • 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)

Open this notebook in Jupyterlite | Download this notebook from GitHub (right-click to download).