Java中 LocalDate、LocalTime、LocalDateTime三个时间工具类的使用介绍

港控/mmm° 2021-12-10 18:59 270阅读 0赞

一、背景：

之前在做项目的过程中，对日期时间类没有一个系统的了解，总是在用的时候去搜索一下，解决问题即完事，久而久之，导致对这个概念特别模糊。直到近期，做项目的过程中使用了mybatis-plus框架，这个框架自动生成映射文件的工具会将MySQL中的datetime类型转化成Java中的LocalDateTime类型，由于几次都出现了转化错误、转化繁琐的问题，因此，就打算详细的了解一下Java中的时间类的相关知识，希望下次再使用能够做到心中有底。经过了几天的了解，对这个时间概念算是有了一个大致的了解，记录下来供以后参考。看来解决问题还得要抓住问题的本质，了解技术的来龙去脉，不能浮于表面。(更好的阅读体验，请移步我的[个人博客][Link 1])

二、介绍：

在JDK8发布的时候，推出了LocalDate、LocalTime、LocalDateTime这个三个时间处理类，以此来弥补之前的日期时间类的不足，简化日期时间的操作。在Java8之前，处理日期时间的类是Date、Calendar，这两个在使用起来总是让人感觉不是很舒服，在设计上面有一些缺陷，并且还不是线程安全的。

想要详细的了解这几个类，我们得要了解一点关于时间、时区划分的一些知识。1884 年, 国际经度会议将地球表面按经线等分为24 区,称为时区。即以本初子午线为基准, 东西经度各7.5 度的范围作为零时区, 然后每隔15度为一时区，每个时区相差一小时。北京时区为东八区，要比零时区早8个小时。如果现在零时区的时间是10点的话，那北京时间就是18点。

我们平时在程序里面所见到的UTC时间，就是零时区的时间，它的全称是Coordinated Universal Time ，即世界协调时间。另一个常见的缩写是GMT，即格林威治标准时间，格林威治位于 零时区，因此，我们平时说的UTC时间和GMT时间在数值上面都是一样的。

可能会有一些疑问，同样是在地球上啊，不同的地区时间怎么还不一样了？难道我现在从北京乘个飞机飞到格林威治，还可以来个时光倒流？如果这样，岂不很神奇？哈哈，当然事情的真相并不是这样的。时间的流逝、细胞的衰老对于整个地球来说都是一样的，因此，不管你在地球的哪里，这一秒过去了，就是过去了，它最为公平，不会多你一分，也不会少你一秒。那怎么记录这流逝的分分秒秒呢？有一个名词，叫做时间戳，它是指格林威治（地球零时区）时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)起至现在的总秒数，这个时间戳，在地球的各个地方都是一致的。在1970年以前，有其他的计时方式，由于没有统一，还造成了一些软件的运行在时间上的错乱，险些酿成了的行业灾难(具体的事件可以网上搜索)。如果单纯指望这个时间戳作为人们的计时标准，那也是不现实的，因为这对人类的生产生活来说没有任何的意义。举个例子：每天早上八点上课（上班）符合我们的习惯，如果是\*\*\*秒到了上课时间就有违人的正常脑回路了。这时候，根据地球上的不同经纬度、地球自转的特点，就划分了时区，时间戳根据不同的时区转化成当地的时间，以此作为作息标准，从而方便人们的生产生活。北京时间的8点我们可以见到太阳的升起，伦敦时间的八点他们也能见到太阳的升起。

就这样，可以知道，时间戳对地球上的任何一个地方都是一样的，如果我们想要把时间戳转化成当地的时间，就需要根据所在地区的时区进行转化。不同时区之间进行时间转化也是一样的道理，我们需要根据时区的差异来转化当地的时间。

三、使用方法：

3.1  Java8 以前的时间处理：

1，Date类的使用：

import java.text.SimpleDateFormat;
    import java.util.Date;
    import java.util.TimeZone;
    
    public class TestTime {
    	
    public static void main(String[] args) {
    	try {
            //获取Date对象，存放的是时间戳
            Date date = new Date();
            //获取时间戳(毫秒)
            long seconds = date.getTime();
            System.out.println("当前时间戳: " + seconds);
           
            //当前GMT(格林威治)时间、当前计算机系统所在时区的时间
            SimpleDateFormat beijingFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
            System.out.println("本地(东八区)时间: " + beijingFormat.format(date) +"; GMT时间: " + date.toGMTString());
            
            //东八区时间转换成东九区(东京)时间,比北京早一个小时
            SimpleDateFormat tokyoFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
            tokyoFormat.setTimeZone(TimeZone.getTimeZone("Asia/Tokyo"));
            System.out.println("东京(东九区)时间: "+tokyoFormat.format(date));
            
            //时间戳转化成Date
            SimpleDateFormat timestampFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
            String fotmatString = timestampFormat.format(seconds);
            Date parseDate = timestampFormat.parse(fotmatString);
            System.out.println("时间戳转化成Date之后的时间: "+parseDate + ";格式化之后的: "+ fotmatString);
    	            
    	} catch (Exception e) {
    		e.printStackTrace();
    	}
    }
    }

输出结果如下：

![20190712104656834.png][]

Date的无参构造函数如下图：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI0NzU0MDYx_size_16_color_FFFFFF_t_70][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI0NzU0MDYx_size_16_color_FFFFFF_t_70 1][]

