NAME
Mojar::Cron::Datetime - Lightweight datetime with small footprint
SYNOPSIS
use Mojar::Cron::Datetime;
say Mojar::Cron::Datetime->now->to_string;
my $d = Mojar::Cron::Datetime->from_string('2001-12-25 00:00:01');
$d->day($d->day + 14);
$d->normalise;
say "$d";DESCRIPTION
CONSTRUCTORS
new
Construct a datetime from passed arguments.
$d = Mojar::Cron::Datetime->new; # zero datetime
$d = $datetime->new; # clone
$d = Mojar::Cron::Datetime->new([00, 00, 20, 26, 06, 112]);
$d = Mojar::Cron::Datetime->new(00, 00, 20, 26, 06, 112);The first constructs the zero datetime '1900-01-01 00:00:00'. The second clones the value of $datetime. The third uses the passed value (2012-07-27 21:00:00 London time expressed in UTC). The fourth does the same but using its own reference.
now
$d = Mojar::Cron::Datetime->now;
$d = Mojar::Cron::Datetime->now($use_local);
$d = $d->now;Constructs a datetime for now. Uses UTC clock unless passed a true value (indicating to use local clock). If called as an object method, ignores the value of the object, so it gives the same result as the class method. (Compare to new which uses the object's value.)
from_string
$d = Mojar::Cron::Datetime->from_string('2012-07-27 20:00:00');
$d = Mojar::Cron::Datetime->from_string('2012-07-28T01:00:00', 1);Constructs a datetime by parsing an ISO 8601 string. (The method only supports the formats shown, where 'T' is optional, and not any of the other 8601 variants.) Uses UTC clock unless passed a true value (indicating to use local clock). Both examples result in the same value if the machine's clock is in UTC+5.
METHODS
copy
$second = Mojar::Cron::Datetime->new->copy($first);Copies the constituent values from another datetime object.
normalise
to_string
say "$dt";
say $dt->to_string;
say $dt->to_string('%Y-%m-%d %H:%M:%S');
say Mojar::Cron::Datetime->to_string($dt, '%Y-%m-%d');
say Mojar::Cron::Datetime->to_string([00,00,00, 25,11,101], '%A');Stringifies the datetime object using the given format. The default format is '%Y-%m-%d %H:%M:%S'. The first three examples are equivalent.
COPYRIGHT AND LICENCE
Copyright (C) 2012--2016, Nic Sandfield.
This program is free software, you can redistribute it and/or modify it under the terms of the Artistic License version 2.0.