DateTime::Infinite(3) | User Contributed Perl Documentation | DateTime::Infinite(3) |
NAME¶
DateTime::Infinite - Infinite past and future DateTime objects
SYNOPSIS¶
my $future = DateTime::Infinite::Future->new; my $past = DateTime::Infinite::Past->new;
DESCRIPTION¶
This module provides two DateTime.pm subclasses, "DateTime::Infinite::Future" and "DateTime::Infinite::Past".
The objects are in the "floating" timezone, and this cannot be changed.
BUGS¶
There seem to be lots of problems when dealing with infinite numbers on Win32. This may be a problem with this code, Perl, or Win32's IEEE math implementation. Either way, the module may not be well-behaved on Win32 operating systems.
METHODS¶
The only constructor for these two classes is the "new()" method, as shown in the SYNOPSIS. This method takes no parameters.
All "get" methods in this module simply return infinity, positive or negative. If the method is expected to return a string, it return the string representation of positive or negative infinity used by your system. For example, on my system calling "year()" returns a number which when printed appears either "inf" or "-inf".
The object is not mutable, so the "set()", "set_time_zone()", and "truncate()" methods are all do-nothing methods that simply return the object they are called with.
Obviously, the "is_finite()" method returns false and the "is_infinite()" method returns true.
AUTHOR¶
Dave Rolsky <autarch@urth.org>
COPYRIGHT¶
Copyright (c) 2003-2009 David Rolsky. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
The full text of the license can be found in the LICENSE file included with this module.
SEE ALSO¶
datetime@perl.org mailing list
2017-03-22 | perl v5.10.1 |