看山聊 Java:检查日期字符串是否合法
该图片由Анастасия Белоусова在Pixabay上发布
你好,我是看山。
这次说一下,怎样检查给出的字符串,是否是合法日期字符串。本文将从 Java 原生和第三方组件两种方式来说明。
WHY
后端接口在接收数据的时候,都需要进行检查。检查全部通过后,才能够执行业务逻辑。对于时间格式,我们一般需要检查这么几方面:
- 字符串格式是否正确,比如格式是不是
yyyy-MM-dd
- 时间在合法范围内,比如我们需要限定在一个月内的时间
- 字符串可以解析为正常的时间,比如 2 月 30 号就不是正常时间
对于时间格式的判断,我们可以通过正则表达式来检查。不过考虑到正则表达式的性能、输入数据的复杂性,一般能用别的方式,就不选正则表达式。我们还是选择一种更加通用、更加高效的检查方式。
首先,定义时间校验器的接口:
public interface DateValidator {boolean isValid(String dateStr);
}
接口方法接收一个字符串,返回布尔类型,表示字符串是否是合法的时间格式。
HOW
接下来就是通过不同方式实现DateValidator
。
使用 DateFormat 检查
Java 提供了格式化和解析时间的工具:DateFormat
抽象类和SimpleDataFormat
实现类。我们借此实现时间校验器:
public class DateValidatorUsingDateFormat implements DateValidator {private final String dateFormat;public DateValidatorUsingDateFormat(String dateFormat) {this.dateFormat = dateFormat;}@Overridepublic boolean isValid(String dateStr) {final DateFormat sdf = new SimpleDateFormat(this.dateFormat);sdf.setLenient(false);try {sdf.parse(dateStr);} catch (ParseException e) {return false;}return true;}
}
这里需要注意一下,DateFormat
和SimpleDataFormat
是非线程安全的,所以每次方法调用时,都需要新建实例。
我们通过单元测试验证下:
class DateValidatorUsingDateFormatTest {@Testvoid isValid() {final DateValidator validator = new DateValidatorUsingDateFormat("yyyy-MM-dd");Assertions.assertTrue(validator.isValid("2021-02-28"));Assertions.assertFalse(validator.isValid("2021-02-30"));}
}
在 Java8 之前,一般都是用这种方式来验证。Java8 之后,我们有了更多的选择。
使用 LocalDate 检查
Java8 引入了更加好用日期和时间 API(想要了解更多内容,请移步参看 Java8 中的时间类及常用 API)。其中包括LocalDate
类,是一个不可变且线程安全的时间类。
LocalDate
提供了两个静态方法,用来解析时间。这两个方法内部都是使用java.time.format.DateTimeFormatter
来处理数据:
// 使用 DateTimeFormatter.ISO_LOCAL_DATE 处理数据
public static LocalDate parse(CharSequence text) {return parse(text, DateTimeFormatter.ISO_LOCAL_DATE);
}// 使用提供的 DateTimeFormatter 处理数据
public static LocalDate parse(CharSequence text, DateTimeFormatter formatter) {Objects.requireNonNull(formatter, "formatter");return formatter.parse(text, LocalDate::from);
}
通过LocalDate
的parse
方法实现我们的校验器:
public class DateValidatorUsingLocalDate implements DateValidator {private final DateTimeFormatter dateFormatter;public DateValidatorUsingLocalDate(DateTimeFormatter dateFormatter) {this.dateFormatter = dateFormatter;}@Overridepublic boolean isValid(String dateStr) {try {LocalDate.parse(dateStr, this.dateFormatter);} catch (DateTimeParseException e) {return false;}return true;}
}
java.time.format.DateTimeFormatter
类是不可变的,也就是天然的线程安全,我们可以在不同线程使用同一个校验器实例。
我们通过单元测试验证下:
class DateValidatorUsingLocalDateTest {@Testvoid isValid() {final DateTimeFormatter dateFormatter = DateTimeFormatter.ISO_LOCAL_DATE;final DateValidator validator = new DateValidatorUsingLocalDate(dateFormatter);Assertions.assertTrue(validator.isValid("2021-02-28"));Assertions.assertFalse(validator.isValid("2021-02-30"));}
}
既然LocalDate#parse
是通过DateTimeFormatter
实现的,那我们也可以直接使用DateTimeFormatter
。
使用 DateTimeFormatter 检查
DateTimeFormatter
解析文本总共分两步。第一步,根据配置将文本解析为日期和时间字段;第二步,用解析后的字段创建日期和时间对象。
实现验证器:
public class DateValidatorUsingDateTimeFormatter implements DateValidator {private final DateTimeFormatter dateFormatter;public DateValidatorUsingDateTimeFormatter(DateTimeFormatter dateFormatter) {this.dateFormatter = dateFormatter;}@Overridepublic boolean isValid(String dateStr) {try {this.dateFormatter.parse(dateStr);} catch (DateTimeParseException e) {return false;}return true;}
}
通过单元测试验证:
class DateValidatorUsingDateTimeFormatterTest {private static final DateTimeFormatter DATE_FORMATTER = DateTimeFormatter.ofPattern("uuuu-MM-dd", Locale.CHINA);@Testvoid isValid() {final DateTimeFormatter dateFormatter = DATE_FORMATTER.withResolverStyle(ResolverStyle.STRICT);final DateValidator validator = new DateValidatorUsingDateTimeFormatter(dateFormatter);Assertions.assertTrue(validator.isValid("2021-02-28"));Assertions.assertFalse(validator.isValid("2021-02-30"));}
}
可以看到,我们指定了转换模式是ResolverStyle.STRICT
,这个类型是说明解析模式。共有三种:
- STRICT:严格模式,日期、时间必须完全正确。
- SMART:智能模式,针对日可以自动调整。月的范围在 1 到 12,日的范围在 1 到 31。比如输入是 2 月 30 号,当年 2 月只有 28 天,返回的日期就是 2 月 28 日。
- LENIENT:宽松模式,主要针对月和日,会自动后延。结果类似于
LocalData#plusDays
或者LocalDate#plusMonths
。
我们通过例子看下区别:
class DateValidatorUsingDateTimeFormatterTest {private static final DateTimeFormatter DATE_FORMATTER = DateTimeFormatter.ofPattern("uuuu-MM-dd", Locale.CHINA);@Testvoid testResolverStyle() {Assertions.assertEquals(LocalDate.of(2021, 2,28), parseDate("2021-02-28", ResolverStyle.STRICT));Assertions.assertNull(parseDate("2021-02-29", ResolverStyle.STRICT));Assertions.assertEquals(LocalDate.of(2021, 2,28), parseDate("2021-02-28", ResolverStyle.STRICT));Assertions.assertNull(parseDate("2021-13-28", ResolverStyle.STRICT));Assertions.assertEquals(LocalDate.of(2021, 2,28), parseDate("2021-02-28", ResolverStyle.SMART));Assertions.assertEquals(LocalDate.of(2021, 2,28), parseDate("2021-02-29", ResolverStyle.SMART));Assertions.assertNull(parseDate("2021-13-28", ResolverStyle.SMART));Assertions.assertNull(parseDate("2021-13-29", ResolverStyle.SMART));Assertions.assertEquals(LocalDate.of(2021, 2,28), parseDate("2021-02-28", ResolverStyle.LENIENT));Assertions.assertEquals(LocalDate.of(2021, 3,1), parseDate("2021-02-29", ResolverStyle.LENIENT));Assertions.assertEquals(LocalDate.of(2022, 1,28), parseDate("2021-13-28", ResolverStyle.LENIENT));Assertions.assertEquals(LocalDate.of(2022, 2,2), parseDate("2021-13-33", ResolverStyle.LENIENT));}private static LocalDate parseDate(String dateString, ResolverStyle resolverStyle) {try {return LocalDate.parse(dateString, DATE_FORMATTER.withResolverStyle(resolverStyle));} catch (DateTimeParseException e) {return null;}}
}
从例子可以看出,ResolverStyle.STRICT
是严格控制,用来做时间校验比较合适;ResolverStyle.LENIENT
可以最大程度将字符串转化为时间对象,在合理范围内可以随便玩;ResolverStyle.SMART
名为智能,但智力有限,两不沾边,优势不够明显。JDK 提供的DateTimeFormatter
实现,都是ResolverStyle.STRICT
模式。
说了 JDK 自带的实现,接下来说说第三方组件的实现方式。
使用 Apache 出品的 commons-validator 检查
Apache Commons 项目提供了一个校验器框架,包含多种校验规则,包括日期、时间、数字、货币、IP 地址、邮箱、URL 地址等。本文主要说检查时间,所以重点看看GenericValidator
类提供的isDate
方法:
public class GenericValidator implements Serializable {// 其他方法public static boolean isDate(String value, Locale locale) {return DateValidator.getInstance().isValid(value, locale);}public static boolean isDate(String value, String datePattern, boolean strict) {return org.apache.commons.validator.DateValidator.getInstance().isValid(value, datePattern, strict);}
}
先引入依赖:
<dependency><groupId>commons-validator</groupId><artifactId>commons-validator</artifactId><version>1.7</version>
</dependency>
实现验证器:
public class DateValidatorUsingCommonsValidator implements DateValidator {private final String dateFormat;public DateValidatorUsingCommonsValidator(String dateFormat) {this.dateFormat = dateFormat;}@Overridepublic boolean isValid(String dateStr) {return GenericValidator.isDate(dateStr, dateFormat, true);}
}
通过单元测试验证:
class DateValidatorUsingCommonsValidatorTest {@Testvoid isValid() {final DateValidator dateValidator = new DateValidatorUsingCommonsValidator("yyyy-MM-dd");Assertions.assertTrue(dateValidator.isValid("2021-02-28"));Assertions.assertFalse(dateValidator.isValid("2021-02-30"));}
}
看org.apache.commons.validator.DateValidator#isValid
源码可以发现,内部是通过DateFormat
和SimpleDateFormat
实现的。
文末总结
在本文中,我们通过四种方式实现了时间字符串校验逻辑。为了节省篇幅,文中代码只提供了核心内容。想要了解具体实现,可以关注公号「看山的小屋」,回复“date”获取源码。
推荐阅读
- Java8 中的时间类及常用 API
- Date 与 LocalDate 或 LocalDateTime 互相转换
- 使用 Java8 中的时间类
- 检查日期字符串是否合法
你好,我是看山,公众号:看山的小屋,10 年老猿,开源贡献者。游于码界,戏享人生。
个人主页:https://www.howardliu.cn
个人博文:看山聊 Java:检查日期字符串是否合法
CSDN 主页:https://kanshan.blog.csdn.net/
CSDN 博文:看山聊 Java:检查日期字符串是否合法
看山聊 Java:检查日期字符串是否合法相关推荐
- 看山聊并发:如果非要在多线程中使用 ArrayList 会发生什么?(第二篇)
你好,我是看山. 前面写过一篇文章 <如果非要在多线程中使用 ArrayList 会发生什么?>,有读者反馈,Java 11 代码已经修复,还会出现 null 元素. 为了便于理解,当时只 ...
- 与Brian Goetz聊Java的数据类
\ 看新闻很累?看技术新闻更累?试试下载InfoQ手机客户端,每天上下班路上听新闻,有趣还有料! \ \\ 作为Oracle的Java语言架构师,Brian Goetz一直致力于Java编程语言在生产 ...
- Java继承_Hachi君浅聊Java三大特性之 封装 继承 多态
Hello,大家好~我是你们的Hachi君,一个来自某学院的资深java小白.最近利用暑假的时间,修得满腔java语言学习心得.今天小宇宙终于要爆发了,决定在知乎上来一场根本停不下来的Hachi君个人 ...
- java解析字符串_用Java解析字符串有哪些不同的方法?
用Java解析字符串有哪些不同的方法? 对于解析播放器命令,我最常使用split方法通过定界符对字符串进行分割,然后再通过一系列ifs或switches找出其余部分. Java中解析字符串的几种不同方 ...
- 如何比较 Java 的字符串
在逛 Stack Overflow 的时候,发现了一些访问量像喜马拉雅山一样高的问题,比如说这个:如何比较 Java 的字符串?访问量足足有 370万+,这不得了啊!说明有很多很多的程序员被这个问题困 ...
- 使用javap分析Java的字符串操作
我们看这样一行简单的字符串赋值操作的Java代码. String a = "i042416"; 使用命令行将包含了这行代码的Java类反编译查看其字节码: javap -v con ...
- java 如何跟多个字符串比较_Stack Overflow上370万浏览量的一个问题:如何比较Java的字符串...
在逛 Stack Overflow 的时候,发现了一些访问量像喜马拉雅山一样高的问题,比如说这个:如何比较 Java 的字符串?访问量足足有 370万+,这不得了啊!说明有很多很多的程序员被这个问题困 ...
- java追加字符串到文件_java 将字符串追加到文件已有内容后面的操作
我就废话不多说了,大家还是直接看代码吧~ /** * 将字符串追加到文件已有内容后面 * * @param fileFullPath 文件完整地址:D:/test.txt * @param conte ...
- c++中string插入一个字符_Java内存管理-探索Java中字符串String(十二)
做一个积极的人 编码.改bug.提升自己 我有一个乐园,面向编程,春暖花开! 一.初识String类 首先JDK API的介绍: public final class String extends O ...
- Java中字符串的学习(一)String类的概述及常见方法使用
转载请注明出处http://www.cnblogs.com/devtrees/p/4347079.html (拓展:Api:编程语言对外给我们提供的应用程序接口.) 一.概述: 我们平时上网发帖,帖子 ...
最新文章
- 数据结构排序、查找算法
- Servlet中如何获取param-name对应的值?
- 【小白学PyTorch】扩展之Tensorflow2.0 | 21 Keras的API详解(下)池化、Normalization
- 函数进阶_月隐学python第11课
- mscoco数据集_重磅!小目标检测的数据增广秘籍
- db2 空值转换函数_Excel一键转换百分比
- 小米投资偏爱智能与芯片 雷军:有3家科创板上市
- Python 爬虫proxy
- poj2240 Floyd
- 转载:Visio2013的密钥
- 淘宝账号如何快速提升到更高等级
- github 从0开始的基本操作到fork和pr项目
- latex 中的长度单位,尺寸
- 英语单词之说文解字(7)
- UFS系列九:UFS数据安全
- 【运维面试】面试官:你觉得网站访问慢的原因有哪些?
- matlab中asc格式,matlab将图片转换成asc码txt文本格式 | 学步园
- 秀出新天际的SpringBoot笔记,让开发像搭积木一样简单
- 新浪天气预报代码及城市代码
- 移除挖矿程序过程记录