DateTime::Infinite

Section: User Contributed Perl Documentation (3)
Updated: 2021-01-27
Page Index

NAME

DateTime::Infinite - Infinite past and future DateTime objects

VERSION

version 1.54

SYNOPSIS

  my $future = DateTime::Infinite::Future->new;
  my $past   = DateTime::Infinite::Past->new;

DESCRIPTION

This module provides two DateTime subclasses, "DateTime::Infinite::Future" and "DateTime::Infinite::Past".

The objects are always 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 "$dt->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 "$dt->ymd" or "$dt->iso8601"

The object is not mutable, so the "$dt->set", "$dt->set_time_zone", and "$dt->truncate" methods are all do-nothing methods that simply return the object they are called with.

Obviously, the "$dt->is_finite" method returns false and the "$dt->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 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 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.