DatetimeInput#

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

import datetime as dt
import panel as pn

pn.extension()

The DatetimeInput widget allows entering a datetime value as text and parsing it using a pre-defined formatter.

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.

Parameters:#

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

Core#

start (datetime): Lower bound
end (datetime): Upper bound
value (datetime): Parsed datetime value

Display#

disabled (boolean): Whether the widget is editable
format (str): Datetime formatting string that determines how the value is formatted and parsed (default='%Y-%m-%d %H:%M:%S')
name (str): The title of the widget

The datetime parser uses the defined format to validate the input value, if the entered text is not a valid datetime a warning will be shown in the title as “(invalid)”:

dt_input = pn.widgets.DatetimeInput(name='Datetime Input', value=dt.datetime(2019, 2, 8))

dt_input

DatetimeInput.value returns a datetime object and can be accessed and set like other widgets:

dt_input.value

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

Controls#

The DateTimeInput 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(dt_input.controls(jslink=True), dt_input)

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