Java-时间处理----Joda-time

参考：

https://github.com/JodaOrg/joda-time

https://www.joda.org/joda-time/userguide.html#

Joda-Time为Java date和time类提供了一个高质量的替代品。该设计支持多个日历系统，同时仍然提供了一个简单的API。

“默认”日历是XML使用的ISO8601标准。

---

Maven configuration:

<dependency>
  <groupId>joda-time</groupId>
  <artifactId>joda-time</artifactId>
  <version>2.10.1</version>
</dependency>

Joda-time与 JDK API 区别
1 、 JDK Date 和 Calendar 的 API 难于使用。
2 、 JDK 存储月份、星期从 0 开始而不是 1 。
3 、 JDK 难于扩展除默认支持以外的日历系统。
4 、 JDK 不支持一些常见的日期计算，如计算两个时间之间所相差天数、星期等。
5 、需要注意线程安全问题 , 如 DateFormat

---

1 、令时间和日期更易于管理和操作。
2 、提供简单的 API ，易于使用和扩展。
3 、支持 ISO8601 、 Coptic 等多种日历系统。
4 、与 JDK 百分之百互操作，使用 Joda-time 只
需替换部分代码。
5 、可完全代替 JDK 的时间和日期相关处理类。

---

创建一个任意时间对象，如：2018-12-20 15:25:55

 

核心概念

1 、不可变性 (Immutability)   
 居于线程安全设计， Joda-time 所有时间、日期操作的 API 都将返回一个全新的Joda 实例，类似于 String 的各种操作方法的工作方式。

2 、瞬间性 (Instant)

 表示时间上的某个精确时刻，使用从epoch 开始计算的毫秒数表示，即在时间线上只出现一次且唯一的时间点，与 JDK 相同

 3 、局部性 (Partial)
指时间 (Instant) 的一部分片断，没有时区，可以在时间上来回“移动”，如 11 月 10日、 05:25:54 ，它可以是任何一年的时间

4 时间间隔
用于描述和计算两个时间之间的跨度，如两时间所相差的天数、月份、星期、时、分、秒等等,
Joda-time 通过以下三个类进行描述：Duration 、 Period 、 Interval 

5 年表 (Chronology)
日历系统，一种计算时间的特殊方式，一种执行日历算法的框架， Joda-time 支持以下 8 种日历系统：
ISO8601( 默认 ) 、 Buddhist 、 Coptic、 Ethiopic 、 Gregorian 、 GregorianJulian、Islamic 、 Julian

6 时区 (Time Zone)
地球上的区域使用同一个时间定义 , 用于每个国家或不同区域对同一时间的计算，
详细内容参考：http://zh.wikipedia.org/wiki/%E6%97%B6%E5%8C%BA

---

主要类介绍

1 、 DateTime
最常用的一个类，处理时间日期功能最全，以毫秒及精度封装时间上的某个瞬间时刻，包含日期和时
间、时区，类似于 java.util.Clendar 。

2 、 LocalDate
– 只包含日期部分信息，专注于日期方面的处理，类似 java.util.Date ，没有时区概念。

3 、 LocalTime
只包含时间部分信息，专注于时间方面的处理，没有时区概念。
4 、 LocalDateTime
含日期和时间信息，但与 DateTime 不同，只表示的当前系统时区和默认日历系统

5 、 Interval
处理特定的时间跨度，以指定的时间点开始和结束，其中 , 结束时间需大于或等于开始时间。
6 、 Duratio
表示一个精确的时间跨度，以毫秒为单位表示。
7 、 Period(Yeays 、 Days 、 Hours....)
类似于 Duration, 但以天、月、年、时、分、秒等为单位表示
8 、 TimeZone
时区处理类，用于计算每个时区的时间偏移量，类似于 java.util.TimeZone 。
9 、 DateTimeFormatter
时间解析与格式化处理类 , 用于日期和时间与字符串之间的转换，类似于 jdk 的 DateFormat 。
10 、 DateTimeFormat
DateTimeFormatter 的工厂类，提供各种创建DateTimeFormatter 实例方法。
11 、 DateTimeFormatterBuilder
DateTimeFormatter 构造器，当需要实现自定义的时间格式时可使用。

---

Demo

0.时间解析

DateTimeFormatter format = DateTimeFormat.forPattern("yyyy-MM-dd HH:mm:ss");
DateTime dateTime2 = DateTime.parse("2012-12-21 23:22:45", format);

1、时间类得作成

