1DateTime::Infinite(3) User Contributed Perl DocumentationDateTime::Infinite(3)
2
3
4

NAME

6       DateTime::Infinite - Infinite past and future DateTime objects
7

VERSION

9       version 1.54
10

SYNOPSIS

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

DESCRIPTION

16       This module provides two DateTime subclasses,
17       "DateTime::Infinite::Future" and "DateTime::Infinite::Past".
18
19       The objects are always in the "floating" timezone, and this cannot be
20       changed.
21

METHODS

23       The only constructor for these two classes is the "new" method, as
24       shown in the "SYNOPSIS". This method takes no parameters.
25
26       All "get" methods in this module simply return infinity, positive or
27       negative. If the method is expected to return a string, it returns the
28       string representation of positive or negative infinity used by your
29       system. For example, on my system calling "$dt->year"> returns a number
30       which when printed appears either "Inf" or "-Inf".
31
32       This also applies to methods that are compound stringifications, which
33       return the same strings even for things like "$dt->ymd" or
34       "$dt->iso8601"
35
36       The object is not mutable, so the "$dt->set", "$dt->set_time_zone", and
37       "$dt->truncate" methods are all do-nothing methods that simply return
38       the object they are called with.
39
40       Obviously, the "$dt->is_finite" method returns false and the
41       "$dt->is_infinite" method returns true.
42

SEE ALSO

44       datetime@perl.org mailing list
45
46       http://datetime.perl.org/
47

BUGS

49       There seem to be lots of problems when dealing with infinite numbers on
50       Win32. This may be a problem with this code, Perl, or Win32's IEEE math
51       implementation. Either way, the module may not be well-behaved on Win32
52       operating systems.
53
54       Bugs may be submitted at
55       <https://github.com/houseabsolute/DateTime.pm/issues>.
56
57       There is a mailing list available for users of this distribution,
58       <mailto:datetime@perl.org>.
59
60       I am also usually active on IRC as 'autarch' on "irc://irc.perl.org".
61

SOURCE

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

AUTHOR

67       Dave Rolsky <autarch@urth.org>
68
70       This software is Copyright (c) 2003 - 2020 by Dave Rolsky.
71
72       This is free software, licensed under:
73
74         The Artistic License 2.0 (GPL Compatible)
75
76       The full text of the license can be found in the LICENSE file included
77       with this distribution.
78
79
80
81perl v5.34.0                      2021-07-22             DateTime::Infinite(3)
Impressum