NAME

Prima::Widget::Date - 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

API

Methods

date2str DATE: Converts DATE to string representation according to the current "format" string
default_format: Returns a string to be used in "format", where the string is constructed in such a way to reflect regional date formatting preferences.
See also: "man 3 strftime, %x" .
str2date STRING: Tries to extract date from 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 whether D, M, Y values are valid and within understood range; adjusts the values if not. Returns the final values.

Properties

date DAY, MONTH, YEAR | [ DAY, MONTH, YEAR ]: Accepts three integers / arrayref with three integers in 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 in month.
format STRING: The format string is used when converting date to its visual interpretation, also with regional preferences, like YYYY-MM-DD or DD/MM/YY. The syntax of the format is exctly this, 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>.