Dave Rolsky > DateTime > DateTime::Infinite

Download:
DateTime-1.26.tar.gz

Dependencies

Annotate this POD

Website

CPAN RT

New  8
Open  8
Stalled  7
View/Report Bugs
Module Version: 1.26   Source  

NAME ^

DateTime::Infinite - Infinite past and future DateTime objects

VERSION ^

version 1.26

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 through the RT bug tracker (or bug-datetime@rt.cpan.org).

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

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

AUTHOR ^

Dave Rolsky <autarch@urth.org>

COPYRIGHT AND LICENCE ^

This software is Copyright (c) 2016 by Dave Rolsky.

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)
syntax highlighting: