替代JDK日期的开源项目:joda-time

来源:互联网 时间:1970-01-01

作为一名开发者,我们不可避免的会使用日期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)

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"

 

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

 

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

 

文章参考:

http://h819.iteye.com/blog/611099


相关阅读:
Top