joda-time介绍

一、Joda简介

目前Joda项目包括：

Joda-Time - Basic types for Date and Time

Joda-Money - Basic types for Money

Joda-Beans - Next generation JavaBeans

Joda-Convert - String to Object conversion

Joda-Collect - Additional collection data structures

Joda-Primitives - Primitive collections

这里简要介绍下Joda-Time。

Joda-Time令时间和日期值变得易于管理、操作和理解。并且 Joda 与 JDK 的互操作性也方便程序使用。目前Joda Time 已经纳入 JDK 8 的官方API了。

二、Maven库坐标

<dependency>

<groupId>joda-time</groupId>

<artifactId>joda-time</artifactId>

<version>2.7</version>

</dependency>

三、Joda-Time的关键日期／时间概念

1. 不可变性（Immutability）

我在本文讨论的Joda-Time类具有不可变性，因此它们的实例无法被修改。（不可变类的一个优点就是它们是线程安全的）。我将向您展示的用于处理日期计算的 API方法全部返回一个对应Joda-Time类的新实例，同时保持原始实例不变。当您通过一个API方法操作Joda-Time类时，您必须捕捉该方法的返回值，因为您正在处理的实例不能被修改。您可能对这种模式很熟悉；比如，这正是 java.lang.String的各种操作方法的工作方式。

2. 瞬间性（Instant）

Instant表示时间上的某个精确的时刻，使用从epoch(1970-01-01 00:00:00 UTC)开始计算的毫秒表示。这一定义与JDK相同，这就是为什么任何Joda-Time Instant子类都可以与JDK Date和Calendar类兼容的原因。

相关类比如DateTime、DateMidnight等。

3. 局部性（Partial）

一个局部时间，正如我将在本文中将其称为局部时间片段一样，它指的是时间的一部分片段。局部时间片段指的是在时间上可以来回 “移动” 的一个时刻，这样它便可以应用于多个实例。

相关类比如：LocalDate、LocalTime等。

4. 年表（Chronology）

年表是一种日历系统、一种计算时间的特殊方式，并且是一种在其中执行日历算法的框架。Joda-Time支持8种年表，每一种都可以作为特定日历系统的计算引擎。

ISO（默认）

Buddhist

Coptic

Ethiopic

Gregorian-Julian cutover

Gregorian

Islamic

Julian

相关类比如ISOChronology、GregorianChronology等。

5. 时区（TimeZone）

时区是值一个相对于英国格林威治的地理位置，用于计算时间。任何严格的时间计算都必须涉及时区（或相对于 GMT）。

DateTimeZone 是Joda-Time库用于封装位置概念的类。许多日期和时间计算都可以在不涉及时区的情况下完成，但是仍然需要了解DateTimeZone 如何影响Joda-Time的操作。默认时间，即从运行代码的机器的系统时钟检索到的时间，在大部分情况下被使用。

四、DateTime类

1. 创建对象

DateTime类提供多种构造函数创建对象，也包括使用jdk对象作构造函数的传入参数，比如DateTime类可以传入以下对象来构造：

java.util.Date - a JDK instant

java.util.Calendar - a JDK canlendar

String - in ISO8601 format

Long - in milliseconds

any Joda-Time date-time class

例子：

java.util.Date jDate = new Date();

DateTime dt = new DateTime(jDate);

2. 属性&方法

DateTime dt = new DateTime();

int month = dt.getMonthOfYear(); // 月，1月值为1，12月值为12

int year = dt.getYear(); // 年

String monthName = dt.monthOfYear().getAsText(); // 四月

String frenchShortName = dt.monthOfYear().getAsShortText(Locale.ENGLISH); // Apr

boolean isLeapYear = dt.year().isLeap(); // false

// 值变后就会产生新对象(不可变性)

DateTime yearK2 = dt.withYear(2000).plusWeeks(2);

DateTime rounded = dt.dayOfMonth().roundFloorCopy();

五、局部日期时间

当地理位置（即时区）变得不重要时，存储日期可使用LocalDate，存储时间可使用LocalTime。

LocalDate localDate = new LocalDate(2009, 9, 6);// September 6, 2009

LocalTime localTime = new LocalTime(13, 30, 26, 0);// 1:30:26PM

六、年表&时区

Joda-Time采用可插拔方式的年表系统，相比之下，JDK使用子类的方式，比如GregorianCalendar。看例子：

Chronology coptic = CopticChronology.getInstance();

DateTimeZone zone = DateTimeZone.forID("Asia/Tokyo");

Chronology gregorianJuian = GJChronolygy.getInstance(zone);

七、间隔&区间&跨度

Interval: 它包含了「开始时间」和「结束时间」信息，包括各自的时区。所以可以根据Interval对象得到「开始时间」和「结束时间」这两个信息。

Duration: 它没有任何「开始时间」和「结束时间」的概念，只是保存了一个具体的时间间隔，是一个以毫秒为单元的整数。

Period : 它和「Duration」差不多意思，也是没有包含「开始时间」和「结束时间」的信息，但是它和「Duration」不同的是，它所指的时间间隔不是以毫秒为单元，而是年、月、天、小时、分、秒、毫秒为相对单元。

先看例子：

DateTime start = new DateTime(2011,12,2,15,33); //开始时间

DateTime end = new DateTime(2013,3,1,12,34); //结束时间

Interval interval = new Interval(start, end);

Duration duration =new Duration(start, end);

Period period =interval.toPeriod();

boolean between = interval.contains(new DateTime(2013, 2, 1, 12, 34));

long millSeconds = duration.getMillis();

long millSeconds1 = period.getMillis();

结果：

between = true

millSeconds = 39301260000

millSeconds1 = 0

前两个值好理解，但duration和period调用getMillis()会出现不同结果就不好理解了。这里解释下：duration.getMillis返回的是绝对相差毫秒数；而period.getMillis返回0，是因为「开始时间」和「结束时间」间隔的相对时间是：1年2个月3个星期5天21个小时1分钟。

八、格式化

要格式化一个Joda-Time对象，调用它的toString()方法即可。如果您愿意的话，传递一个标准的ISO-8601或一个JDK兼容的控制字符串，以告诉JDK如何执行格式化。不需要创建单独的 SimpleDateFormat对象（但是 Joda 的确为那些喜欢自找麻烦的人提供了一个 DateTimeFormatter 类）。看例子：

1.传递SimpleDateFormat字符串

DateTime dateTime = new DateTime();

dateTime.toString("yyyy/MM/dd hh:mm:ss.SSSa");
// 2015/04/21 01:08:57.343下午

dateTime.toString("dd-MM-yyyy HH:mm:ss"); // 21-04-2015 13:08:57

dateTime.toString("EEEE dd MMMM, yyyy HH:mm:ssa");
// 星期二 21 四月, 2015 13:08:57下午

dateTime.toString("MM/dd/yyyy HH:mm ZZZZ");
// 04/21/2015 13:08 Asia/Shanghai

dateTime.toString("MM/dd/yyyy HH:mm Z"); // 04/21/2015 13:08 +0800

2. 使用ISO-8601

DateTime dateTime = new DateTime();

dateTime.toString(ISODateTimeFormat.basicDateTime()); // 20150421T121247.421+0800

dateTime.toString(ISODateTimeFormat.basicDateTimeNoMillis()); // 20150421T121247+0800

dateTime.toString(ISODateTimeFormat.basicOrdinalDateTime()); // 2015111T121247.421+0800

dateTime.toString(ISODateTimeFormat.basicWeekDateTime()); // 2015W172T121247.421+0800