[Java]Java日期及时间库插件 -- Joda Time.

来到新公司工作也有一个多月了, 陆陆续续做了一些简单的项目. 今天做一个新东西的时候发现了 Joda Time的这个东西, 因为以前用的都是JDK原生的时间处理API, 大家都知道Java原生的时间处理的API一直都是不太好用, 所以这个有必要去学习下, 去总结下.
来到新公司学到的东西挺多的, 比如我们用了Guava, ElasticSearch, kafka/mns/ons, GuavaCache/Ehcache/Memcahe .... 等很多东西都是我以前没有接触过的. 所以待我学习的东西还有很多. 每天都是怀着激动的心情, 去汲取更多的知识. 说了这么多屁话, 开始总结了.

一: 使用示例 
因为双十一就快到了, 所以接触了一个秒杀的活动, 其中有这么一块代码:

 /**
  * 检查抽奖时间
  *
  * @return true 可以抽奖 false 不能抽奖
  */
  private boolean checkDrawTime() {
      return DateTime.parse("2016-11-11 11:11:00", DateTimeFormat.forPattern("yyyy-MM-dd HH:mm:ss")).isBeforeNow();
  }

这个方法很简单, 就是检查现在的时间是不是2016/11/11 11:11:00 之前. 当然这里的DateTime是Jode Time里的类.
查看源码可以知道, DateTime.parse就是将输入的时间转换为后面的格式, 转换的结果为:

然后再用isBeforeNow方法来比较, 下面看下这个方法具体的做法:

 public boolean isBeforeNow() {
     return this.isBefore(DateTimeUtils.currentTimeMillis());
 }

 public boolean isBefore(long var1) {
     return this.getMillis() < var1;
 }

这样看过来是不是很清楚了, 当然Java 自带的JDK也是可以完成的, 但是Joda Time都给我封装好了, 用起来就更加简单了.

接下来看看更多的例子:

1、创建任意时间对象

1 //jdk
2 Calendar calendar=Calendar.getInstance();
3 calendar.set(2012, Calendar.NOVEMBER, 15, 18, 23,55);
4
5 //Joda-time
6 DateTime dateTime=new DateTime(2012, 12, 15, 18, 23,55);

2、计算两日期相差的天数

 1     //jdk
 2     Calendar start = Calendar.getInstance();
 3     start.set(2012, Calendar.NOVEMBER, 14);
 4
 5     Calendar end = Calendar.getInstance();
 6     end.set(2012, Calendar.NOVEMBER, 15);
 7
 8     long startTim = start.getTimeInMillis();
 9     long endTim = end.getTimeInMillis();
10     long diff = endTim-startTim;
11     int days=(int) (diff/1000 / 3600 / 24);
12
13
14     //joda-time
15     LocalDate start=new LocalDate(2012, 12,14);
16     LocalDate end=new LocalDate(2012, 12, 15);
17     int days = Days.daysBetween(start, end).getDays();

3、获取18天之后的某天在下个月的当前周的第一天日期

 1 //jdk
 2 Calendar current = Calendar.getInstance();
 3 current.add(Calendar.DAY_OF_MONTH, 18);
 4 current.add(Calendar.MONTH, 1);
 5      ......
 6 DateFormat dateFormat=new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
 7 Date date = current.getTime();
 8 String dateStr = dateFormat.format(date);
 9 System.out.println(dateStr);
10
11 //joda-time
12 String dateStr = new DateTime().plusDays(18).plusMonths(1)
13     .dayOfWeek().withMinimumValue().toString("yyyy-MM-dd HH:mm:ss");
14 System.out.println(dateStr);

4、时间格式化

 1 DateTimeFormatter format = DateTimeFormat .forPattern("yyyy-MM-dd HH:mm:ss");
 2
 3 //时间解析
 4 DateTime dateTime = DateTime.parse("2012-12-21 23:22:45", format);
 5
 6 //时间格式化，输出==> 2012/12/21 23:22:45 Fri
 7 String string_u = dateTime.toString("yyyy/MM/dd HH:mm:ss EE");
 8 System.out.println(string_u);
 9
10 //格式化带Locale，输出==> 2012年12月21日 23:22:45 星期五
11 String string_c = dateTime.toString("yyyy年MM月dd日 HH:mm:ss EE",Locale.CHINESE);
12 System.out.println(string_c);

5、与JDK互操作

 1 //通过jdk时间对象构造
 2 Date date = new Date();
 3 DateTime dateTime = new DateTime(date);
 4
 5 Calendar calendar = Calendar.getInstance();
 6 dateTime = new DateTime(calendar);
 7
 8 // Joda-time 各种操作.....
 9 dateTime = dateTime.plusDays(1) // 增加天
10     .plusYears(1)// 增加年
11     .plusMonths(1)// 增加月
12     .plusWeeks(1)// 增加星期
13     .minusMillis(1)// 减分钟
14     .minusHours(1)// 减小时
15     .minusSeconds(1);// 减秒数
16
17 // 计算完转换成jdk 对象
18 Date date2 = dateTime.toDate();
19 Calendar calendar2 = dateTime.toCalendar(Locale.CHINA)

二: api简介
Maven项目组中引入Joda Time坐标地址:

<!-- joda -->
<dependency>
    <groupId>joda-time</groupId>
    <artifactId>joda-time</artifactId>
    <version>2.3</version>
</dependency>

1, 日期和时间:
Joda-time里面的时间全都是不可变的，也就是不可变性。

DateTime ：类似于JDK中的Calendar，提供了更多的方法。
DateMidnight ：这个概念稍微复杂，封装某个时区（通常为默认时区）在特定年/月/日的午夜时分的时刻。它基本上类似于
DateTime，不同之处在于时间部分总是为与该对象关联的特定
DateTimeZone 时区的午夜时分。
LocalDate ：无时间的类，只包含年月日。（不包含时区）
LocalTime ：无日期的类，只包含时间。（不包含时区）
LocalDateTime ：包含日期和时间。（不包含时区）

