强大易用的日期和时间库 Joda Time

作为一名开发者，我们不可避免的会使用日期API，如果您使用过JDK的API，或者您会发现JDK的API用的很别扭，尤其是在做日期运算和比较的时候，幸好我们活在开源的世界，也有其他朋友遇到同样的问题，因此joda-time就这样应运而生，jotat-time就是为了简化日期的操作而创建的一个开源项目，正如您期望中的那样，它极大的简化了日期的操作。

日期API的常用使用的几个方面主要有以下几个：

A.构造一个日期

B.对日期进行运算和比较

C.日期的格式化输出

 

A.构造一个日期

 

 

基于上面的API，您就可以方便的指定年月日、时分秒或者毫秒数来构建一个日期，但这里要重点关注的是第五个API：

public DateTime(Object instant)，这个构造函数传递一个Object对象，这个对象可以是以下几个类型：

 

ReadableInstant
String(可以被ISODateTimeFormat#dateTimeParser()解析的字符串)
Calendar
Date (includes sql package subclasses)
Long (milliseconds，即距离 1970 年 1 月 1 日子时格林威治标准时间（也称为 epoch）以来的毫秒数)
null (当前时间)

 

示例如下：

DateTime dateTime = new DateTime(new Date());

DateTime dateTime = new DateTime(Calendar.getInstance());

DateTime dateTime = new DateTime("2012-05-30T10:23:1");

 

B.对日期进行运算和比较

 

也许joda的构造函数只是简单的API调用，但对于日期的运算和比较，则是joda的强大之处，也是我们平时使用最多的方面：

下面用一个例子来演示joda的强大之处：

 

计算11月中第一个星期一之后的第一个星期二

DateTime dateTime = new DateTime().monthOfYear()
     .setCopy(11) // November
     .dayOfMonth() // Access Day Of Month Property
     .withMinimumValue() // Get its minimum value
     .plusDays(6) // Add 6 days
     .dayOfWeek() // Access Day Of Week Property
     .setCopy("星期一") // Set to Monday (it will round down)
     .plusDays(1); // Gives us Tuesday

 

上面的一段代码中，第3行有一段dayOfMonth()的调用，joda称之为属性，类似于java的属性，基于这个属性，我们可以调用joda的API做一些日期的增减，获取最大最小值等操作。

再看代码第七行 .setCopy("星期一")，它是整个计算的关键，这样的话，在每月的开始再加上 6 天就能够让您得到第一个星期一。再加上一天就得到第一个星期二。这里使用参数 “星期一” 是和Locale相关的，建议可以使用1替换，如果您在美国地区，这个参数就需要设置为"Monday"

计算2个日期的时间差，例如获取2个时间相差多少天：
int days = Days.daysBetween(DateTime.now(), new DateTime("2012-05-30T10:23:1")).getDays();

Joda 使得执行日期计算变得非常容易，这就是joda的强大之处，想想要是使用jdk的日期API，得要多少步骤才能完成上面的功能。

 

对于日期比较，joda-time也提供了一些API去进行常用日期比较，如：

 

 

C.日期的格式化输出

 

Joda的日期格式化提供了简单的API接口：toString()，如果你需要的话，也可以传一个ISO-8601或者一个JDK控制的字符串格式，来告诉API如何输出日期格式

 

 

1.使用ISO-8601

DateTime dateTime = new DateTime();
System.out.println(dateTime.toString(ISODateTimeFormat.basicDateTime()));
System.out.println(dateTime.toString(ISODateTimeFormat.basicDateTimeNoMillis()));

System.out.println(dateTime.toString(ISODateTimeFormat.basicWeekDateTime()));

 

以上代码输出：

20130516T192141.859+0800
20130516T192141+0800

2013W204T192141.859+0800

 

2.使用SimpleDateFormat字符串

System.out.println(dateTime.toString("MM/dd/yyyy hh:mm:ss.SSSa"));
System.out.println(dateTime.toString("dd-MM-yyyy HH:mm:ss"));
System.out.println(dateTime.toString("EEEE dd MMMM, yyyy HH:mm:ssa"));
System.out.println(dateTime.toString("MM/dd/yyyy HH:mm ZZZZ"));
System.out.println(dateTime.toString("MM/dd/yyyy HH:mm Z"));

 

以上代码输出：

16-05-2013 19:25:12

星期四 16 五月, 2013 19:25:12下午

05/16/2013 19:25 Asia/Shanghai

05/16/2013 19:25 +0800

 

具体格式可以查看javadoc：DateTimeFormat

 

D.Joda与JDK相互转换

 

joda是为了简化日期的开发，于是它也提供了对JDK日期的相互转换的API，这样您可以方便的切换日期的使用。

DateTime dateTime = new DateTime(new Date());

DateTime dateTime = new DateTime(Calendar.getInstance());

Date jdkDate = DateTime.now().toDate();

 

同时，JDK的日期API和joda都提供了获取毫秒数和通过毫秒数创建日期，也就是基于毫秒数这个桥梁，我们也可以进行互转

new DateTime(new Date().getTime())

new Date(DateTime.now().getMillis());

 

就是这么简单，您可以方便的互相转换，以进行您的日期计算。

 

总结：

joda-time是一个轻量级的开源项目，用过jdk自带的日期API，再对比joda-time，你会发现两者在用户使用方面的巨大差异，如果您用过joda-time，相信您再也不会再想用JDK的日期API

 

 

文章来源：

http://www.cnblogs.com/cm4j/archive/2013/05/16/cm4j.html