摘要：開(kāi)源時(shí)間日期庫(kù)是很好的替代，另外中也推出了新的庫(kù)，設(shè)計(jì)理念與相似。令時(shí)間和日期值變得易于管理操作和理解。格式化一個(gè)日期時(shí)間的具體域包括個(gè)年月日時(shí)分秒毫秒星期，分別用不同字母表示。

此前Java處理時(shí)間日期所使用的 Date 和 Calendar 被詬病不已，Calendar 的主要問(wèn)題對(duì)象可變，而像時(shí)間和日期這樣的類(lèi)應(yīng)該是不可變的，另外其概念模型也有不明確的地方，月份計(jì)算從0開(kāi)始等等。

JodaTime開(kāi)源時(shí)間/日期庫(kù)是很好的替代，另外Java8中也推出了新的java.time庫(kù)，設(shè)計(jì)理念與JodaTime相似。

Joda-Time 令時(shí)間和日期值變得易于管理、操作和理解。易于使用是 Joda 的主要設(shè)計(jì)目標(biāo)。Joda-Time主類(lèi) DateTime 和JDK舊有類(lèi) Date 和 Calendar之間可以互相轉(zhuǎn)換。從而保證了與JDK框架的兼容。

"蓋將自其變者而觀之,則天地曾不能以一瞬"，Instant 就代表時(shí)間軸上的"一瞬"，為保持和JDK一致，時(shí)間軸起點(diǎn)亦在1970年，單位為ms。

Instant類(lèi)的作用就圍繞著時(shí)間軸上的絕對(duì)時(shí)間(long類(lèi)型)，提供了構(gòu)造，修改，加減等方法。另外它也是DateTime類(lèi)的構(gòu)建方式之一

DateTime dateTime = new DateTime(new Instant());
DateTime dateTime = new Instant().toDateTime();

Interval代表一個(gè)Instant到下一個(gè)Instant的時(shí)間間隔，這個(gè)間隔是半開(kāi)閉集合。即包括起始的一瞬，但并不包含結(jié)束的一瞬。

Instant表示時(shí)間軸上的一點(diǎn)，Interval則表示時(shí)間軸上一段區(qū)間。

Duration指用ms計(jì)量的一段持續(xù)時(shí)間。Duration雖然與Interval看似類(lèi)似，但Duration的概念相對(duì)孤立，僅表示時(shí)間區(qū)間長(zhǎng)度，與時(shí)間軸上的位置沒(méi)有關(guān)系。

Duration 可以參與兩個(gè)Instant之間的運(yùn)算。

$$instant + duration = instant$$

Period表示用具體域(如年/月/日/時(shí)/分/秒/毫秒/星期)計(jì)量的一段時(shí)間，如3天，2小時(shí)等。這亦是與時(shí)間軸無(wú)關(guān)的一個(gè)概念，與Duration的不同只是在計(jì)量方式上。Duration與時(shí)區(qū)和歷法無(wú)關(guān)，Period則與之相關(guān)。

Period概念之所以重要，可以想象在某年1月和7月的基礎(chǔ)上分別加 數(shù)值為1月的Period，則二者所需的具體時(shí)間ms值是不相同的。Period 是描述時(shí)間間隔長(zhǎng)度的另一種方式。

由上可見(jiàn)Period是與Duration同級(jí)別的概念，亦可以參與Instant的運(yùn)算。
$$instant + period = instant$$

另外也可以由 Interval 獲得相應(yīng)的Period和Duration。

DateTime now,then;
Interval interval = new Interval(now,then);
Period period = interval.toPeriod();
Duration duration = interval.toDuration();

Chronology代表歷法，負(fù)責(zé)具體時(shí)間日期的計(jì)算，雖然作用上居于核心位置，但在Api上卻容易被忽視。
使用者往往不需要指定具體的歷法，感受不到其存在。歷法類(lèi)是單例實(shí)現(xiàn)，默認(rèn)實(shí)現(xiàn)是 ISOChronology。

