Date

Date picker input

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.