我们可以看到，Date中存放的是时间戳，因此，我们在世界各地调用这个方法，获取到的值都是一样的。只是在不同的地方，这个值会根据时区转化成当地的时间而已。

3.2  Java8 之后的时间处理：

从Java8开始，推出了LocalDate、LocalTime、LocalDateTime这三个工具类，实现了更好地时间处理，我们先看如何使用，然后，再进行比较。

1，工具类的获取与使用：

import java.time.Instant;
    import java.time.LocalDate;
    import java.time.LocalDateTime;
    import java.time.LocalTime;
    import java.time.ZoneOffset;
    import java.time.format.DateTimeFormatter;
    
    public class TestLocalTime {
    public static void main(String[] args) {
    	//获取当前时区的日期
    	LocalDate localDate = LocalDate.now();
    	System.out.println("localDate: " + localDate);
    	//时间
    	LocalTime localTime = LocalTime.now();
    	System.out.println("localTime: " + localTime);
    	//根据上面两个对象，获取日期时间
    	LocalDateTime localDateTime = LocalDateTime.of(localDate,localTime);
    	System.out.println("localDateTime: " + localDateTime);
    	//使用静态方法生成此对象
    	LocalDateTime localDateTime2 = LocalDateTime.now();
    	System.out.println("localDateTime2: " + localDateTime2);
    	//格式化时间
    	DateTimeFormatter formatter = DateTimeFormatter.ofPattern("YYYY-MM-dd HH:mm:ss");
    	System.out.println("格式化之后的时间: " + localDateTime2.format(formatter));
    	
    	//转化为时间戳(秒)
    	long epochSecond = localDateTime2.toEpochSecond(ZoneOffset.of("+8"));
    	//转化为毫秒
    	long epochMilli = localDateTime2.atZone(ZoneOffset.systemDefault()).toInstant().toEpochMilli();
    	System.out.println("时间戳为:(秒) " + epochSecond + "; (毫秒): " + epochMilli);
    	
    	//时间戳(毫秒)转化成LocalDateTime
    	Instant instant = Instant.ofEpochMilli(epochMilli);
    	LocalDateTime localDateTime3 = LocalDateTime.ofInstant(instant, ZoneOffset.systemDefault());
    	System.out.println("时间戳(毫秒)转化成LocalDateTime: " + localDateTime3.format(formatter));
    	//时间戳(秒)转化成LocalDateTime
    	Instant instant2 = Instant.ofEpochSecond(epochSecond);
    	LocalDateTime localDateTime4 = LocalDateTime.ofInstant(instant2, ZoneOffset.systemDefault());
    	System.out.println("时间戳(秒)转化成LocalDateTime: " + localDateTime4.format(formatter));
    }
    }

上述程序运行结果如下图所示：

![20190712125448156.png][]

新推出来的这三个类，与MySQL中的日期时间类型正好对应，如果我们使用MySQL数据库的话，在插入相应字段的时候，都不需要再进行任何的转化了。对应关系如下：

LocalTime  对应  time  
   LocalDate  对应  date  
   LocalDateTime  对应  datetime(timestamp)

2，增加、减去时间：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI0NzU0MDYx_size_16_color_FFFFFF_t_70 2][]

看看上图，是不是非常的简单方便呢。

3，LocalDateTime 与 Date 的相互转化

// Date 转化成 LocalDateTime
    public static LocalDateTime dateToLocalDate(Date date) {
    	Instant instant = date.toInstant();
    	ZoneId zoneId = ZoneId.systemDefault();
    	return instant.atZone(zoneId).toLocalDateTime();
    }

// LocalDateTime 转化成 Date
    public static Date localDateTimeToDate(LocalDateTime localDateTime) {
    	ZoneId zoneId = ZoneId.systemDefault();
    	ZonedDateTime zdt = localDateTime.atZone(zoneId);
    	return Date.from(zdt.toInstant());
    }

由于 LocalDate、LocalTime 或者只含有日期，或者只含有时间，因此，不能和Date直接进行转化。

四、总结：

了解好时区，时间戳等这几个概念，对于我们了解程序语言中时间类的构造非常有帮助。Java8 新推出来的这三个类，不仅让我们在日常编程中更为高效方便，而且，在与数据库时间类型的对应上更为友好。

最后总结：

1，时间戳： 是指格林威治（地球零时区）时间1970年01月01日00时00分00秒起至现在的总秒数，这个时间戳，在地球的各个地方都是一致的;

2，时区：由于地球的自转，根据接收太阳光照的顺序将地球划分成24个区，从而方便当地人的生产生活，每个时区相差一小时，可以根据时间戳和时区计算当地的时间。格林威治处于零时区，北京处于东八区，因此，北京时间比格林威治时间早8个小时。

3，LocalDateTime 比 Date使用起来更为方便，两者可以相互进行转化。

[Link 1]: https://www.meijindong.top/posts/2679351756.html
[20190712104656834.png]: /images/20211210/4c94ef9b48b346209302bdc1712d931f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI0NzU0MDYx_size_16_color_FFFFFF_t_70]: /images/20211210/2d89bac317324786b5a412588074cc7b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI0NzU0MDYx_size_16_color_FFFFFF_t_70 1]: /images/20211210/6a7096f0d4524ba1ad9aaf577159e233.png
[20190712125448156.png]: /images/20211210/f826d3dd2ca34399856e2ae17c769c49.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI0NzU0MDYx_size_16_color_FFFFFF_t_70 2]: /images/20211210/8f8dbf39012547eb836b217890d93e6e.png