代表時(shí)區(qū)。可以用來(lái)構(gòu)建歷法類(lèi)。

DateTimeZone zone = DateTimeZone.forID("Europe/London");

Partial表示日期時(shí)間的一部分，是本地化時(shí)間，與時(shí)區(qū)無(wú)關(guān)。
例如一個(gè)TimeDate指定為2015年11月9日11時(shí)11分11秒，則在時(shí)間軸上為確定一點(diǎn)；若省略掉年份時(shí)間信息，只取11月9日，則在時(shí)間軸上則對(duì)應(yīng)多點(diǎn)，表示歷年來(lái)11月9日這一天的任意時(shí)間點(diǎn)。其實(shí)現(xiàn)類(lèi)有下列幾種:

LocalDate

LocalTime

LocalDateTime

YearMonth

MonthDay

由概念可知 為Partial指定其缺失域和時(shí)區(qū)信息，可以將其在時(shí)間軸上的位置確定下來(lái)。
$$partial + missing fields + time zone = instant$$

一個(gè)日期時(shí)間的具體域包括8個(gè):年/月/日/時(shí)/分/秒/毫秒 + 星期，分別用不同字母表示。

對(duì)于DateTime/LocalDate可以采用直接構(gòu)造格式化

DateTime dt = new DateTime();
String a = dt.toString();
String b = dt.toString("dd:MM:yy");
String c = dt.toString("EEE", Locale.FRENCH);

當(dāng)然這不過(guò)是個(gè)障眼法，真實(shí)的格式化工作由DateTimeFormatter完成，標(biāo)準(zhǔn)格式類(lèi)由ISODateTimeFormat提供。

DateTimeFormatter fmt = ISODateTimeFormat.dateTime();

如果要自定義格式化，需要?jiǎng)?chuàng)建DateTimeFormatter類(lèi)

DateTimeFormatter fmt = DateTimeFormat.forPattern("yyyyMMddEE");
DateTimeFormatter germanFmt = fmt.withLocale(Locale.GERMAN);

now.toString(fmt);

更詳細(xì)的流式構(gòu)造

DateTimeFormatter fmt = new DateTimeFormatterBuilder()
        .appendDayOfMonth(2)
        .appendLiteral("-")
        .appendMonthOfYearShortText()
        .appendLiteral("-")
        .appendTwoDigitYear(1956)  // pivot = 1956
        .toFormatter();

Joda 類(lèi)具有不可變性，因此它們的實(shí)例無(wú)法被修改。不可變類(lèi)的一個(gè)優(yōu)點(diǎn)就是它們是線程安全的。

DateTime 是Joda-Time的核心類(lèi)，代表時(shí)間日期值，其構(gòu)造方法多樣，即可以使用各種對(duì)象構(gòu)造，亦可以使用基本類(lèi)型構(gòu)造，核心在于能夠確定在時(shí)間軸上的位置?？梢詤⑴c構(gòu)造的對(duì)象包括:

Date - a JDK instant

Calendar - a JDK calendar

String - in ISO8601 format

Long - in milliseconds

any Joda-Time date-time class

int[]

Joda-Time支持Date/Calendar構(gòu)造，保證了與JDK的兼容.

有了DateTime對(duì)象可以用get方法獲取從年到毫秒數(shù)的具體信息。以年為示例如下:

int year = dateTime.getYear();
int yearincenture = dateTime.getYearOfCentury();
int yearofera = dateTime.getYearOfEra();

DateTime還分別提供了一個(gè)內(nèi)部類(lèi) Property，Property的功能更加強(qiáng)大。DateTime的屬性有多種類(lèi)型，并支持修改。

Property p = now.year(); //年份
boolean isleap = p.isLeap(); //判斷是否是閏年
String name = p.getAsText();

Property p = now.monthOfYear();//當(dāng)年中的月份
p.setCopy(6); //將月份改為六月

