summaryrefslogtreecommitdiff
path: root/pod/perlport.pod
diff options
context:
space:
mode:
authorRafael Garcia-Suarez <rgarciasuarez@gmail.com>2009-01-03 18:55:29 +0100
committerRafael Garcia-Suarez <rgarciasuarez@gmail.com>2009-01-03 18:55:29 +0100
commitf433f45e728fb8fd90ae712c4daa4fb4cf2cb6c2 (patch)
treea495247209955f13920d0cd895025f77c8854f34 /pod/perlport.pod
parent2547c837a73d50421f898a78d070bf820ac97f12 (diff)
parentd4fb0a1f15d1a1c49224933a2cf320efa700d961 (diff)
downloadperl-f433f45e728fb8fd90ae712c4daa4fb4cf2cb6c2.tar.gz
Merge branch 'schwern/y2038' into blead
Conflicts: lib/Time/Local.pm lib/Time/Local.t reentr.h
Diffstat (limited to 'pod/perlport.pod')
-rw-r--r--pod/perlport.pod15
1 files changed, 7 insertions, 8 deletions
diff --git a/pod/perlport.pod b/pod/perlport.pod
index 35635a0468..39a7441956 100644
--- a/pod/perlport.pod
+++ b/pod/perlport.pod
@@ -641,9 +641,6 @@ The value for C<$offset> in Unix will be C<0>, but in Mac OS will be
some large number. C<$offset> can then be added to a Unix time value
to get what should be the proper value on any system.
-On Windows (at least), you shouldn't pass a negative value to C<gmtime> or
-C<localtime>.
-
=head2 Character sets and character encoding
Assume very little about character sets.
@@ -1864,7 +1861,10 @@ platforms. See L<File::Glob> for portability information.
=item gmtime
-Same portability caveats as L<localtime>.
+In theory, gmtime() is reliable from -2**63 to 2**63-1. However,
+because work arounds in the implementation use floating point numbers,
+it will become inaccurate as the time gets larger. This is a bug and
+will be fixed in the future.
=item ioctl FILEHANDLE,FUNCTION,SCALAR
@@ -1915,10 +1915,9 @@ Available on 64 bit OpenVMS 8.2 and later. (VMS)
=item localtime
-Because Perl currently relies on the native standard C localtime()
-function, it is only safe to use times between 0 and (2**31)-1. Times
-outside this range may result in unexpected behavior depending on your
-operating system's implementation of localtime().
+localtime() has the same range as L<gmtime>, but because time zone
+rules change its accuracy for historical and future times may degrade
+but usually by no more than an hour.
=item lstat