Date#

class marimo.ui.date(start: dt.date | str | None = None, stop: dt.date | str | None = None, value: dt.date | str | None = None, *, label: str = '', on_change: Callable[[dt.date], None] | None = None)#

A date picker with an optional start and stop date.

Example.

# initialize the date picker at a given date
date = mo.ui.date(value="2022-01-01")
# when value is omitted, date picker initializes with today's date
date = mo.ui.date()
# create a date picker with bounds
date = mo.ui.date(
    value="2022-06-01",
    start="2022-01-01",
    stop="2022-12-31",
)

Attributes.

  • value: a str (YYYY-MM-DD) or datetime.date object of the chosen date

  • start: the start date

  • stop: the stop date

Initialization Args.

  • start: minimum date selectable; if None, defaults to 01-01-0001

  • stop: maximum date selectable; if None, defaults to 12-31-9999

  • value: default date

    • if None and start and stop are None, defaults to the current day;

    • else if None and start is not None, defaults to start;

    • else if None and stop is not None, defaults to stop

  • label: text label for the element

  • on_change: optional callback to run when this element’s value changes

Public methods

Inherited from UIElement

form([label])

Create a submittable form out of this UIElement.

Inherited from Html

batch(**elements)

Convert an HTML object with templated text into a UI element.

center()

Center an item.

right()

Right-justify.

left()

Left-justify.

callout([kind])

Create a callout containing this HTML element.

Public Data Attributes:

DATEFORMAT

start

stop

Inherited from UIElement

value

The element’s current value.

Inherited from Html

text

A string of HTML representing this element.