man DateTime::Infinite (3): Infinite past and future DateTime objects

VERSION

version 1.34

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.

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 returns 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''.

This also applies to methods that are compound stringifications, which return the same strings even for things like "ymd()" or "iso8601()"

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.

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.

Bugs may be submitted through the RT bug tracker <http://rt.cpan.org/Public/Dist/Display.html?Name=DateTime> (or [email protected] <mailto:[email protected]>).

There is a mailing list available for users of this distribution, <mailto:[email protected]>.

I am also usually active on IRC as 'drolsky' on "irc://irc.perl.org".

AUTHOR

Dave Rolsky <[email protected]>

COPYRIGHT AND LICENCE

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)