DateTime::Infinite(3) User Contributed Perl DocumentationDateTime::Infinite(3)
NAME
DateTime::Infinite - Infinite past and future DateTime objects
VERSION
version 1.45
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 - 2017 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.
perl v5.24.3 2017-12-29 DateTime::Infinite(3)
datetime 1.440.0 - Generated Thu Jan 4 14:43:53 CST 2018