Help us shape the future of Go! Take the 2026 Go Developer Survey

datepicker

package
v0.0.4 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 7, 2026 License: MIT Imports: 16 Imported by: 0

Documentation

Overview

Package datepicker provides date pickers loosely based on Material 3.

Docked is a text field that opens a calendar. Modal opens that calendar in a dialog. ModalDateInput opens a dialog for typing a date and can switch to the same calendar. All three read and write a Date.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Date 

type Date struct {
	Year  int
	Month time.Month
	Day   int
}

Date is a calendar day without a time of day or location. The zero value is an unset date.

func DateFromTime 

func DateFromTime(t time.Time) Date

DateFromTime returns the year, month, and day of t in t's location.

func Today 

func Today() Date

Today returns the current local date.

func (Date) Compare 

func (d Date) Compare(o Date) int

Compare returns -1 if d is before o, 0 if they are equal, and +1 if d is after o.

func (Date) Equal 

func (d Date) Equal(o Date) bool

Equal reports whether d and o are the same day.

func (Date) IsZero 

func (d Date) IsZero() bool

IsZero reports whether d is the unset date.

func (Date) String 

func (d Date) String() string

String returns d in ISO-8601 form (2006-01-02). The zero date is "".

func (Date) Time 

func (d Date) Time() time.Time

Time returns local midnight on d.

func (Date) Valid 

func (d Date) Valid() bool

Valid reports whether d is a real calendar day (for example, 2026-02-30 is not).

type Docked 

type Docked struct {
	guigui.DefaultWidget
	// contains filtered or unexported fields
}

Docked is a text field that opens a calendar dropdown, matching the Material 3 docked date picker: month and year menus, previous/next month, weekday headings, a six-week day grid, and Cancel/OK.

func (*Docked) Build 

func (d *Docked) Build(context *guigui.Context, adder *guigui.ChildAdder) error

func (*Docked) HandleButtonInput 

func (d *Docked) HandleButtonInput(context *guigui.Context, widgetBounds *guigui.WidgetBounds) guigui.HandleInputResult

func (*Docked) Layout 

func (d *Docked) Layout(context *guigui.Context, widgetBounds *guigui.WidgetBounds, layouter *guigui.ChildLayouter)

func (*Docked) Measure 

func (d *Docked) Measure(context *guigui.Context, constraints guigui.Constraints) image.Point

func (*Docked) OnValueChanged 

func (d *Docked) OnValueChanged(f func(context *guigui.Context, date Date))

OnValueChanged sets the handler invoked when the user confirms a date.

func (*Docked) SetFirstWeekday 

func (d *Docked) SetFirstWeekday(day time.Weekday)

SetFirstWeekday sets the first column of the calendar. The default is Sunday.

func (*Docked) SetMaxDate 

func (d *Docked) SetMaxDate(date Date)

SetMaxDate sets the latest selectable date. The zero value leaves it unbounded.

func (*Docked) SetMinDate 

func (d *Docked) SetMinDate(date Date)

SetMinDate sets the earliest selectable date. The zero value leaves it unbounded.

func (*Docked) SetPlaceholder 

func (d *Docked) SetPlaceholder(placeholder string)

SetPlaceholder sets the placeholder shown while no date is selected.

func (*Docked) SetValue 

func (d *Docked) SetValue(date Date)

SetValue sets the committed date. The zero value clears the selection.

func (*Docked) Tick 

func (d *Docked) Tick(context *guigui.Context, widgetBounds *guigui.WidgetBounds) error

func (*Docked) Value 

func (d *Docked) Value() Date

Value returns the committed date. The zero value means no date is selected. 

type Modal struct {
	guigui.DefaultWidget
	// contains filtered or unexported fields
}

Modal is a button that opens a modal calendar dialog. The calendar matches the Material 3 docked date picker (month/year menus, day grid, OK/Cancel) and adds a headline plus a toggle into text-input mode.

func (*Modal) Build 

func (m *Modal) Build(context *guigui.Context, adder *guigui.ChildAdder) error

func (*Modal) HandleButtonInput 

func (m *Modal) HandleButtonInput(context *guigui.Context, widgetBounds *guigui.WidgetBounds) guigui.HandleInputResult

func (*Modal) IsOpen 

func (m *Modal) IsOpen() bool

func (*Modal) Layout 

func (m *Modal) Layout(context *guigui.Context, widgetBounds *guigui.WidgetBounds, layouter *guigui.ChildLayouter)

func (*Modal) Measure 

func (m *Modal) Measure(context *guigui.Context, constraints guigui.Constraints) image.Point

func (*Modal) OnValueChanged 

func (m *Modal) OnValueChanged(f func(context *guigui.Context, date Date))

func (*Modal) SetButtonText 

func (m *Modal) SetButtonText(text string)

func (*Modal) SetFirstWeekday 

func (m *Modal) SetFirstWeekday(day time.Weekday)

func (*Modal) SetMaxDate 

func (m *Modal) SetMaxDate(date Date)

func (*Modal) SetMinDate 

func (m *Modal) SetMinDate(date Date)

func (*Modal) SetOpen 

func (m *Modal) SetOpen(open bool)

func (*Modal) SetTitle 

func (m *Modal) SetTitle(title string)

func (*Modal) SetValue 

func (m *Modal) SetValue(date Date)

func (*Modal) Value 

func (m *Modal) Value() Date

type ModalDateInput 

type ModalDateInput struct {
	guigui.DefaultWidget
	// contains filtered or unexported fields
}

ModalDateInput is a button that opens a modal dialog for typing a date, with a toggle into the same calendar as Modal.

func (*ModalDateInput) Build 

func (m *ModalDateInput) Build(context *guigui.Context, adder *guigui.ChildAdder) error

func (*ModalDateInput) HandleButtonInput 

func (m *ModalDateInput) HandleButtonInput(context *guigui.Context, widgetBounds *guigui.WidgetBounds) guigui.HandleInputResult

func (*ModalDateInput) IsOpen 

func (m *ModalDateInput) IsOpen() bool

func (*ModalDateInput) Layout 

func (m *ModalDateInput) Layout(context *guigui.Context, widgetBounds *guigui.WidgetBounds, layouter *guigui.ChildLayouter)

func (*ModalDateInput) Measure 

func (m *ModalDateInput) Measure(context *guigui.Context, constraints guigui.Constraints) image.Point

func (*ModalDateInput) OnValueChanged 

func (m *ModalDateInput) OnValueChanged(f func(context *guigui.Context, date Date))

func (*ModalDateInput) SetButtonText 

func (m *ModalDateInput) SetButtonText(text string)

func (*ModalDateInput) SetFirstWeekday 

func (m *ModalDateInput) SetFirstWeekday(day time.Weekday)

func (*ModalDateInput) SetMaxDate 

func (m *ModalDateInput) SetMaxDate(date Date)

func (*ModalDateInput) SetMinDate 

func (m *ModalDateInput) SetMinDate(date Date)

func (*ModalDateInput) SetOpen 

func (m *ModalDateInput) SetOpen(open bool)

func (*ModalDateInput) SetTitle 

func (m *ModalDateInput) SetTitle(title string)

func (*ModalDateInput) SetValue 

func (m *ModalDateInput) SetValue(date Date)

func (*ModalDateInput) Value 

func (m *ModalDateInput) Value() Date

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.