代码片段:基于 JDK 8 time包的时间工具类 TimeUtil

摘要: 原创出处:www.bysocket.com 泥瓦匠BYSocket 希望转载,保留摘要,谢谢!

“知识的工作者必须成为自己时间的首席执行官。”

前言

这次泥瓦匠带来的是一个好玩的基于 JDK 8 time包的时间工具类 TimeUtil。本意,用 JDK 8 写个实战的时间工具类,初版泥瓦匠写的很不好,后来雨神分分钟将这个代码优化优化,谢谢雨神。就此分享下这个代码,让更多的人看到~

一、 Java 8 time包

从 Java 1.0 有个 Date 类,想必大家不陌生,后面有了 Calendar 类(被废弃 )。API 确实比较难用,因此 Java 8 引入 java.time API,这次看看是不是很好用。大致引入了这几个对象:

  • Instant – 瞬间类,表示时间线上的一点(与 Date 类似)
  • Duration – 持续时间,表示两个 Instant 之间的时间
  • LocalDateTime – 本地日期时间,表示一个日期和时间。

本小文重点还是在使用 LocalDateTime 及其格式化类 DateTimeFormatter

二、介绍 LocalDateTime & DateTimeFormatter APIs

LocalDateTime 表示一个日期和时间,存储确定时区中的某个时间点。
例如某一次练书法弹琴活动。(ps:泥瓦匠有个小圈子,里面喜欢加入一些文艺的程序员。爱技术,爱生活,爱艺术~ 雨神就爱弹琴,日语思密达*&#@#% )

常用api:

  • now()
    从系统中获取当前时间
  • parse(CharSequence text, DateTimeFormatter formatter)
    从字符串按格式获取 LocalDateTime 实例

DateTimeFormatter 用于格式化时间,提供了公用的方法入口,打印和解析格式化的时间类。

常用api:

  • format(TemporalAccessor temporal)
    按格式格式化时间
  • ofPattern(String pattern)
    按字符串指定的格式,生成时间格式

 

三、TimeUtil 代码详解

泥瓦匠一一道来这个代码的实现。先看代码:

import java.time.LocalDateTime;

import java.time.format.DateTimeFormatter;



/**

 * 基于 JDK 8 time包的时间工具类

 * <p/>

 * Created by bysocket on 16/8/23.

 */

public final class TimeUtil {



    /**

     * 获取默认时间格式: yyyy-MM-dd HH:mm:ss

     */

    private static final DateTimeFormatter DEFAULT_DATETIME_FORMATTER = TimeFormat.LONG_DATE_PATTERN_LINE.formatter;



    private TimeUtil() {

        // no construct function

    }



    /**

     * String 转时间

     *

     * @param timeStr

     * @return

     */

    public static LocalDateTime parseTime(String timeStr) {

        return LocalDateTime.parse(timeStr, DEFAULT_DATETIME_FORMATTER);

    }



    /**

     * String 转时间

     *

     * @param timeStr

     * @param format  时间格式

     * @return

     */

    public static LocalDateTime parseTime(String timeStr, TimeFormat format) {

        return LocalDateTime.parse(timeStr, format.formatter);

    }



    /**

     * 时间转 String

     *

     * @param time

     * @return

     */

    public static String parseTime(LocalDateTime time) {

        return DEFAULT_DATETIME_FORMATTER.format(time);

    }



    /**

     * 时间转 String

     *

     * @param time

     * @param format 时间格式

     * @return

     */

    public static String parseTime(LocalDateTime time, TimeFormat format) {

        return format.formatter.format(time);

    }



    /**

     * 获取当前时间

     *

     * @return

     */

    public static String getCurrentDatetime() {

        return DEFAULT_DATETIME_FORMATTER.format(LocalDateTime.now());

    }



    /**

     * 获取当前时间

     *

     * @param format 时间格式

     * @return

     */

    public static String getCurrentDatetime(TimeFormat format) {

        return format.formatter.format(LocalDateTime.now());

    }



    /**

     * 时间格式

     */

    public enum TimeFormat {



        /**

         * 短时间格式

         */

        SHORT_DATE_PATTERN_LINE("yyyy-MM-dd"),

        SHORT_DATE_PATTERN_SLASH("yyyy/MM/dd"),

        SHORT_DATE_PATTERN_DOUBLE_SLASH("yyyy\\MM\\dd"),

        SHORT_DATE_PATTERN_NONE("yyyyMMdd"),



        /**

         * 长时间格式

         */

        LONG_DATE_PATTERN_LINE("yyyy-MM-dd HH:mm:ss"),

        LONG_DATE_PATTERN_SLASH("yyyy/MM/dd HH:mm:ss"),

        LONG_DATE_PATTERN_DOUBLE_SLASH("yyyy\\MM\\dd HH:mm:ss"),

        LONG_DATE_PATTERN_NONE("yyyyMMdd HH:mm:ss"),



        /**

         * 长时间格式 带毫秒

         */

        LONG_DATE_PATTERN_WITH_MILSEC_LINE("yyyy-MM-dd HH:mm:ss.SSS"),

        LONG_DATE_PATTERN_WITH_MILSEC_SLASH("yyyy/MM/dd HH:mm:ss.SSS"),

        LONG_DATE_PATTERN_WITH_MILSEC_DOUBLE_SLASH("yyyy\\MM\\dd HH:mm:ss.SSS"),

        LONG_DATE_PATTERN_WITH_MILSEC_NONE("yyyyMMdd HH:mm:ss.SSS");



        private transient DateTimeFormatter formatter;



        TimeFormat(String pattern) {

            formatter = DateTimeFormatter.ofPattern(pattern);

        }

    }

}


声明了默认的  DateTimeFormatter 时间格式:yyyy-MM-dd HH:mm:ss。其他则是提供了 获取当前时间 和 时间与String互转的方法。工具类由 final TimeUtil类 及 其内部枚举类TimeFormat时间格式类 组成。
1/ TimeUtil 具有私有构造函数,表示被保护,无法被外部 new 出实例。

2/ TimeFormat 内部枚举类,首先它是单例的。

transient 关键字目的是确保 DateTimeFormatter 无序列化存储。为啥单例,因为 DateTimeFormmatter 是无状态的,可以线程共享。

具体方法解析如下:
1. 获取当前时间

1

2

3

4

String now = TimeUtil.getCurrentDatetime();

System.out.println(now);

output:

2016-08-28 16:35:23

2. 获取当前相应格式的当前时间

1

2

3

4

String now = TimeUtil.getCurrentDatetime(TimeUtil.TimeFormat.LONG_DATE_PATTERN_SLASH);

System.out.println(now);

output:

2016/08/28 16:36:24

3. String 转时间
默认格式:yyyy-MM-dd HH:mm:ss

1

2

3

LocalDateTime expectedDateTime = LocalDateTime.of(2014, 11, 11, 10, 11, 11);

LocalDateTime parsedTime = TimeUtil.parseTime("2014-11-11 10:11:11");

assertEquals(expectedDateTime, parsedTime);

其他格式之一:yyyy-MM-dd HH:mm:ss

1

2

3

LocalDateTime expectedDateTime = LocalDateTime.of(2014, 11, 11, 10, 11, 11);

LocalDateTime parsedTime = TimeUtil.parseTime("2014/11/11 10:11:11", LONG_DATE_PATTERN_SLASH);

assertEquals(expectedDateTime, parsedTime);

4. 时间转 String
默认格式:yyyy-MM-dd HH:mm:ss

1

2

LocalDateTime time = LocalDateTime.of(2014, 11, 11, 10, 11, 11);

assertEquals(TimeUtil.parseTime(time), "2014-11-11 10:11:11");

其他格式之一:yyyy-MM-dd HH:mm:ss

1

2

LocalDateTime time = LocalDateTime.of(2014, 11, 11, 10, 11, 11);

assertEquals(TimeUtil.parseTime(time, LONG_DATE_PATTERN_DOUBLE_SLASH), "2014\\11\\11 10:11:11");

 

四、与 Old 代码互操作

java.time 类与 Old Date 代码互操作如下图:

time

 

五、小结

实战中的 JDK8 ,Show the code。 在用的项目,完善测试时候用起来才是关键。自然需要 JDK 环境支持,升级吧升级吧。
基于 JDK 8 time包的实践,这次只讲了 LocalDateTime 类,慢慢带来更多。
相关代码分享在 Github 主页

如以上文章或链接对你有帮助的话,别忘了在文章结尾处评论哈~ 你也可以点击页面右边“分享”悬浮按钮哦,让更多的人阅读这篇文章。

转载于:https://my.oschina.net/jeffli1993/blog/739112

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值