<?xml version="1.0" encoding="ISO-8859-1"?>

<document>

 <properties>
  <title>Java date and time API - Julian calendar system</title>
  <author>Stephen Colebourne</author>
 </properties>

 <body>

<section name="Julian calendar system">
<p>
The Julian calendar system is calendar system that was widely used from about 4CE to 1582CE.
It was replaced by the <a href="cal_gregorian.html">Gregorian</a> calendar on 1582-10-15.
The Julian calendar defines a leap year as once every four years.
This becomes inaccurate over time, to such an extent that by 1582, 10 days had to be
'lost' to correct the calendar.
</p>
<p>
The Julian calendar is represented in Joda-Time by the Julian chronology.
This chronology applies Julian rules for all time.
Normally, a more accurate historic calendar is found by using the
<a href="cal_gj.html">GregorianJulian</a> chronology instead.
</p>
<p>
References
<ul>
<li>Calendrical Calculations - Millenium Edition - ISBN 0521777526</li>
<li><a href="http://en.wikipedia.org/wiki/Julian_calendar">Wikipedia - Julian Calendar</a></li>
</ul>
</p>
</section>

<section name="Using Julian chronology in Joda-Time">
<p>
Within Joda-Time the Julian calendar system can be used by obtaining an
instance of <a href="apidocs/org/joda/time/chrono/JulianChronology.html">JulianChronology</a>.
This is normally created using the factory method
<a href="apidocs/org/joda/time/chrono/JulianChronology.html#getInstance()">JulianChronology.getInstance()</a>.
This is then passed into the constructors of the main date and time classes.
</p>
<source>
// setup date object for the Battle of Hastings in 1066
Chronology chrono = JulianChronology.getInstance();
DateTime dt = new DateTime(1066, 10, 14, 10, 0, 0, 0, chrono);
</source>

</section>

</body>
</document>
