jdatetime 是一个优雅的，开发者友好的类并且也一种非常精巧的跟踪日期和时间的一种方式。它使用一种非常清晰并且被广泛证明的算法去进行时间的操作。每个被jdk中calendar深深虐过的人都将发现这是多麽好的一剂良药。
julian day 或者 julian day number(jdn)表示距离格林威治时间公元前 4713年 1月1日 星期一正午12点有多少个整数天。julian date(jd)则表示距离同样的时间过了多少天（有小数位的天）。jds 是被推荐的方式当在天文学上表示时间时。
julian day number 可以被认为是一种简单的日历：日期是他的整数位，时间是它的小数位。这样它可以非常方便的被引用，计算或者转换。实际上jd 的设计之美正是它可以非常容易的去计算时间的范围进而去根据时间滚动日期,仅仅通过简单的数学加减法。jd允许通过简单的减法去计算两个历史日期之间的时间差。
julian day 系统被天文学家引进用来在两个不同的日历中去统一不同的历史年代表时提供统一的的日期系统。
除了零点的选取和名字的与众不同外，julian day 和julian date 不是直接的关联到julian calendar，尽管它可以从将一个日历的任何日期转换到另一个日历。
jdatetime 内部使用jd去表示当前的日期和时间，它根据被证明并很好地测试过的天文学算法去做所有的计算。jdatetime 在所有的计算中提供精确到1毫秒的精度。
jdatetime 可以通过多种方式创建：通过制定想要的日期和时间，或者通过传入一个jdk中日期时间相关类的引用，或者通过指定系统的毫秒数等等。
jdatetime 能够通过指定日期和时间数据来创建，一旦被创建，日期和时间可以通过不同的方式来改变，可以通过完整的日期/时间信息来改变（等同于创建新的jdateinstance）或者仅仅改变一部分（仅仅 天或者分钟…）
使用构造函数：
<code>1</code>
<code>jdatetime jdt = </code><code>new</code> <code>jdatetime(); </code><code>// current date and time</code>
<code>2</code>
<code>jdt = </code><code>new</code> <code>jdatetime(</code><code>2012</code><code>, </code><code>12</code><code>, </code><code>21</code><code>): </code><code>// 21st december 2012, midnight</code>
<code>3</code>
<code>jdt = </code><code>new</code> <code>jdatetime(system.currenttimemillis()); </code><code>// current date and time</code>
<code>4</code>
<code>jdt = </code><code>new</code> <code>jdatetime(</code><code>2012</code><code>, </code><code>12</code><code>, </code><code>21</code><code>, </code><code>11</code><code>, </code><code>54</code><code>, </code><code>22</code><code>, </code><code>124</code><code>); </code><code>// 21.dec.2012,11:54:22.124</code>
<code>5</code>
<code>jdt = </code><code>new</code> <code>jdatetime(&quot;</code><code>2012</code><code>-</code><code>12</code><code>-</code><code>21</code> <code>11</code><code>:</code><code>54</code><code>:</code><code>22.124</code><code>&quot;); </code><code>// -//-</code>
<code>6</code>
<code>jdt = </code><code>new</code> <code>jdatetime(&quot;</code><code>12</code><code>/</code><code>21</code><code>/</code><code>2012</code><code>&quot;, &quot;mm/dd/yyyy&quot;); </code><code>// 21st dec. 2012, midnight</code>
使用方法：
<code>jdatetime jdt = </code><code>new</code> <code>jdatetime(); </code><code>// current date and time</code>
<code>jdt.set(</code><code>2012</code><code>, </code><code>12</code><code>, </code><code>21</code><code>, </code><code>11</code><code>, </code><code>54</code><code>, </code><code>22</code><code>, </code><code>124</code><code>); </code><code>// 21st december 2012, 11:54:22.124</code>
<code>jdt.set(</code><code>2012</code><code>, </code><code>12</code><code>, </code><code>21</code><code>); </code><code>// 21st december 2012, midnight</code>
<code>jdt.setdate(</code><code>2012</code><code>, </code><code>12</code><code>, </code><code>21</code><code>); </code><code>// change just date to 21st dec. 2012</code>
<code>jdt.setcurrenttime(); </code><code>// set current date and time</code>
<code>jdt.setyear(</code><code>1973</code><code>); </code><code>// change the year</code>
<code>7</code>
<code>jdt.sethour(</code><code>22</code><code>); </code><code>// change the hour</code>
<code>8</code>
<code>jdt.settime(</code><code>18</code><code>, </code><code>00</code> <code>12</code><code>, </code><code>853</code><code>); </code><code>// change just time</code>
当然，它可以通过jdatetime读取时间和日期信息,每个部分：年，月，时等等都有对应的getter方法，天和月是从1开始计数的，所以，jdatetime.jnuary 是1.
除了读取单个日期时间信息单个部分的方法，这里还有须有方便的方法去返回日期和时间信息。
getdatetimestamp()内部使用jdatetime返回datetimestamp 实例,这个类一次性返回了所有的日期/时间信息。
getjuliandate()内部使用jdatetime返回juliandatestamp实例。juliandatestamp持有当前jd的信息。由于小数位的精度问题，jd 信息通过两个单独的字段进行存储：integer 和 fraction(jd=integer+fraction). 你也就可以得到一个double类型值得jd，但是它不精确（忽略掉时间），由于当integer部分非常大的时候会导致fraction部分精度丢失。
jdatetime 提供了多个方法在当前的日期/时间上加减指定的时间。它可以仅仅改变单个部分的日期/时间信息或者一次改变多个部分。
<code>jdt.add(</code><code>1</code><code>, </code><code>2</code><code>, </code><code>3</code><code>, </code><code>4</code><code>, </code><code>5</code><code>, </code><code>6</code><code>, </code><code>7</code><code>); </code><code>// add 1 year, 2 months, 3 days, 4 hours...</code>
<code>jdt.add(</code><code>4</code><code>, </code><code>2</code><code>, </code><code>0</code><code>); </code><code>// add 4 years and 2 months</code>
<code>jdt.addmonth(-</code><code>120</code><code>); </code><code>// go back 120 months</code>
<code>jdt.subyear(</code><code>1</code><code>); </code><code>// go back one year</code>
<code>jdt.addhour(</code><code>1234</code><code>); </code><code>// add 1234 hours</code>
由于性能的原因，最好是通过一个方法调用按照顺序一次性改变多个时间部分，比如，如果同时要在当前时间上加一定数量的months,minutes和秒，通过add(0, months, 0, 0, minutes, seconds, 0); 一次性改变而不是调用三个单独的方法去改变将使速度更快。
由于每个月的长度是变化的月份的增加是不可靠的，这里有两种方式可以被考虑当进行月份增加的时候，下面的例子将显示什么：从2003-01-31加一个月后的时间是什么？
jdatetime 有一个monthfix的标志去表示加法后的月份，当这个标志关闭时，一个月的天数被近似的认为是31天，所以结果是：2003-01-31 + 0-1-0 = 2003-03-03.
当monthfix的标志是关闭的时候（默认也是这样），月份的长度会被忽略，在这种情况下，添加一个月总是得到的是下一个月：2003-01-31 + 0-1-0 = 2003-02-28.
因为月份天数的补丁导致添加月份是不可靠的，所以最佳实践是用添加天数来代替。
通过jdatetime 可以非常容易的去计算周期时间，仅仅通过两个时间相减接口得到去计算周期时间。但是如果要包括小时，分钟，秒和毫秒，更简单并且快速的方式是使用period类。
jdatetime 可以 非常容易的在其他时间相关的类之间进行转换：gregoriancalendar, java.util.date, java.sql.date, timestamp,datetimestamp
不仅如此，他可以从存在的实例设置日期和时间，而不是创建一个新的。
<code>calendar c = jdt.converttocalendar();</code>
<code>jdt.converttogregoriancalendar();</code>
<code>jdt.convertto(gregoriancalendar.</code><code>class</code><code>); </code><code>// generic way of conversion</code>
<code>jdt = </code><code>new</code> <code>jdatetime(gregcalinstance); </code><code>// create from gregoriancalendar</code>
<code>jdt.loadfrom(gregcalinstance); </code><code>// load time data from gregoriancalendar</code>
<code>jdt.storeto(gregcalinstance); </code><code>// store time data to gregoriancalendar</code>
不仅如此，根据自己需要定义自定义的转换也是非常容易的。
特别注意的是日期/时间与字符串之间的转换。这里有两种通用的方式去转换：
通过jdatetime实例进行转换或者通过传递一个jdatetime实例给一些格式化的类。
对所有内部的转换和解析，jdatetime使用所谓的formatters,比如 jdtformatter的实现。formatters 遵循简单的协议（接口）仅仅两个方法：定义如何转换为字符串和如何解析字符串为指定的格式。格式通常是一个包含一些模式的字符串模板。因此一个formatter的实例可以用在整个应用中。jdatetime持有formatter和默认的格式用来进行转换和解析。当在转换和解析时没有指定格式则使用默认格式。
假如一个应用程序不得不在多个formatter之间频繁切换，那么你使用jdtformat来进行转换和解析将更方便-这是一个不可变的类持有formatter-format对。
最后，由于jdatetime可以非常方便的转换为date,所以你也可以使用jdk的dateformatter来进行日期时间和字符串的转换。
defaultformatter是jdatetime默认使用的格式化类。它在iso 8601规范的基础上增强了模式，同时对转换和解析-解析支持的模式少一些。
转换的模板字符串除了上诉的文本外还可以包含其他的文本，甚至完整的句子。它可以转义某些模板部分来防止被转换。转义文本通过单引号。任何在引号区域内的两个单引号会北替换为一个单引号，此外，如果一些模式无法被识别它将忽略。
使用例子:
<code>01</code>
<code>jdatetime jdt = </code><code>new</code> <code>jdatetime(</code><code>1975</code><code>, </code><code>1</code><code>, </code><code>1</code><code>);</code>
<code>02</code>
<code>jdt.tostring(); </code><code>// &quot;1975-01-01 00:00:00.000&quot;</code>
<code>03</code>
<code>jdt.tostring(&quot;yyyy.mm.dd&quot;); </code><code>// &quot;1975.01.01&quot;</code>
<code>04</code>
<code>jdt.tostring(&quot;mm: mml (mms)&quot;); </code><code>// &quot;01: january (jan)&quot;</code>
<code>05</code>
<code>jdt.tostring(&quot;dd is d: dl (ds)&quot;); </code><code>// &quot;01 is 3: wednesday (wed)&quot;</code>
<code>06</code>
<code>jdatetime jdt = </code><code>new</code> <code>jdatetime(</code><code>1968</code><code>, </code><code>9</code><code>, </code><code>30</code><code>);</code>
<code>07</code>
<code>jdt.tostring(&quot;</code><code>''</code><code>''</code> <code>is a sign, w is a week number and </code><code>'w'</code> <code>is a letter&quot;);</code>
<code>08</code>
<code>// &quot;' is a sign, 5 is a week number and w is a letter&quot;</code>
<code>09</code>
<code>10</code>
<code>jdt.parse(&quot;</code><code>2003</code><code>-</code><code>11</code><code>-</code><code>24</code> <code>23</code><code>:</code><code>18</code><code>:</code><code>38.173</code><code>&quot;);</code>
<code>11</code>
<code>jdt.parse(&quot;</code><code>2003</code><code>-</code><code>11</code><code>-</code><code>23</code><code>&quot;); </code><code>// 2003-11-23 00:00:00.000</code>
<code>12</code>
<code>jdt.parse(&quot;</code><code>01.01</code><code>.</code><code>1975</code><code>&quot;, &quot;dd.mm.yyyy&quot;); </code><code>// 1975-01-01</code>
<code>13</code>
<code>jdt.parse(&quot;</code><code>2001</code><code>-</code><code>01</code><code>-</code><code>31</code><code>&quot;, &quot;yyyy-mm-***&quot;); </code><code>// 2001-01-01, since day is not parsed</code>
<code>14</code>
<code>15</code>
<code>jdatetime jdt = </code><code>new</code> <code>jdatetime();</code>
<code>16</code>
<code>jdtformatter fmt = </code><code>new</code> <code>defaultformatter();</code>
<code>17</code>
<code>fmt.convert(jdt, &quot;yyyy-mm.dd&quot;); </code><code>// external conversion</code>
<code>18</code>
<code>19</code>
<code>jdtformat format = </code><code>new</code> <code>jdtformat(</code><code>new</code> <code>defaultformatter(), &quot;yyyy+dd+mm&quot;);</code>
<code>20</code>
<code>jdt.tostring(format);</code>
<code>21</code>
<code>format.convert(jdt);</code>
<code>22</code>
<code>23</code>
<code>dateformat df = </code><code>new</code> <code>simpledateformat();</code>
<code>24</code>
<code>df.format(jdt.converttodate()); </code><code>// date formatter</code>
通过在jdatetime中设置locale，可以在结果字符串中返回本地化的名称，比如月份和长短日期的名称，当没有指定locale时，jdatetime使用系统默认的locale。
jdatetime提供了两种方式去定义星期，即定义星期的第一天和定义一年的第一个星期（用来周的计数）。
setweekdefinition(start,must)定义一个星期的起始天和一周的那一天必须在一年中来计算该周属于那一年。
setweekdefinitionalt(start, min) 是另一个定义方式来定义一周的起始天和该周属于该年时必须有的最小的天数。
由于jd的起始时间是如此的久远，jd的数值非常的大和笨重，一个距离现在更近的起始点通常会被用到，比如丢弃掉一些数字位来在保证足够的精度的同时适应有限的计算机内存。
jdatetime 可以将jd在下面的类之间进行转换：
简化的 julian day (rjd),
改良的 julian day (mjd), and
截短的 julian day (tjd), nasa提出的定义
julian date，根据定义，是与时区和夏时制无关的。但是，jdatetime支持时区，当时区改变时（并且改变到不同的时区）时间将进行一定的偏移。当jdatetime创建时，系统默认的时区就被使用，当设置新的时区是，当前时间将根据时区的不同而改变，下面的例子表示当前的日本时间：
<code>jdt.settimezone(timezone.gettimezone(</code><code>"japan"</code><code>;));</code>
<code>system.out.println(jdt);</code>
此外，可以仅仅去设置时区，而不改变当前的时间。有时在改变时区时会很用，通过changetimezone()方法即可。
dst仅仅被部分支持，现在默认情况下dst跟踪是关闭的（标志：trackdst）。当dst跟踪打开时，jdatetime将跟踪dst仅仅当加减时间时，最后一点，它可以设置一个无效的时间（比如说不存在的时间）。