下面举一些简单的例子说明Joda-time的强大之处:

 //获取当前月份：
 DateTime dt = new DateTime();
 int month = dt.getMonthOfYear();
 //设定2000年/获取当前小时+2的小时：
 DateTime dt = new DateTime();
 DateTime year2000 = dt.withYear(2000);
 DateTime twoHoursLater = dt.plusHours(2);
 System.out.println(year2000.getYear());
 System.out.println(twoHoursLater.getHourOfDay());
 //以及下面的一些操作：
 String monthName = dt.monthOfYear().getAsText();
 String frenchShortName = dt.monthOfYear().getAsShortText(Locale.FRENCH);
 boolean isLeapYear = dt.year().isLeap();
 DateTime rounded = dt.dayOfMonth().roundFloorCopy();
 System.out.println(monthName); // 本地月份名称
 System.out.println(frenchShortName); // 法语月份简称
 System.out.println(isLeapYear); // 是否闰年
 System.out.println(rounded); // 获取当天0:0:0的DateTime对象

 

2, 日历系统及时区

Joda-time支持多种年表（即日历系统）及所有时区。主要的两个类如下：
Chronology ：年表，Joda-time支持很多年表。就像JDK有Calendar，也有GregorianCalendar。
DateTimeZone ：时区。

示例如下，一般系统都没有这个需求。

 Chronology coptic = CopticChronology.getInstance();
 System.out.println(coptic); // CopticChronology[Asia/Shanghai]

 DateTimeZone zone = DateTimeZone.forID("Asia/Tokyo");
 Chronology gregorianJuian = GJChronology.getInstance(zone);
 System.out.println(gregorianJuian); // GJChronology[Asia/Tokyo]

3, 时间跨度

Joda-time支持的时间跨度有三个，分别如下：
Interval ：根据开始、结束时间表示一个特定的时间跨度。其为半开区间，即包括起始时刻，不包含结束时刻。
Period ：Period设定了一些特定的时间跨度，比如小时、天、月。
Duration ：表示绝对的精准跨度，以毫秒为单位。

使用示例如下:

 DateTime beginDateTime = new DateTime(2010, 1, 1, 0, 0, 0);
 DateTime endDateTime = new DateTime(2015, 1, 1, 0, 0, 0);
 Interval interval = new Interval(beginDateTime, endDateTime);
 System.out.println(interval.containsNow()); // 是否包含当前时间
 System.out.println(interval.toDurationMillis()); // 时间间隔毫秒数

 DateTime dt = new DateTime(2005, 3, 26, 12, 0, 0, 0);
 DateTime plusPeriod = dt.plus(Period.days(1));
 System.out.println(plusPeriod); // Period的方式+1天
 DateTime plusDuration = dt.plus(new Duration(24L * 60L * 60L * 1000L));
 System.out.println(plusDuration); // Duration的方式+1天

三: Joda-time使用的理念

不可变性（Immutability）
瞬间性（Instant）
局部性（Partial）
年表（Chronology）
时区（Time zone）

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

瞬间性
Instant 表示时间上的某个精确的时刻，使用从 epoch 开始计算的毫秒表示。这一定义与 JDK 相同，这就是为什么任何 Joda Instant 子类都可以与 JDK Date 和 Calendar 类兼容的原因。
更通用一点的定义是：一个瞬间 就是指时间线上只出现一次且唯一的一个时间点，并且这种日期结构只能以一种有意义的方式出现一次。

局部性
一个局部时间，正如我将在本文中将其称为局部时间片段一样，它指的是时间的一部分片段。瞬间性指定了与 epoch 相对的时间上的一个精确时刻，与此相反，局部时间片段指的是在时间上可以来回 “移动” 的一个时刻，这样它便可以应用于多个实例。比如，6 月 2 日 可以应用于任意一年的 6 月份（使用 Gregorian 日历）的第二天的任意瞬间。同样，11:06 p.m. 可以应用于任意一年的任意一天，并且每天只能使用一次。即使它们没有指定一个时间上的精确时刻，局部时间片段仍然是有用的。
我喜欢将局部时间片段看作一个重复周期中的一点，这样的话，如果我正在考虑的日期构建可以以一种有意义的方式出现多次（即重复的），那么它就是一个局部时间。

年表
Joda 本质——以及其设计核心——的关键就是年表（它的含义由一个同名抽象类捕捉）。从根本上讲，年表是一种日历系统——种计算时间的特殊方式——并且是一种在其中执行日历 算法 的框架。受 Joda 支持的年表的例子包括：ISO（默认）、Coptic、Julian、Islamic等。

时区
时区是值一个相对于英国格林威治的地理位置，用于计算时间。要了解事件发生的精确时间，还必须知道发生此事件的位置。任何严格的时间计算都必须涉及时区（或相对于 GMT），除非在同一个时区内发生了相对时间计算（即时这样时区也很重要，如果事件对于位于另一个时区的各方存在利益关系的话）。
DateTimeZone 是 Joda 库用于封装位置概念的类。许多日期和时间计算都可以在不涉及时区的情况下完成，但是仍然需要了解 DateTimeZone 如何影响 Joda 的操作。默认时间，即从运行代码的机器的系统时钟检索到的时间，在大部分情况下被使用。

好了, 我所了解的就是这么多, 我主要还是从如何使用的角度去学习这个东西, 最后总结了它的几个特性, 当然Joda-Time的强大之处远不止这些, 大家在以后的工作中可以尝试着去使用它.