picoware.gui.date_picker.DatePicker

class documentation

class DatePicker:

A GUI component for selecting and rendering a date and time.

Two-band layout:: Top band: Month | Day | Year Bottom band: Hour | Min | Sec

Left/right navigates across all 6 fields, up/down changes the value. Returns False when the user is done (CENTER or BACK).

Method	`__del__`	Clean up resources
Method	`__init__`	Initialize the date picker with position, size, and optional initial time.
Method	`run`	Run one iteration of the date picker event loop.
Property	`time`	Get the currently selected date and time as a tuple.
Method	`__band`	Draw a single 3-column drum-roll band.
Method	`__draw`	Render the date+time picker on the display.
Method	`__max_day`	Return the number of days in the given month (1-indexed).
Constant	`_DAYS_IN_MONTH`	Undocumented
Constant	`_MONTHS`	Undocumented
Instance Variable	`_field`	Undocumented
Instance Variable	`_needs_redraw`	Undocumented
Instance Variable	`_position`	Undocumented
Instance Variable	`_size`	Undocumented
Instance Variable	`_time`	Undocumented
Instance Variable	`_view_manager`	Undocumented

def __del__(self): ¶

Clean up resources

def __init__(self, view_manager, position, size, time: tuple = None): ¶

Initialize the date picker with position, size, and optional initial time.

Parameters
view_manager:`ViewManager`	View Manager context.
position:`Vector`	Vector with position coordinates.
size:`Vector`	Vector with size dimensions.
time:`tuple`	Optional initial date and time (year, month, day of month, weekday, hour, minute, second, subseconds). Defaults to None.

def run(self) -> bool: ¶

Run one iteration of the date picker event loop.

Returns
`bool`	True to keep running, False when the user is done.

@property

Get the currently selected date and time as a tuple.

def __band(self, draw, fg, bg, sel, band_y, band_h, col_w, start_x, labels, values, active_col, val_h, lbl_h, lbl_cw, val_font): ¶

Draw a single 3-column drum-roll band.

Parameters
draw:`Draw`	Drawing context.
fg:`int`	Foreground color.
bg:`int`	Background color.
sel:`int`	Selected column highlight color.
band_y:`int`	Top Y position of the band.
band_h:`int`	Height of the band.
col_w:`int`	Width of each column.
start_x:`int`	Left X position of the band.
labels:`tuple`	Field labels for the three columns.
values:`tuple`	Display strings for the three columns.
active_col:`int`	Index of the active column, or -1.
val_h:`int`	Value text height.
lbl_h:`int`	Label text height.
lbl_cw:`int`	Label character width.
val_font:`int`	Font size for the values.

def __draw(self): ¶

Render the date+time picker on the display.

def __max_day(self, month: int) -> int: ¶

Return the number of days in the given month (1-indexed).

Parameters
month:`int`	The month number, 1 to 12.

Returns
`int`	The number of days in the month.

_DAYS_IN_MONTH: tuple[int, ...] = ¶

Undocumented

Value

(31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31)

_MONTHS: tuple[str, ...] = ¶

Undocumented

Value

('Jan',
 'Feb',
 'Mar',
 'Apr',
 'May',
 'Jun',
 'Jul',
...

_field = ¶

Undocumented

_needs_redraw: bool = ¶

Undocumented

_position = ¶

Undocumented

_size = ¶

Undocumented

_time = ¶

Undocumented

_view_manager = ¶

Undocumented