简介
Joda-Time，一个面向 Java 平台的易于使用的开源时间/日期库。
Joda-Time可以用来替换JDK的日期处理类，并且比 JDK中的时间类更加优秀。
地址
GitHub：https://github.com/JodaOrg/joda-time
官网：http://www.joda.org/joda-time/
Gradle： compile 'joda-time:joda-time:2.9.6'
使用
1、初始化
DateTime 类作为最重要和最核心的一个类，
Joda-Time 为它提供了丰富的初始化方式。
注意：DateTime 一旦创建，时间值将不能更改。所有时间更改的操作会重 新返回一个新的DateTime。
DateTime dateTime;dateTime = new DateTime(); //以当前系统的毫秒级时间构建实例
dateTime = new DateTime(1481006233254L); //以毫秒级时间参数构建实例
dateTime = new DateTime("2016-11-22"); // 以String为参数构造实例
dateTime = new DateTime(2016,12,1,11,22,59); // 以 年.月.日.时.分.秒 构造实例
dateTime = new DateTime(2016,12,1,11,22,59,114); // 以 年.月.日.时.分.秒.毫秒 构造实例
dateTime = new DateTime(new Date()); // 以 JDK中Date为参数构造实例
dateTime = new DateTime(Calendar.getInstance()); // 以 JDK中Calendar为参数构造实例
dateTime = new DateTime(new DateTime()); // 以 DateTime本身为参数构造实例
// 注意：以上的每种实例化方式都可以在最后加上DateTimeZone参数来指定时区。
// 或者加上Chronology参数指定年表。
// 两个参数都不传或者传null，使用默认值
DateTimeFormatter format = DateTimeFormat .forPattern("yyyy-MM-dd HH:mm:ss");
// 通过DateTime的parse方法解析时间
DateTime dateTime = DateTime.parse("2016-12-1 14:22:45", format);
2、格式化输出
比较复杂的写法是通过DateTimeFormatter 来格式化：
DateTime dateTime = new DateTime();
// 使用DateTimeFormatter 格式化日期
DateTimeFormatter fmt = DateTimeFormat.forPattern("yyyy-MM-dd");
// DateTimeFormatter 作为参数传到toString方法中
String time = dateTime.toString(fmt);
// --> 输出： 2016-12-06
更加简便的方式：
// 更简单的方法
DateTime dateTime = new DateTime();
// toString方法有一个String类型参数的重载
String time = dateTime.toString("yyyy-MM-dd");
// --> 输出： 2016-12-06
// 既然如此，我们可以更方便输出更多格式
dateTime.toString("MM/dd/yyyy hh:mm:ss.SSS");
dateTime.toString("dd-MM-yyyy HH:mm:ss");
dateTime.toString("EEEE dd MMMM, yyyy HH:mm:ss");
dateTime.toString("MM/dd/yyyy HH:mm ZZZZ");
dateTime.toString("MM/dd/yyyy HH:mm Z");
3、日期的比较
DateTime dateTime = new DateTime("2014-11-22");
DateTime dateTime2 = new DateTime("2014-11-22");
DateTime dateTime3 = new DateTime("2015-12-25");
dateTime.isEqual(dateTime2); // true
dateTime.isBefore(dateTime3); // true
比较的方法有 isEqual isBefore isAfter 。
每个方法对应三种重载，同时还有和当前时间比较的方法：
比较时间的方法
4、日期的操作
- 设置日期
设置日期的方法都是以with开头
// 初始化一个DateTime
DateTime dateTime = new DateTime("2016-3-31");
dateTime.toString("yyyy-MM-dd hh:mm:ss");//2016-03-31 12:00:00
//将 年 设置为2014。
//前面说过，所有更改时间的操作都会返回新的DateTime
//旧的DateTime 日期值不会改变
DateTime dateTime1 = dateTime.withYear(2014);
dateTime1.toString("yyyy-MM-dd hh:mm:ss");//2014-03-31 12:00:00
设置时间属性的方法比较多，可以设置年月日、时分秒、时区等等。
基本都是以with开头，比较直观。
更多细节可以参考官方文档
- 增加日期
增加日期的方法都是以plus 开头
DateTime dateTime = new DateTime();
dateTime.toString("yyyy-MM-dd hh:mm:ss"); // 2016-12-06 03:15:07
// 当前时间基础上加上两天
DateTime dateTime2 = dateTime.plusDays(2);
dateTime2.toString("yyyy-MM-dd hh:mm:ss"); // 2016-12-08 03:15:07
增加日期的方法还有不少，也比较直观：
增加日期的方法
- 减少日期
减少日期的方法都是以minus开头
DateTime dateTime = new DateTime();
dateTime.toString("yyyy-MM-dd hh:mm:ss"); //2016-12-06 03:20:45
// 减少五个月，并返回一个新的DateTime
DateTime dateTime2 = dateTime.minusMonths(5);
dateTime2.toString("yyyy-MM-dd hh:mm:ss"); //2016-07-06 03:20:45
更多减少日期方法：
减少日期方法
5、获取日期属性
- get方法获取
通过get开头的方法，可以获取一些常用的属性
DateTime dateTime = new DateTime("2016-3-31");
int dayOfWeek = dateTime.getDayOfWeek();
Log.i("tag", "3月31是星期："+dayOfWeek);
// -->3月31是星期：4
更多get方法：
获取日期属性
- 使用Property获取日期属性
Property是DateTime中的属性，使用Property可以做一些get方法无法进行的操作。
DateTime dateTime = new DateTime("2016-3-31");
dateTime.dayOfWeek().getAsShortText(Locale.ENGLISH); //Thu
dateTime.dayOfWeek().getAsShortText(Locale.CHINA); //周四
dateTime.dayOfWeek().getAsText(Locale.KOREAN); // 목요일 (韩语:星期四)
dateTime.dayOfWeek().getAsText(Locale.CHINA); //星期四
// getAsShortText：获取缩略的文本
// getAsText ： 获取完整的文本
问题：如果我们将 3月31日 减少 1 个月，这个输出的结果会是什么呢？
结果不可能是2月31日的 ， 因为2月不存在31日。
我们运行程序看看结果：
DateTime dateTime = new DateTime("2016-3-31");
Log.i("tag", dateTime.toString("yyyy-MM-dd hh:mm:ss"));
DateTime dateTime1 = dateTime.minusMonths(1);
Log.i("tag", dateTime1.toString("yyyy-MM-dd hh:mm:ss"));
输出结果
从图中可以看出DateTime 对这种情况是做了很好处理。
更多介绍参考用户手册
-- end --
