java 8的java.time包(非常值得推荐)

前言:

用过java1.8之前原生的日期处理api,你就会知道用起来非常麻烦,而且要注意的地方有点多(例如月份是由0开始,而且api使用有的不统一,线程不安全等等...),所以在java1.8之前的日期api都不值得去使用,虽然说现在都有强大的日期处理的第三方库,但是会有兼容性问题,那么现在jdk8有了新的时间处理类,为何不去尝试一下呢

java.time包下有5个包组成(大部分人用到基础包和format包就足够了)

java.time – 包含值对象的基础包
java.time.chrono – 提供对不同的日历系统的访问
java.time.format – 格式化和解析时间和日期
java.time.temporal – 包括底层框架和扩展特性
java.time.zone – 包含时区支持的类

先看看对这个包的概述:

java.time 包是在JDK8新引入的，提供了用于日期、时间、实例和周期的主要API。

java.time包定义的类表示了日期-时间概念的规则，包括instants, durations, dates, times, time-zones and periods。这些都是基于ISO日历系统，它又是遵循 Gregorian规则的。

所有类都是不可变的、线程安全的。

再看看对这些类的介绍:

LocalDateTime：只存储了日期和时间，如：2017-03-21T14:02:43.455。(后面的.455表示毫秒值的最后三位,使用.withNano(0)可把毫秒值设为0)

LocalDate：只存储了日期，如：2017-03-21。

LocalTime：只存储了时间，如：14:02:43.455。(后面的.455表示毫秒值的最后三位,使用.withNano(0)可把毫秒值设为0)

Year：只表示年份。

Month：只表示月份。

YearMonth：只表示年月。

MonthDay：只表示月日。

DayOfWeek：只存储星期的一天。

Instant 相当于java.util的Date

Clock 它通过指定一个时区，然后就可以获取到当前的时刻，日期与时间。Clock可以替换System.currentTimeMillis()与TimeZone.getDefault()。

ZonedDateTime 可以得到特定时区的日期/时间

Duration 是用来计算两个日期的时间差

然后再看看它与java.util.Calendar的api比较:

可以看到在java.time当中,星期一的值为1,星期日的值为7,而在Calendar当中星期日的值为1,而且java.time中一月份的值为1,Calendar一月份的值为0(多么反人类的设计,多多少少让人不自在),如果你会使用Calendar的话,那么你要上手java.time包也是很快的.

还有一些方法前缀的含义,统一了api:

of：静态工厂方法(用类名去调用)。

parse：静态工厂方法，关注于解析(用类名去调用)。

now： 静态工厂方法，用当前时间创建实例(用类名去调用)

get：获取某些东西的值。

is：检查某些东西的是否是true。

with：返回一个部分状态改变了的时间日期对象拷贝(单独一个with方法,参数为TemporalAdjusters类型)

plus：返回一个时间增加了的、时间日期对象拷贝(如果参数是负数也能够有minus方法的效果)

minus：返回一个时间减少了的、时间日期对象拷贝

to：把当前时间日期对象转换成另外一个，可能会损失部分状态.

at：把这个对象与另一个对象组合起来，例如： date.atTime(time)。

format :根据某一个DateTimeFormatter格式化为字符串

新时间API类都实现了一系列方法用以完成通用的任务，如：加、减、格式化、解析、从日期/时间中提取单独部分，等等

time包里面的类实例如果用了上面的方法而被修改了,那么会返回一个新的实例过来,而不像Calendar那样可以在同一个实例进行不同的修改,体现了不可变

---

java.time.temporal.ChronoField枚举类

此枚举类是作为get方法的参数获取时间的值
它里面的属性含义有的跟Calendar的成员变量含义差不多,想要了解一下可以看我的关于Calendar类详解的文章 ,如果要看很详细的讲解可以去查看ChronoField类的官方api文档

演示一下判断当前时间是属于上午还是下午:

        LocalDateTime now = LocalDateTime.now();
        switch (now.get(ChronoField.AMPM_OF_DAY)) {
        case 0:
            System.out.println("上午");
        case 1:
            System.out.println("下午");
        }
        //打印 下午

---

java.time.temporal.TemporalAdjusters类

