NAME

Util::Medley::DateTime - Class with various datetime methods.

VERSION

version 0.023

SYNOPSIS

my $dt = Util::Medley::DateTime->new;

#
# positional  
#
say $dt->localDateTime(time);

#
# named pair
#
say $dt->localDateTime(epoch => time);
 

DESCRIPTION

A small datetime library. This doesn't do any calculations itself, but provides some simple methods to call for getting the date/time in commonly used formats.

ATTRIBUTES

none

METHODS

localDateTime

Returns the local-date-time in the format: YYYY-MM-DD HH:MM:SS.

usage:

$dt->localDateTime([time]);

$dt->localDateTime([epoch => time]);

args:

time [Int]

Epoch time used to generate date/time string. Default is now.

localDateTimeAdd

Adds days, hours, mins, and/or secs to a local-date-time string.

usage:

$newDateTime = $dt->localDateTimeAdd($dateTime, [0, 1, 0, 0]);

$newDateTime = $dt->localDateTimeAdd( dateTime => $dateTime,
                                     [days     => 0],
                                     [hours    => 1],
                                     [mins     => 0],
                                     [secs     => 0]);

args:

dateTime [Str]

A local-date-time string.

days [Int]

Days to add.

hours [Int]

Hours to add.

mins [Int]

Minutes to add.

secs [Int]

Seconds to add.

localDateTimeToEpoch

Converts a local-date-time string to epoch.

usage:

$epoch = $dt->localDateTimeToEpoch($dateTime);

$epoch = $dt->localDateTimeToEpoch(dateTime => $dateTime);

args:

dateTime [Str]

The local-date-time string to convert.

localDateTimeIsValid

Validates the date-time string against: YYYY-MM-DD HH:MM:SS. Also, checks if it is actually a valid date-time.

usage:

$dt->localDateTimeIsValid($dateTime);

$dt->localDateTime(dateTime => $dateTime);

args:

dateTime [Str]

The date-time string to validate.