NAME
Time::Local::Extended - Extends 2038 barrier to 2098.
SYNOPSIS
use Time::Local::Extended qw(:ALL);
my @localtime = localtime(2**31);
my $seconds = timelocal(0,0,0,1,10,170);
my $gmt_seconds = timegm(0,0,0,1,10,170);
my $gmt_time = gmtime(2**31);
my $ux_time = UNIX_TIMESTAMP('2097-07-04 12:34:56');
my $date = FROM_UNIXTIME(2**31);
my $sql = qq(
SELECT start_time
FROM projects
WHERE project_id = '1'
);
my $date_time = $dbh->selectrow_array($sql); # '2097-07-04 12:34:56'
my $ux_time = UNIX_TIMESTAMP($date_time); # 4023794096
my $date_time = FROM_UNIXTIME(2**31);
my $sql = qq(
UPDATE projects
SET start_time = '$date_time'
WHERE project_id = '1'
);
DESCRIPTION
This module extends the 2038 date boundary to 2098. In conventional date
manipulation using CORE::localtime and Time::Local::timelocal, you
cannot use dates later than 2038. This module allows you to use dates as
far out as 2098, giving you sixty more years to postpone the problem.
PUBLIC METHODS
* timelocal
Invoked in the same way as Time::Local::timelocal, but supports
dates up to Jan 1, 2098.
* localtime
Invoked in the same way as CORE::localtime, but supports dates up to
Jan 18, 2098.
* timegm
Invoked in the same way as Time::Local::timegm, but supports dates
up to Jan 1, 2098.
* gmtime
Invoked in the same way as CORE::gmtime, but supports dates up to
Jan 18, 2098.
* UNIX_TIMESTAMP
Invoked similarly to the MySQL UNIX_TIMESTAMP() function, but
supports dates up to Jan 1, 2098.
* FROM_UNIXTIME
Invoked similarly to the MySQL FROM_UNIXTIME() function, but
supports dates up to Jan 18, 2098.
BUGS
Please e-mail bug reports or suggestions to bobo@cpan.org. Thanks!
TODO
1) Trap Time::Local::timelocal die in an eval {}.
2) Add support for timelocal_nocheck and timegm_nocheck.
3) Add tests for time zones other than Eastern.
4) Clean up. Lots of clean up.
CREDITS
Thanks to Peter Kioko <ceph@techie.com> for helping to refine the idea.
Thanks to Adam Foxson <afoxson@pobox.com> for quality assurance and for
being the Human CPAN Reference Manual.
AUTHOR
Bob O'Neill, <bobo@cpan.org>
COPYRIGHT AND LICENSE
Copyright (C) 2003-2004 Bob O'Neill. All rights reserved.
See COPYING for license
SEE ALSO
* perl.
* Time::Local.