此类配合java.time基础包中类的with方法:

LocalDate now = LocalDate.now();

        //当前月份的第一天的日期,2017-03-01
        System.out.println(now.with(TemporalAdjusters.firstDayOfMonth())); 
        
        //下一个月的第一天的日期,2017-04-01
        System.out.println(now.with(TemporalAdjusters.firstDayOfNextMonth())); 
        
        //当前月份的最后一天,2017-03-31 --再也不用计算是28，29，30还是31
        System.out.println(now.with(TemporalAdjusters.lastDayOfMonth())); 

---

java.time.format.DateTimeFormatter

此类的功能与SimpleDateFormat类的功能类似,此类也是线程安全的,在写成时间处理工具类时,可作为静态成员变量,而不用每次都new一个SimpleDateFormat实例,此类是用来创建日期显示的模板,然后对于日期的格式化和解析还是使用LocalDateTime等类的parse静态方法和format方法,其模板属性格式是和SimpleDateFormat一样的,请看:

G 年代标志符
y 年
M 月
d 日
h 时 (12小时制)
H 时 (24小时制)
m 分
s 秒
S 毫秒
E 星期几
D 一年中的第几天
F 一月中第几个星期(以每个月1号为第一周,8号为第二周为标准计算)
w 一年中第几个星期
W 一月中第几个星期(不同于F的计算标准,是以星期为标准计算星期数,例如1号是星期三,是当月的第一周,那么5号为星期日就已经是当月的第二周了)
a 上午 / 下午 标记符
k 时 (24小时制,其值与H的不同点在于,当数值小于10时,前面不会有0)
K 时 (12小时值,其值与h的不同点在于,当数值小于10时,前面不会有0)
z 时区

对于此类使用先来个简单的新旧api对比演示:

1 .Date转String

        //使用Date和SimpleDateFormat
        SimpleDateFormat simpleDateFormat = 
                        new SimpleDateFormat("G yyyy年MM月dd号 E a hh时mm分ss秒");
        
        String format = simpleDateFormat.format(new Date());
        
        System.out.println(format); 
        //打印: 公元 2017年03月21号 星期二 下午 06时38分20秒
        

        //使用jdk1.8 LocalDateTime和DateTimeFormatter
        LocalDateTime now = LocalDateTime.now();
        DateTimeFormatter pattern = 
                   DateTimeFormatter.ofPattern("G yyyy年MM月dd号 E a hh时mm分ss秒");
        String format = now.format(pattern);
        System.out.println(format);
      //打印: 公元 2017年03月21号 星期二 下午 06时38分20秒

2 .String转Date

         //使用Date和SimpleDateFormat
        SimpleDateFormat simpleDateFormat = 
                  new SimpleDateFormat("yyyy-MM-dd hh:mm:ss");
        
        Date date = simpleDateFormat.parse("2017-12-03 10:15:30");
        
        System.out.println(simpleDateFormat.format(date));
        //打印 2017-12-03 10:15:30

        //使用jdk1.8 LocalDateTime和DateTimeFormatter
        DateTimeFormatter pattern = 
                    DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");

        //严格按照ISO yyyy-MM-dd验证，03写成3都不行
        LocalDateTime dt = LocalDateTime.parse("2017-12-03 10:15:30",pattern); 
        
        System.out.println(dt.format(pattern));

---

下面演示一次java.time基础包中的类的使用:

1. java.time.LocalDateTime

此类显示的是年月日时分秒(默认的格式为:2017-01-01T01:01:01.555)

LocalDateTime now = LocalDateTime.now();
        System.out.println(now.toString());
        System.out.println(now.getYear());
        System.out.println(now.getMonthValue());
        System.out.println(now.getDayOfMonth());
        System.out.println(now.getHour()); //24小时制
        System.out.println(now.getMinute());
        System.out.println(now.getSecond());
        System.out.println(now.getNano()); //毫秒值的后三位作为前三位后面补6个零
      
打印的结果为:  
2017-03-21T20:26:18.317
2017
3
21
20
26
18
317000000

