参考:
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");