| Prima::Widget::Date(3) | User Contributed Perl Documentation | Prima::Widget::Date(3) |
NAME¶
Prima::Widget::Date - standard date picker widget
SYNOPSIS¶
use Prima qw(Application Widget::Date);
my $mw = Prima::MainWindow->new;
$mw->insert( 'Widget::Date' =>
pack => { fill => 'x', pad => 20 },
);
run Prima;
DESCRIPTION¶
Standard date picker widget, derived from the "Prima::InputLine" class.
API¶
Methods¶
- date2str DATE
- Converts the DATE to a string representation according to the current "format" string
- default_format
- Returns a string to be used in "format"
where the string is constructed to reflect the formatting of the regional
date preferences.
See also: "man 3 strftime, %x" .
- str2date STRING
- Tries to extract the date from the STRING, assuming it is constructed according to the current "format" string. Doesn't fail but values that could not be extracted are assigned to today's day/month/year instead.
- today
- Returns today's date in widgets [D,M,Y] format
- validate_date D, M, Y
- Checks if D, M, Y form a valid date, and adjusts the values if not. Returns the corrected values.
Properties¶
- date DAY, MONTH, YEAR | [ DAY, MONTH, YEAR ]
- Accepts three integers / arrayref with three integers in the format of
"localtime". DAY can be from 1 to 31,
MONTH from 0 to 11, YEAR from 0 to 199.
Default value: today's date.
- day INTEGER
- Selects the day of the month.
- format STRING
- The format string is used when converting the date to its visual interpretation, also with regional preferences, f ex YYYY-MM-DD or DD/MM/YY. The syntax of the format is verbatim as this, i e it recognizes fixed patterns YYYY, YY, MM, and DD, replacing them with the date values.
- month
- Selects the month.
- year
- Selects the year.
AUTHOR¶
Dmitry Karasik, <dmitry@karasik.eu.org>.
SEE ALSO¶
Prima::ComboBox, Prima::Calendar
| 2024-08-20 | perl v5.40.0 |