Java8新的时间API：LocalDate, LocalTime 和 LocalDateTime

谁借莪１个温暖的怀抱￠ 2023-06-15 11:16 29阅读 0赞

当我们开始使⽤Java操作⽇期和时间的时候，会有⼀些棘⼿。你也许会通过 System.currentTimeMillis() 来返回1970年1⽉1⽇到今天的毫秒数。或者使⽤ Date类来操作⽇期；当遇到加减⽉份、天数的时候 你⼜需要⽤到Calendar类； 当需要格式化⽇期的时候需要使⽤java.text.DateFormat类。 总⽽⾔之在Java中 操作⽇期不是很⽅便，以⾄于很多开发者不得不使⽤第三⽅库，⽐如: jodatime。

# 一、Date存在的问题 #

*  **结构定义混乱**
    
     *  java.util Date包含日期时间
     *  java.sql Date包含日期
     *  java.text 时间格式化
 *  **API不易用**
 *  **非线程安全**
    
     *  可变，SimpleDateFormate
 *  **国际化**  
    Calendar TimeZone

# 二、Java8新的日期时间类 #

*  **结构清晰**
    
     *  java.time LocalDate/LocalTime/LocalDateTime 自带格式化
 *  **不可变，线程安全**
 *  **提供常用的方法，方法名通俗易懂并按照一定规则进行命名，如加、减、格式化、解析、提取某个时间单位**
 *  **扩展性，支持不同的日历系统，ISO-8601和非ISO的日历**
 *  **兼容性，目前hibernate,mybatis,jackson都有很好的支持**

# 三、包结构 #

*  **java.time包**  
    这是新的Java⽇期/时间API的基础包，所有的主要基础类都 是这个包的⼀部分，如：LocalDate, LocalTime, LocalDateTime, Instant, Period, Duration等等。所有这些类都是不可变的和线程安全的，在绝⼤多数 情况下，这些类能够有效地处理⼀些公共的需求。
 *  **java.time.chrono包**  
    这个包为⾮ISO的⽇历系统定义了⼀些泛化的API， 我们可以扩展AbstractChronology类来创建⾃⼰的⽇历系统。
 *  **java.time.format包**  
    这个包包含能够格式化和解析⽇期时间对象的类，在绝⼤多数情况下，我们不应该直接使⽤它们，因为java.time包中相应的类已 经提供了格式化和解析的⽅法。 java.time.temporal包：这个包包含⼀些时态对象，我们可以⽤其找出关于 ⽇期/时间对象的某个特定⽇期或时间，⽐如说，可以找到某⽉的第⼀天或最后⼀天。你可以⾮常容易地认出这些⽅法，因为它们都具有“withXXX”的格 式。
 *  **java.time.zone包**  
    这个包包含⽀持不同时区以及相关规则的类。

# 四、常用类 #

*  ZoneId: 时区ID，⽤来确定Instant和LocalDateTime互相转换的规则
 *  Instant: ⽤来表示时间线上的⼀个点
 *  LocalDate: 表示没有时区的⽇期, LocalDate是不可变并且线程安全的
 *  LocalTime: 表示没有时区的时间, LocalTime是不可变并且线程安全的
 *  LocalDateTime: 表示没有时区的⽇期时间, LocalDateTime是不可变并且 线程安全的
 *  Clock: ⽤于访问当前时刻、⽇期、时间，⽤到时区
 *  Duration: ⽤秒和纳秒表示时间的数量

# 五、API示例 #

最常用的就是LocalDate,LocalTime,LocalDateTime三个类，API很类似，所以接下来以LocalDateTime进行演示

## 5.1 创建 ##

//获取当前时间
    LocalDateTime today = LocalDateTime.now();
    
    //使用LocalDate and LocalTime 创建LocalDateTime
    today = LocalDateTime.of(LocalDate.now(), LocalTime.now());
    
    //通过of方法参数创建
    LocalDateTime specificDate = LocalDateTime.of(2014, Month.JANUARY, 1, 10, 10, 30);
    
    //不正确的参数会抛出异常
    //Exception in thread "main" java.time.DateTimeException: Invalid value for HourOfDay (valid values 0 - 23): 25
    LocalDateTime illegalDate = LocalDateTime.of(2014, Month.FEBRUARY, 28, 25,1,1); 
    
    //获取"Asia/Kolkata",加尔哥达
    LocalDateTime todayKolkata = LocalDateTime.now(ZoneId.of("Asia/Kolkata"));
    
    //通过时间戳获取时间
    LocalDateTime dateFromBase = LocalDateTime.ofEpochSecond(10000, 0, ZoneOffset.UTC);

## 5.2 日期运算 ##

LocalDateTime today = LocalDateTime.now();
    
        //获取当前年，并判断是否是闰年
        System.out.println("Year " + today.getYear() + " is Leap Year? " + today.toLocalDate().isLeapYear());
    
        //比较两个日期的先后
        System.out.println("Today is before 01/01/2015? " + today.isBefore(LocalDateTime.of(2015,1, 1, 11, 30)));
    
        //时间加减
        System.out.println("10 days after today will be " + today.plusDays(10));
        System.out.println("3 weeks after today will be " + today.plusWeeks(3));
        System.out.println("20 months after today will be " + today.plusMonths(20));
        System.out.println("10 days before today will be " + today.minusDays(10));
        System.out.println("3 weeks before today will be " + today.minusWeeks(3));
        System.out.println("20 months before today will be " + today.minusMonths(20));
    
        //查询日期的特定点
        System.out.println("First date of this month= " + today.with(TemporalAdjusters.firstDayOfMonth()));
        LocalDate lastDayOfYear = today.toLocalDate().with(TemporalAdjusters.lastDayOfYear());
        System.out.println("Last date of this year= " + lastDayOfYear);
    
        //两个日期间的间隔
        Period period = today.toLocalDate().until(lastDayOfYear);
        System.out.println("Period Format= " + period);

## 5.3 日期格式化 ##

LocalDateTime now = LocalDateTime.now();
        String formatTime = now.format(DateTimeFormatter.ofPattern("yyyy-MM-dd mm:ss"));
        System.out.println(formatTime);

## 5.4 日期转换 ##

//Date转换为新的API
        Date date = new Date();
        LocalDateTime dateTime = LocalDateTime.ofInstant(date.toInstant(), ZoneId.of(ZoneId.SHORT_IDS.get("PST")));
    
        //LocalDateTime转换为Date
        Date.from(dateTime.atZone(ZoneId.systemDefault()).toInstant());
    
        //Calendar转换为Instant
        Instant time = Calendar.getInstance().toInstant();
        
        //TimeZone 转换为 ZoneId
        ZoneId defaultZone = TimeZone.getDefault().toZoneId();
        System.out.println(defaultZone);

## 5.5 补充 ##

不安全的SimpleDateFormat
    
    public class UnSafeDateFormatExample0 { 
    
        private static SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd HH:mm");
    
        public static void main(String[] args) throws InterruptedException { 
            ExecutorService executorService = Executors.newCachedThreadPool();
            final CountDownLatch countDownLatch = new CountDownLatch(5000);
            final Semaphore semaphore = new Semaphore(50);
    
            for (int i = 0; i < 5000; i++) { 
                executorService.execute(() -> { 
                    try { 
                        semaphore.acquire();
                        format();
                        semaphore.release();
                    } catch (InterruptedException e) { 
                        e.printStackTrace();
                    }
                    countDownLatch.countDown();
                });
            }
            countDownLatch.await();
            executorService.shutdown();
        }
    
        private static void format() { 
            try { 
                format.parse("1999-12-01 12:12");
            } catch (ParseException e) { 
                e.printStackTrace();
            }
        }
    }