focal (3) DateTime::Infinite.3pm.gz

NAME

       DateTime::Infinite - Infinite past and future DateTime objects

VERSION

       version 1.51

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.

SEE ALSO

       datetime@perl.org mailing list

       http://datetime.perl.org/

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 at <https://github.com/houseabsolute/DateTime.pm/issues>.

       There is a mailing list available for users of this distribution, <mailto:datetime@perl.org>.

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

SOURCE

       The source code repository for DateTime can be found at <https://github.com/houseabsolute/DateTime.pm>.

AUTHOR

       Dave Rolsky <autarch@urth.org>

COPYRIGHT AND LICENSE

       This software is Copyright (c) 2003 - 2019 by Dave Rolsky.

       This is free software, licensed under:

         The Artistic License 2.0 (GPL Compatible)

       The full text of the license can be found in the LICENSE file included with this distribution.