.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DateTime::LeapSecond 3pm"
.TH DateTime::LeapSecond 3pm 2024-03-07 "perl v5.38.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
DateTime::LeapSecond \- leap seconds table and utilities
.SH VERSION
.IX Header "VERSION"
version 1.65
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 2
\&    use DateTime;
\&    use DateTime::LeapSecond;
\&
\&    print "Leap seconds between years 1990 and 2000 are ";
\&    print DateTime::Leapsecond::leap_seconds($utc_rd_2000)
\&        \- DateTime::Leapsecond::leap_seconds($utc_rd_1990);
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This module is used to calculate leap seconds for a given Rata Die day. It is
used when DateTime cannot compile the XS version of this code.
.PP
This library is known to be accurate for dates until Jun 2020.
.PP
There are no leap seconds before 1972, because that's the year this system was
implemented.
.IP \(bu 4
leap_seconds($rd)
.Sp
Returns the number of accumulated leap seconds for a given day.
.IP \(bu 4
extra_seconds($rd)
.Sp
Returns the number of leap seconds for a given day, in the range \-2 .. 2.
.IP \(bu 4
day_length($rd)
.Sp
Returns the number of seconds for a given day, in the range 86398 .. 86402.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
<http://hpiers.obspm.fr/eop\-pc/earthor/utc/leapsecond.html>
.SH SUPPORT
.IX Header "SUPPORT"
Bugs may be submitted at <https://github.com/houseabsolute/DateTime.pm/issues>.
.PP
There is a mailing list available for users of this distribution,
<mailto:datetime@perl.org>.
.SH SOURCE
.IX Header "SOURCE"
The source code repository for DateTime can be found at <https://github.com/houseabsolute/DateTime.pm>.
.SH AUTHOR
.IX Header "AUTHOR"
Dave Rolsky <autarch@urth.org>
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
This software is Copyright (c) 2003 \- 2023 by Dave Rolsky.
.PP
This is free software, licensed under:
.PP
.Vb 1
\&  The Artistic License 2.0 (GPL Compatible)
.Ve
.PP
The full text of the license can be found in the
\&\fILICENSE\fR file included with this distribution.