Client API. The Codename One framework your app is built on: this runs on the device, not in a backend.

public class MaterialDatePicker

Object
Component
Container
MaterialDatePicker

ImplementsAnimation, Editable, InternalPickerWidget, Iterable<Component>, StyleListener

A date picker in the Material 3 style: the chosen date in large type over a month of days, a grid of years behind the month’s name, and a text field for somebody who would sooner type.

A Picker opens one in a dialog when the theme constant pickerStyle is material. It is a component like any other and can be placed in a form directly:

MaterialDatePicker picker = new MaterialDatePicker();
picker.setDate(new Date());
picker.addActionListener(e -> Log.p("Chosen: " + picker.getDate()));

Form form = new Form("Date", new BorderLayout());
form.add(BorderLayout.CENTER, picker);
form.show();

The month of a Material date picker The years The date typed

Under a mouse the day the pointer is over is marked, and a month asked for with the arrows slides in over the one shown.

The value is a Date. Its time of day is kept as it was given, so a date chosen here does not move an appointment to midnight.

Styling

PickerMaterialOverline is the small title and PickerMaterialHeadline the chosen date; PickerMaterialButton the name of the month, the arrows and the pencil. PickerMaterialWeekday gives the initials of the days their colour and PickerMaterialDay the days theirs: its selected style is the circle of the chosen day, background and foreground, and its disabled style a day outside the range. PickerMaterialYear is a year in the grid, PickerMaterialField the text field and PickerMaterialError what is said about a date that cannot be read.

A date picker restyled from CSS

Constructors

public MaterialDatePicker() A picker showing today.

Methods

`public` `Date getDate()`	The chosen date, at the time of day of the date last set.
`public void setDate(Date date)`	Chooses a date and shows its month.
`public` `Object getValue()`	The currently selected value.
`public void setValue(Object value)`	Moves the selection to `value`.
`public void setDateRange(Date first, Date last)`	The first and the last day that can be chosen.
`public void setYearRange(int first, int last)`	The years the grid of years offers, 1900 to 2100 unless set.
`public void setFirstDayOfWeek(int calendarDay)`	The day a week starts on, as `java.util.Calendar` numbers them: `Calendar.SUNDAY` by default, `Calendar.MONDAY` for most of Europe.
`public int getFirstDayOfWeek()`
`public void setTitle(String title)`	The small title over the date: “Select date” unless set.
`public` `String getTitle()`
`public void addActionListener(ActionListener l)`	Told when the user chooses another date.
`public void removeActionListener(ActionListener l)`
`public void setAnimationTime(long millis)`	Stops the clock the months slide by at a time, for a screenshot of a month coming in or a test of it.
`public boolean isInputMode()`	Whether the date is typed and not picked from the month.
`public void setInputMode(boolean v)`

Inherited fields

Inherited methods

Constructor details

MaterialDatePicker

public MaterialDatePicker()

A picker showing today.

Method details

getDate

public Date getDate()

The chosen date, at the time of day of the date last set.

setDate

public void setDate(Date date)

Chooses a date and shows its month. A date outside the range is brought to the nearest end of it. A null date is ignored.

getValue

public Object getValue()

The currently selected value.

Returns

the selection, in whatever type this implementation documents; never null once the widget has been laid out

setValue

public void setValue(Object value)

Moves the selection to value.

The widget scrolls to the new selection rather than jumping, when it is already on screen.

Parameters

value Object: the new selection, in the type this implementation documents. A value outside the widget’s range is clamped into it.

setDateRange

public void setDateRange(Date first, Date last)

The first and the last day that can be chosen. Either may be null for no limit on that side.

setYearRange

public void setYearRange(int first, int last)

The years the grid of years offers, 1900 to 2100 unless set. A date range narrows them further.

setFirstDayOfWeek

public void setFirstDayOfWeek(int calendarDay)

The day a week starts on, as java.util.Calendar numbers them: Calendar.SUNDAY by default, Calendar.MONDAY for most of Europe.

getFirstDayOfWeek

public int getFirstDayOfWeek()

setTitle

public void setTitle(String title)

The small title over the date: “Select date” unless set.

getTitle

public String getTitle()

addActionListener

public void addActionListener(ActionListener l)

Told when the user chooses another date.

removeActionListener

public void removeActionListener(ActionListener l)

setAnimationTime

public void setAnimationTime(long millis)

Stops the clock the months slide by at a time, for a screenshot of a month coming in or a test of it. A negative value returns to the clock.

isInputMode

public boolean isInputMode()

Whether the date is typed and not picked from the month.

setInputMode

public void setInputMode(boolean v)