//能够自定义时间
        LocalDateTime time = LocalDateTime.of(2017, 1, 1, 1, 1,1);
        System.out.println(time); //2017-01-01T01:01:01
        
        //使用plus方法增加年份
        LocalDateTime time = LocalDateTime.of(2017, 1, 1, 1, 1,1);

        //改变时间后会返回一个新的实例nextYearTime
        LocalDateTime nextYearTime = time.plusYears(1); 

        System.out.println(nextYearTime); //2018-01-01T01:01:01
        
        //使用minus方法减年份
        LocalDateTime time = LocalDateTime.of(2017, 1, 1, 1, 1,1);
        LocalDateTime lastYearTime = time.minusYears(1);
        System.out.println(lastYearTime); //2016-01-01T01:01:01
        
        //使用with方法设置月份
        LocalDateTime time = LocalDateTime.of(2017, 1, 1, 1, 1,1);
        LocalDateTime changeTime = time.withMonth(12);
        System.out.println(changeTime); //2017-12-01T01:01:01
        
        //判断当前年份是否闰年
        System.out.println("isLeapYear :" + time.isLeapYear());
        
        //判断当前日期属于星期几
        LocalDateTime time = LocalDateTime.now();
        DayOfWeek dayOfWeek = time.getDayOfWeek();
        System.out.println(dayOfWeek); //WEDNESDAY

2. java.time.LocalDate

此类显示的是年月日(默认的格式为:2017-01-01)
用法与LocalDateTime类大致一样

3. java.time.LocalTime

此类显示的是时分秒和毫秒值的后三位(21:26:35.693)
用法与LocalDateTime类大致一样

3. java.time.Instant

此类功能和java.util.Date类类似

Instant now = Instant.now();
        System.out.println(now.toEpochMilli());//获取当前时间的毫秒值
        System.out.println(now.isAfter(now)); //当前时间是否在参数中的时间之后
        System.out.println(now.isBefore(now));//当前时间是否在参数中的时间之前

        //当前时间与参数中的时间进行对比,在参数的时间之前,相同,之后的值分别是(-1,0,1)
        System.out.println(now.compareTo(now));
        

        //用一个时间戳去创建一个Instance实例,用法和new Date(时间戳)创建一个Date实例是一样的
        Instant ofEpochMilli = Instant.ofEpochMilli(System.currentTimeMillis()); 

       System.out.println(now.getEpochSecond());//获取当前时间的秒

4.java.time.Instant和java.time.LocalDateTime互转

4.1 Instance转LocalDateTime

Instant instant = Instant.ofEpochMilli(System.currentTimeMillis());
        
        ZoneId systemDefault = ZoneId.systemDefault();
        
        LocalDateTime now = LocalDateTime.ofInstant(instant, systemDefault);
        
        System.out.println(now); //2017-03-22T13:44:34.979

4.2 LocalDateTime转Instance

LocalDateTime now = LocalDateTime.now();

        ZoneId systemDefault = ZoneId.systemDefault();
        
        Instant instant = now.atZone(systemDefault).toInstant();
        
        System.out.println(instant.toEpochMilli()); //1490163685578

4. java.time.Duration

此类用来计算两同类型日期的时间差,看演示:

LocalDateTime start = LocalDateTime.of(2017, 1, 1, 1, 1);
LocalDateTime end = LocalDateTime.of(2017, 2, 1, 1, 1);

        Duration result = Duration.between(start, end);
        System.out.println(result.toDays()); //31
        System.out.println(result.toHours()); //744
        System.out.println(result.toMinutes()); //44640
        System.out.println(result.toMillis()); //2678400000
        System.out.println(result.toNanos()); //2678400000000000

其中between方法计算两日期时间差,两参数都是Temporal接口类型的日期,来看看Temporal的实现类:

HijrahDate, Instant, JapaneseDate, LocalDate, LocalDateTime, LocalTime, MinguoDate, OffsetDateTime, OffsetTime, ThaiBuddhistDate, Year, YearMonth, ZonedDateTime

---

java.util.Date或java.util.Calendar到新库类的转换

转换可通过下面的方法进行。
Date.toInstant()
Date.from(Instant)
Calendar.toInstant()

---

JDBC

最新JDBC映射将把数据库的日期类型和Java 8的新类型关联起来：

date -> LocalDate
time -> LocalTime
timestamp -> LocalDateTime