Property p = now.dayOfMonth(); //當(dāng)月中的天數(shù)
p.setCopy(9); //將天數(shù)改為當(dāng)月9號(hào)

Property p = now.dayOfWeek();  //當(dāng)星期的天數(shù)
p.setCopy(1); //將天數(shù)改為星期1

DateTime對(duì)時(shí)間日期的計(jì)算主要針對(duì)7種域提供 with/plus/minus 三種方法。

DateTime dt = dateTime.plusYears(1);

陷阱:因?yàn)椴豢勺冃?，DateTime修改之后得到的是一個(gè)新DateTime對(duì)象，這一點(diǎn)可以通過(guò)hashcode來(lái)驗(yàn)證，因此必須給這個(gè)新對(duì)象賦一個(gè)引用。

Joda-Time支持多種歷法和時(shí)區(qū)，其中默認(rèn)歷法是ISO標(biāo)準(zhǔn)歷法，默認(rèn)時(shí)區(qū)與JDK相同。Joda-Time使用插件化(pluggable)機(jī)制，其中時(shí)區(qū)類(lèi)被設(shè)計(jì)成歷法類(lèi)的一個(gè)依賴。

Chronology類(lèi)表示對(duì)歷法抽象

DateTimeZone類(lèi)表示對(duì)時(shí)區(qū)的抽象

//1.指定歷法和時(shí)區(qū)
DateTimeZone zone = DateTimeZone.forID("Asia/Tokyo");
Chronology gregorianJuian =GJChronology.getInstance(zone);
DateTime daTime = new DateTime(gregorianJuian);

通過(guò)DateTimeZone.getAvailableIDs()可以獲取全部時(shí)區(qū)名稱.

LocalDate可以通過(guò)DateTime獲取，亦可以自行構(gòu)建。

LocalDate localDate= dateTime.toLocalDate();

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

LocalDate now = new LocalDate();
//DateTime now = new DateTime();

now.toString();
int year = now.getYear();
int month = now.getMonthOfYear();
int day = now.getDayOfWeek();

LocalDate now = new LocalDate(2015,11,9);
DateTime now = new DateTime(2015,11,9,7,15);

LocalDate now = new LocalDate(2015,11,9);
LocalDate then = new LocalDate(2015,11,9);
now.isEqual(then);
now.isBefore(then);
now.isAfter(then);

LocalDate now = new LocalDate();
then = now.plusYears(1);
then = now.minusYears(1);
then = now.withYear(2016);

MonthDay birth = new MonthDay(11,9);

LocalDate now = new LocalDate();
MonthDay today = new MonthDay(now);

birth.isEqual(today);

then = now.plusWeeks(1);
then = now.plusMonths(1);
then = now.plusDays(1);

Period period = new Period(now,then);
System.out.println(period.getDays());
System.out.println(period.getYears());
System.out.println(period.getMonths());

LocalDate now = new LocalDate();
LocalDate lastDayOfPreviousMonth = now.minusMonths(1).
            dayOfMonth().withMaximumValue();

dayOfMonth方法返回了屬性（property）。

DateTime now = new DateTime();
now = now.monthOfYear().setCopy(11)
        .dayOfMonth().withMinimumValue()//獲得當(dāng)月1號(hào)
        .plusDays(6)
        .dayOfWeek().setCopy(1);//獲得星期一

當(dāng)?shù)玫奖驹?號(hào)后，使用dayOfWeek()將獲得1號(hào)所在的星期，直接使用setCopy(1)指定有可能會(huì)回到上個(gè)月月末的星期1.

因此使用plusDays(6)作預(yù)處理，即使用1當(dāng)月7號(hào)所在星期的星期1。

DateTime now = new DateTime();
DateTime then = now.plusYears(5)
        .monthOfYear()
        .setCopy(2)
        .dayOfMonth()
        .withMaximumValue();