The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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