Joda-Time的使用
版权声明:本文为博主原创文章,未经博主允许不得转载。
简介
Java中处理时间与日期是很常见的操作,jdk中基础的工具类就是我们熟悉的Date和Calendar,然而这些工具类的api使用并不是很方便和强大。于是就诞生了Joda-Time这个专门处理日期时间的库。(JDK1.8的API已经重写了日期库,引入的java.time包,其实也是借鉴了Joda-Time)
依赖jar包
- <dependency>
- <groupId>joda-time</groupId>
- <artifactId>joda-time</artifactId>
- <version>2.9.9</version>
- </dependency>
类说明
- Instant:不可变类,代表时间线上的一个瞬时的时间点
- DateTime:不可变类,它以毫秒级的精度封装时间上的某个瞬间时刻,用来替换JDK的Calendar类
- LocalDate:不可变类,该类封装了一个年/月/日的组合。没有时区信息
- LocalTime:不可变类,表示一个本地的时间,而不包含日期部分。没有时区信息
- LocalDateTime:不可变类,该类封装了一个年/月/日 时:分:秒的组合。没有时区信息
使用
构造一个DateTime实例
下面介绍一些常用的构造方法:
- DateTime():这个无参的构造方法会创建一个在当前系统所在时区的当前时间,精确到毫秒
- DateTime(int year, int monthOfYear, int dayOfMonth, int hourOfDay, int minuteOfHour, int secondOfMinute):这个构造方法方便快速地构造一个指定的时间,这里精确到秒,类似地其它构造方法也可以传入毫秒。
- DateTime(long instant):这个构造方法创建出来的实例,是通过一个long类型的时间戳,它表示这个时间戳距1970-01-01T00:00:00Z的毫秒数。使用默认的时区。
- DateTime(Object instant):这个构造方法可以通过一个Object对象构造一个实例。这个Object对象可以是这些类型:ReadableInstant, String, Calendar和Date。其中String的格式需要是ISO8601格式
- DateTime dt = new DateTime();
- DateTime dt = new DateTime(new Date());
- // 创建指定日期时间如:2017-11-27 14:30:50:500
- DateTime dt = new DateTime(2017, 11, 27, 14, 30, 50, 500);
- System.out.println(dt.toString("yyyy-MM-dd HH:mm:ss"));
方法:
- with开头的方法(比如:withYear):用来设置DateTime实例的某个时间。因为DateTime是不可变对象,所以没有提供setter方法可供使用,with方法也没有改变原有的对象,而是返回了设置后的一个副本对象。
- plus/minus开头的方法(比如:plusDay, minusMonths):用来返回在DateTime实例上增加或减少一段时间后的实例。
- 返回Property的方法:Property是DateTime中的属性,保存了一些有用的信息。
- DateTime dt = new DateTime(2000, 11, 27, 0, 0, 0);
- System.out.println(dt);
- dt = dt.withYear(2017);// 设置年份为2017
- System.out.println(dt);
时间获取:
- DateTime dt = new DateTime(2000, 11, 27, 0, 0, 0);
- System.out.println(dt);
- dt = dt.withYear(2017); // 设置年份为2017
- System.out.println(dt);
- int year = dt.getYear();// 年
- int month = dt.getMonthOfYear();// 月
- int day = dt.getDayOfMonth();// 日
- int hour = dt.getHourOfDay();// 小时
- int minute = dt.getMinuteOfHour();// 分钟
- int second = dt.getSecondOfMinute();// 秒
- int millis = dt.getMillisOfSecond();// 毫秒
- System.out.println(year + "-" + month + "-" + day + " " + hour + ":" + minute + ":" + second + ":" + millis);
- String month2 = dt.monthOfYear().getAsText();
- String day2 = dt.dayOfWeek().getAsShortText();
- String day3 = dt.dayOfWeek().getAsShortText(Locale.CHINESE); // 以指定格式获取
- System.out.println(month2);
- System.out.println(day2);
- System.out.println(day3);
时间计算:
- dt = dt.plusDays(1);// 加一天
- dt = dt.plusHours(1);// 加一小时
- dt = dt.plusYears(-1);// 减一年
- System.out.println(dt.toString("yyyy-MM-dd HH:mm:ss"));
- dt = dt.minusYears(1);// 减一年
- dt = dt.minusMinutes(-30);// 加半个小时
- System.out.println(dt.toString("yyyy-MM-dd HH:mm:ss"));
与jdk互操作:
- Date date = dt.toDate();
- Calendar calendar = dt.toCalendar(Locale.CHINESE);
- // 某些属性进行置0操作。比如,我想得到当天的0点时刻。
- DateTime now = new DateTime();
- now.dayOfWeek().roundCeilingCopy();
- now.dayOfWeek().roundFloorCopy();
- now.minuteOfDay().roundFloorCopy();
- now.secondOfMinute().roundFloorCopy();
其它:还有许多其它方法(比如dateTime.year().isLeap()来判断是不是闰年)。它们的详细含义,请参照API
参考文档: