美文网首页jdk程序员Java 杂谈
java 8的java.time包(非常值得推荐)

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

作者: 不姓马的小马哥 | 来源:发表于2017-03-22 14:37 被阅读660次

    前言:

    用过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
    

    相关文章

      网友评论

      本文标题:java 8的java.time包(非常值得推荐)

      本文链接:https://www.haomeiwen.com/subject/geyonttx.html