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

NAME

PFT::Date - Representation of date

SYNOPSIS

    PFT::Date->new(2016, 12, 10)

    PFT::Date->from_spec(
        d => 12,
        m => 'june', # human friendly
        # missing ones (e.g. year) filled with today's year.
    )

    PFT::Date->from_string('1955-11-05');

DESCRIPTION

PFT::Date is defined as a blessed array reference. The first element is the year, the second is the month, the third is the day.

Properties

y

Year getter

m

Month getter

d

Day getter

to_hash

Returns a dictionary in the form

    { y => ..., m => ..., d => ... }
repr

Returns a string representing the date. Optional parameter is a separator string, by default '-'

    PFT::Date->new(1,2,3)->repr      eq '0001-02-03'
    PFT::Date->new(1,2,3)->repr('/') eq '0001/02/03'
derive

Returns a copy of the PFT::Date object with the provided components replaced.

    PFT::Date->new(1, 2, 3)->derive(m => undef)

is like

    PFT::Date->new(1, undef, 3)
complete

Check if the date is complete of year, month and day.