.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" 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
..
.\" Set up some character translations and predefined strings. \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote. \*(C+ will
.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
. ds -- \(*W-
. ds PI pi
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
. ds L" ""
. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
. ds -- \|\(em\|
. ds PI \(*p
. ds L" ``
. ds R" ''
. 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::Calendar::Julian 3pm"
.TH DateTime::Calendar::Julian 3pm "2022-01-31" "perl v5.32.1" "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::Calendar::Julian \- Dates in the Julian calendar
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\& use DateTime::Calendar::Julian;
\&
\& $dt = DateTime::Calendar::Julian\->new( year => 964,
\& month => 10,
\& day => 16,
\& );
\&
\& # convert Julian\->Gregorian...
\&
\& $dtgreg = DateTime\->from_object( object => $dt );
\& print $dtgreg\->datetime; # prints \*(Aq0964\-10\-21T00:00:00\*(Aq
\&
\& # ... and back again
\&
\& $dtjul = DateTime::Calendar::Julian\->from_object( object => $dtgreg );
\& print $dtjul\->datetime; # prints \*(Aq0964\-10\-16J00:00:00\*(Aq
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
DateTime::Calendar::Julian implements the Julian Calendar. This module
implements all methods of DateTime; see the \fBDateTime\fR\|(3) manpage for all
methods.
.SH "METHODS"
.IX Header "METHODS"
This module implements one additional method besides the ones from
DateTime, and changes the output of one other method.
.IP "\(bu" 4
calendar_name
.Sp
Returns \f(CW\*(AqJulian\*(Aq\fR.
.IP "\(bu" 4
gregorian_deviation
.Sp
Returns the difference in days between the Gregorian and the Julian
calendar.
.IP "\(bu" 4
datetime
.Sp
.Vb 1
\& print $dt\->datetime( $sep ), "\en";
.Ve
.Sp
This method is equivalent to
.Sp
.Vb 1
\& join $sep, $dt\->ymd( \*(Aq\-\*(Aq ), $dt\->hms( \*(Aq:\*(Aq );
.Ve
.Sp
The \f(CW$sep\fR argument defaults to \f(CW\*(AqJ\*(Aq\fR.
.Sp
\&\fBCaveat:\fR the optional argument was added to this method in version
1.02, to belatedly track a change made in DateTime version
1.43 released 2017\-05\-29. Fixing this restores the original
stringification behavior of this class, which was to return an \s-1ISO\-8601\s0
string unless a formatter was set. Before this change, the
stringification separated date and time with either a \f(CW\*(AqT\*(Aq\fR or a
\&\f(CW\*(AqJ\*(Aq\fR, depending on which version of DateTime was
installed.
.PP
\&\fBNote\fR that as of version \f(CW\*(C`0.106_01\*(C'\fR, methods related to quarters
should work.
.SH "BACKGROUND"
.IX Header "BACKGROUND"
The Julian calendar was introduced by Julius Caesar in 46BC. It
featured a twelve-month year of 365 days, with a leap year in February
every fourth year. This calendar was adopted by the Christian church in
325AD. Around 532AD, Dionysius Exiguus moved the starting point of the
Julian calendar to the calculated moment of birth of Jesus Christ. Apart
from differing opinions about the start of the year (often January 1st,
but also Christmas, Easter, March 25th and other dates), this calendar
remained unchanged until the calendar reform of pope Gregory \s-1XIII\s0 in
1582. Some backward countries, however, used the Julian calendar until
the 18th century or later.
.PP
This module uses the proleptic Julian calendar for years before 532AD,
or even 46BC. This means that dates are calculated as if this calendar
had existed unchanged from the beginning of time. The assumption is
made that January 1st is the first day of the year.
.PP
Note that \s-1BC\s0 years are given as negative numbers, with 0 denoting the
year 1BC (there was no year 0AD!), \-1 the year 2BC, etc.
.SH "SUPPORT"
.IX Header "SUPPORT"
Support for this module is provided via the \fIdatetime@perl.org\fR email
list. See for more details.
.PP
Please report bugs to
,
, or
in electronic mail to \fIwyant@cpan.org\fR.
.SH "AUTHOR"
.IX Header "AUTHOR"
Eugene van der Pijll
.PP
Thomas R. Wyant, \s-1III\s0 \fIwyant at cpan dot org\fR
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
Copyright (c) 2003 Eugene van der Pijll. All rights reserved.
.PP
Copyright (C) 2018\-2022 Thomas R. Wyant, \s-1III\s0
.PP
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
.PP
This program is distributed in the hope that it will be useful, but
without any warranty; without even the implied warranty of
merchantability or fitness for a particular purpose.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
DateTime
.PP
DateTime::Calendar::Christian
.PP
datetime@perl.org mailing list
.PP