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>.

SEE ALSO

Prima::ComboBox, Prima::Calendar