joda-time的使用

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

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

A.构造一个日期

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

C.日期的格式化输出

 

A.构造一个日期

 

joda-time的使用_第1张图片

 

基于上面的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去进行常用日期比较,如:

 

joda-time的使用_第2张图片

 

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的使用)