摘要: 原创出处: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 代码详解
泥瓦匠一一道来这个代码的实现。先看代码:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
|
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);
}
}
} |
工具类由 final TimeUtil类 及 其内部枚举类TimeFormat时间格式类 组成。
1/ TimeUtil 具有私有构造函数,表示被保护,无法被外部 new 出实例。
声明了默认的 DateTimeFormatter 时间格式:yyyy-MM-dd HH:mm:ss。其他则是提供了 获取当前时间 和 时间与String互转的方法。
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 代码互操作如下图:
五、小结
实战中的 JDK8 ,Show the code。 在用的项目,完善测试时候用起来才是关键。自然需要 JDK 环境支持,升级吧升级吧。
基于 JDK 8 time包的实践,这次只讲了 LocalDateTime 类,慢慢带来更多。
相关代码分享在 Github 主页
如以上文章或链接对你有帮助的话,别忘了在文章结尾处评论哈~ 你也可以点击页面右边“分享”悬浮按钮哦,让更多的人阅读这篇文章。