Skip to main content

mo.ui.date

Create a date picker for selecting dates.

Signature

mo.ui.date(
    start: date | str | None = None,
    stop: date | str | None = None,
    value: date | str | None = None,
    *,
    label: str = "",
    on_change: Callable[[date], None] | None = None,
    full_width: bool = False,
    disabled: bool = False
)

Parameters

start
date | str
Minimum selectable date
stop
date | str
Maximum selectable date
value
date | str
Initially selected date
label
str
default:"''"
Markdown label for the date picker
disabled
bool
default:"False"
Whether the date picker is disabled
full_width
bool
default:"False"
Whether date picker takes full width

Examples

import marimo as mo
from datetime import date, timedelta

# Basic date picker
selected_date = mo.ui.date(label="**Select a date:**")
selected_date
# Date range
today = date.today()
date_picker = mo.ui.date(
    start=today,
    stop=today + timedelta(days=30),
    value=today,
    label="Appointment date"
)
# Use the value
mo.md(f"You selected: {selected_date.value}")
For selecting date ranges, use mo.ui.date_range() instead.

Build docs developers (and LLMs) love