//方法一：取系统点间
DateTime dt1 = new DateTime();  
//方法二：通过java.util.Date对象生成
DateTime dt2 = new DateTime(new Date());  
//方法三：指定年月日点分秒生成(参数依次是：年,月,日,时,分,秒,毫秒)
DateTime dt3 = new DateTime(2012, 5, 20, 13, 14, 0, 0);  
//方法四：ISO8601形式生成
DateTime dt4 = new DateTime("2012-05-20");  
DateTime dt5 = new DateTime("2012-05-20T13:14:00");  
//只需要年月日的时候
LocalDate localDate = new LocalDate(2009, 9, 6);// September 6, 2009
//只需要时分秒毫秒的时候
LocalTime localTime = new LocalTime(13, 30, 26, 0);// 1:30:26PM

2、获取年月日点分秒

 DateTime dt = new DateTime();  
//年
int year = dt.getYear();  
//月
int month = dt.getMonthOfYear();  
//日
int day = dt.getDayOfMonth();  
//星期
int week = dt.getDayOfWeek();  
//点
int hour = dt.getHourOfDay();  
//分
int min = dt.getMinuteOfHour();  
//秒
int sec = dt.getSecondOfMinute();  
//毫秒
int msec = dt.getMillisOfSecond(); 

3、星期的特殊处理

DateTime dt = new DateTime();  
//星期
switch(dt.getDayOfWeek()) {  
case DateTimeConstants.SUNDAY:  
    System.out.println("星期日");  
break;  
case DateTimeConstants.MONDAY:  
    System.out.println("星期一");  
break;  
case DateTimeConstants.TUESDAY:  
    System.out.println("星期二");  
break;  
case DateTimeConstants.WEDNESDAY:  
    System.out.println("星期三");  
break;  
case DateTimeConstants.THURSDAY:  
    System.out.println("星期四");  
break;  
case DateTimeConstants.FRIDAY:  
    System.out.println("星期五");  
break;  
case DateTimeConstants.SATURDAY:  
    System.out.println("星期六");  
break;  
} 

4、与JDK日期对象的转换

DateTime dt = new DateTime();  
//转换成java.util.Date对象
Date d1 = new Date(dt.getMillis());  
Date d2 = dt.toDate();  
//转换成java.util.Calendar对象
Calendar c1 = Calendar.getInstance();  
c1.setTimeInMillis(dt.getMillis());  
Calendar c2 = dt.toCalendar(Locale.getDefault());  

5、日期前后推算 

DateTime dt = new DateTime();  
//昨天
DateTime yesterday = dt.minusDays(1);         
//明天
DateTime tomorrow = dt.plusDays(1);       
//1个月前
DateTime before1month = dt.minusMonths(1);        
//3个月后
DateTime after3month = dt.plusMonths(3);          
//2年前
DateTime before2year = dt.minusYears(2);          
//5年后
DateTime after5year = dt.plusYears(5);

6、取特殊日期

DateTime dt = new DateTime();     
//月末日期  
DateTime lastday = dt.dayOfMonth().withMaximumValue();  
//90天后那周的周一
DateTime firstday = dt.plusDays(90).dayOfWeek().withMinimumValue();  

7、时区

 //默认设置为日本时间
DateTimeZone.setDefault(DateTimeZone.forID("Asia/Tokyo"));  
DateTime dt1 = new DateTime();  
//伦敦时间
DateTime dt2 = new DateTime(DateTimeZone.forID("Europe/London")); 

8、计算区间

DateTime begin = new DateTime("2012-02-01");  
DateTime end = new DateTime("2012-05-01");  
//计算区间毫秒数
Duration d = new Duration(begin, end);  
long time = d.getMillis();  
//计算区间天数
Period p = new Period(begin, end, PeriodType.days());  
int days = p.getDays();  
//计算特定日期是否在该区间内
Interval i = new Interval(begin, end);  
boolean contained = i.contains(new DateTime("2012-03-01"));  

9、日期比较 

DateTime d1 = new DateTime("2012-02-01");  
DateTime d2 = new DateTime("2012-05-01");  
//和系统时间比
boolean b1 = d1.isAfterNow();  
boolean b2 = d1.isBeforeNow();  
boolean b3 = d1.isEqualNow();  
//和其他日期比
boolean f1 = d1.isAfter(d2);  
boolean f2 = d1.isBefore(d2);  
boolean f3 = d1.isEqual(d2); 

10、格式化输出 

DateTime dateTime = new DateTime();  
String s1 = dateTime.toString("yyyy/MM/dd hh:mm:ss.SSSa");  
String s2 = dateTime.toString("yyyy-MM-dd HH:mm:ss");  
String s3 = dateTime.toString("EEEE dd MMMM, yyyy HH:mm:ssa");  
String s4 = dateTime.toString("yyyy/MM/dd HH:mm ZZZZ");  
String s5 = dateTime.toString("yyyy/MM/dd HH:mm Z");