Java.time 包的优势
使用Java8,新的日期时间API引入覆盖旧的日期时间API的以下缺点。
-
非线程安全 - java.util.Date不是线程安全的,因此开发者必须在使用日期处理并发性问题。新的日期时间API是不可变的,并且没有setter方法。
-
设计不佳 - 默认的开始日期从1900年,开始每月从1天从0开始,所以没有统一。不直接使用方法操作日期。新的API提供了这样操作实用方法。
-
困难的时区处理 - 开发人员必须编写大量的代码来处理时区的问题。新的API设计开发保持特定领域设计。
JAVA8引入了 java.time 包 - 下一个新的日期时间API。以下是一些在java.time程序包引入重要的类。
-
本地 - 简化日期时间API,没有时间处理区的复杂性。
-
时区 - 专业的日期时间API来处理各种时区。
java.time 本地日期时间类
java.time处理本地日期时间的主要类为
LocalDateTime,LocalDate,LocalTime;
- LocalDateTime可以处理日期时间,可以看做作为LocalDate,LocalTime的复合;
- LocalDate主要处理日期(year,month,day,week);
- LocalTime主要处理时间(h,m,s)
LocalDateTime
静态构造方式摘要 | |||
static LocalDateTime static LocalDateTime static LocalDateTime static LocalDateTime |
now() of(int year,int month,int dayofMonth,int hour,int minute[,int second[,int nanoSeconds]] ) parse(CharSequence text) ofEpochSecond(long epochSeconds,int nanoSeconds,ZoneOffset offset) |
使用当前时间构造一个LocalDateTime对象 使用指定的数值创建一个LocalDateTime对象 (year,month,day从1开始,hour,min,second从0开始) 使用形如 “2017-2-28T13:29:30”的格式创建对象 使用纪元流逝秒创建对象,起点为 1970-1-1T00:00:00,offset一般使用ZoneOffset.UTF |
|
成员方法摘要 | |||
+LocalDate +LocalTime +ZoneDateTime +LocalDateTime +int +LocalDateTime +String |
toLocalDate() toLocalTime() atZone() with(TemporalField field,long value) get(TemporalField field) plus(TemporalAmount amoutToAdd) plus(long amountToAdd,TemporaUnit unit) toString() |
获取该对象的 LocalDate对象 获取该对象的 LocalTime对象 获取该对象的 ZoneDateTime对象 修改LocalDateTime的时间数值参数(可以链式调用) 获取LocalDateTime的时间数值参数 对LocalDateTime的某个时间参数值的流逝量 字符串格式:2017-2-28T13:29:30 |
注:localDateTime的 with,get,plus 方法,都有单项filed的实现 with[Filed](int filed),如 withDayOfMonth(int days),主要Field值如下:
- with,get: year,month,dayOfMonth,hour,minute,second,dayOfYear;
- plus : years,months,weeks,days,hours,minutes,seconds,nanos;
LocalDate
静态构造方式摘要 | |||
static LocalDate static LocalDate static LocalDate static LocalDate static LocalDate |
now() of(int year,int month[,int dayofMonth] ) parse(CharSequence text) ofEpochDay(long epochDay) ofYearDay(int year,int dayOfyear) |
使用当前时间构造一个LocalDate对象 使用指定的数值创建一个LocalDate对象 使用形如 “2017-2-28”的格式创建对象 使用纪元流逝天数创建对象 指定年份,使用一年的总天数创建对象 |
|
成员方法摘要 | |||
+LocalDateTime +LocalDateTime +ZoneDateTime +LocalDateTime +int +LocalDateTime +String |
asStartOfDay() atTime(int hour,int minute[,int second]) atZone() with(TemporalField field,long value) get(TemporalField field) plus(TemporalAmount amoutToAdd) plus(long amountToAdd,TemporaUnit unit) toString() |
获取该对象的 LocalDateTime对象(time值归零) 使用指定time值,创建LocalDateTime对象 获取该对象的 ZoneDateTime对象 修改LocalDate的时间数值参数(可以链式调用) 获取LocalDate的时间数值参数 对LocalDate的某个时间参数值的流逝量 字符串格式:2017-2-28 |
注:同LocalDateTime ,LocalDate的 with,get,plus 方法,也都有单项filed的实现 with[Filed](int filed),主要Field值如下:
- with,get: year,month,dayOfMonth,dayOfYear;
- plus : years,months,weeks,days;
LocalTime
静态构造方式摘要 | |||
static LocalTime static LocalTime static LocalTime static LocalTime static LocalTime |
now() of(int hour,int minute[,int dayofMonth] ) parse(CharSequence text) ofSecondOfDay(long seconds) ofNanoOfDay(long nanoSeconds) |
使用当前时间构造一个LocalDate对象 使用指定的数值创建一个LocalDate对象 使用形如 “2017-2-28”的格式创建对象 使用指定seconds创建对象 使用指定nanoSeconds创建对象 |
|
成员方法摘要 | |||
+LocalDateTime +LocalTime +int +LocalTime +int +int +String |
atDate(LocalDate date) with(TemporalField field,long value) get(TemporalField field) plus(TemporalAmount amoutToAdd) plus(long amountToAdd,TemporaUnit unit) toSecondOfDay() toNanoOfDay() toString() |
于一个LocalDate对象创建一个LocalDateTime对象 修改LocalTime的时间数值参数(可以链式调用) 获取LocalTime的时间数值参数 对LocalTime的某个时间参数值的流逝量 获取总Second参数 获取总Nano参数 字符串格式:10:15:00 |
注:同LocalDateTime ,LocalTime的 with,get,plus 方法,也都有单项filed的实现 with[Filed](int filed),主要Field值如下:
- with,get: hour,minute,second;
- plus : hours,minutes,seconds,nanos;
-
LocalDateTime,LocalDate,LocalTime都实现了compareTo,equals方法;
-
with,get方法中,实现 TemporalField 接口的类:java.time.temporal.ChronoField;
-
plus方法中,实现 TemporalAmout 接口的类:java.time.Duration,java.time.Peroid
ChronoField、
ChronoUnit常量摘要
ChronoField | ChronoUnit | ||
YEAR MONTH_OF_YEAR DAY_OF_MONTH DAY_OF_WEEK DAY_OF_YEAR HOUR_OF_DAY 24小时制hour HOUR_OF_AMPM 12小时制hour AMPM_OF_DAY 0(AM),1(PM) MINUTE_OF_HOUR MINUTE_OF_DAY SECOND_OF_MINUTE SECOND_OF_OF_DAY OFFSET_SECOND UTF流逝秒数 MILLI_OF_SECOND MILLI_OF_DAY NANO_OF_SECOND NANO_OF_DAY |
FOREVER CENTURIES YEARS MONTHS WEEKS DAYS HOURS MINUTES SECONDS NANOS |
使用示例
import java.time.*;
import java.time.temporal.ChronoField;
import java.time.temporal.ChronoUnit;
.....
//构建LocalDateTime
LocalDateTime dateTime1 = LocalDateTime.now();
LocalDateTime dateTime2 = LocalDateTime.of(2017,1,1,0,0,0);
System.out.println("datetime1:"+dateTime1+"\ndatetime2:"+dateTime2);
-
//修改LocalDateTime数值
LocalDateTime dateTime3 = dateTime1.with(ChronoField.YEAR,1992).with(ChronoField.MONTH_OF_YEAR,9).with(ChronoField.DAY_OF_MONTH,16);
System.out.println("datetime3:"+dateTime3);
-
//获取LocalDateTime数值
int year_dateTime3 = dateTime3.get(ChronoField.YEAR);
Month month_dateTime3 = dateTime3.getMonth();
int day_dateTime3 = dateTime3.get(ChronoField.DAY_OF_MONTH);
System.out.println("year:"+year_dateTime3+"\nmonth:"+month_dateTime3+"\nday:"+day_dateTime3);
-
//对LocalDateTime进行数值增减
LocalDateTime dateTime4 = dateTime3.plus(10,ChronoUnit.MONTHS).plusDays(100).plusHours(120);
System.out.println("datetime4:"+dateTime4);
System.out.println("datetime4:"+dateTime4.toEpochSecond(ZoneOffset.UTC));
-
//将LocalDateTime装载到LocalDate和LocalTime
LocalDate date1 = dateTime4.toLocalDate();
LocalTime time1 = dateTime4.toLocalTime();
System.out.println("date1:"+date1);
System.out.println("time1:"+time1);
输出结果:
datetime1:2017-02-28T19:42:09.550
datetime2:2017-01-01T00:00
datetime3:1992-09-16T19:42:09.550
year:1992
month:SEPTEMBER
day:16
datetime4:1993-10-29T19:42:09.550
datetime4:751923729
date1:1993-10-29
time1:19:42:09.550