Java日期处理易踩的十个坑

### 前言 整理了Java日期处理的十个坑，希望对大家有帮助。 ### 一、用Calendar设置时间的坑 **反例：** ``` Calendar c = Calendar.getInstance(); c.set(Calendar.HOUR, 10); System.out.println(c.getTime()); ``` **运行结果：** ``` Thu Mar 26 22:28:05 GMT+08:00 2020 ``` **解析：** 我们设置了10小时，但运行结果是22点，而不是10点。因为Calendar.HOUR默认是按12小时制处理的，需要使用Calendar.HOUR_OF_DAY，因为它才是按24小时处理的。 **正例：** ``` Calendar c = Calendar.getInstance(); c.set(Calendar.HOUR_OF_DAY, 10); ``` ### 二、Java日期格式化YYYY的坑 **反例：** ``` Calendar calendar = Calendar.getInstance(); calendar.set(2019, Calendar.DECEMBER, 31); Date testDate = calendar.getTime(); SimpleDateFormat dtf = new SimpleDateFormat("YYYY-MM-dd"); System.out.println("2019-12-31 转 YYYY-MM-dd 格式后 " + dtf.format(testDate)); ``` **运行结果：** ``` 2019-12-31 转 YYYY-MM-dd 格式后 2020-12-31 ``` **解析：** 为什么明明是2019年12月31号，就转了一下格式，就变成了2020年12月31号了？因为YYYY是基于周来计算年的，它指向当天所在周属于的年份，一周从周日开始算起，周六结束，只要本周跨年，那么这一周就算下一年的了。正确姿势是使用yyyy格式。  **正例：** ``` Calendar calendar = Calendar.getInstance(); calendar.set(2019, Calendar.DECEMBER, 31); Date testDate = calendar.getTime(); SimpleDateFormat dtf = new SimpleDateFormat("yyyy-MM-dd"); System.out.println("2019-12-31 转 yyyy-MM-dd 格式后 " + dtf.format(testDate)); ``` ### 三、Java日期格式化hh的坑。 **反例：** ``` String str = "2020-03-18 12:00"; SimpleDateFormat dtf = new SimpleDateFormat("yyyy-MM-dd hh:mm"); Date newDate = dtf.parse(str); System.out.println(newDate); ``` **运行结果：** ``` Wed Mar 18 00:00:00 GMT+08:00 2020 ``` **解析：** 设置的时间是12点，为什么运行结果是0点呢？因为hh是12制的日期格式，当时间为12点，会处理为0点。正确姿势是使用HH，它才是24小时制。 **正例：** ``` String str = "2020-03-18 12:00"; SimpleDateFormat dtf = new SimpleDateFormat("yyyy-MM-dd HH:mm"); Date newDate = dtf.parse(str); System.out.println(newDate); ``` ### 四、Calendar获取的月份比实际数字少1即(0-11) **反例：** ``` //获取当前月，当前是3月 Calendar calendar = Calendar.getInstance(); System.out.println("当前"+calendar.get(Calendar.MONTH)+"月份"); ``` **运行结果：** ``` 当前2月份 ``` **解析：** ``` The first month of the year in the Gregorian and Julian calendars is JANUARY which is 0; 也就是1月对应的是下标 0，依次类推。因此获取正确月份需要加 1. ``` **正例：** ``` //获取当前月，当前是3月 Calendar calendar = Calendar.getInstance(); System.out.println("当前"+(calendar.get(Calendar.MONTH)+1)+"月份"); ``` ### 五、Java日期格式化DD的坑 **反例：** ``` Calendar calendar = Calendar.getInstance(); calendar.set(2019, Calendar.DECEMBER, 31); Date testDate = calendar.getTime(); SimpleDateFormat dtf = new SimpleDateFormat("yyyy-MM-DD"); System.out.println("2019-12-31 转 yyyy-MM-DD 格式后 " + dtf.format(testDate)); ``` **运行结果：** ``` 2019-12-31 转 yyyy-MM-DD 格式后 2019-12-365 ``` **解析：** DD和dd表示的不一样，DD表示的是一年中的第几天，而dd表示的是一月中的第几天，所以应该用的是dd。 **正例：** ``` Calendar calendar = Calendar.getInstance(); calendar.set(2019, Calendar.DECEMBER, 31); Date testDate = calendar.getTime(); SimpleDateFormat dtf = new SimpleDateFormat("yyyy-MM-dd"); System.out.println("2019-12-31 转 yyyy-MM-dd 格式后 " + dtf.format(testDate)); ``` ### 六、SimleDateFormat的format初始化问题 **反例：** ``` SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd"); System.out.println(sdf.format(20200323)); ``` **运行结果：** ``` 1970-01-01 ``` **解析：** 用format格式化日期是，要输入的是一个Date类型的日期，而不是一个整型或者字符串。 **正例：** ``` Calendar calendar = Calendar.getInstance(); calendar.set(2020, Calendar.MARCH, 23); SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd"); System.out.println(sdf.format(calendar.getTime())); ``` ### 七、日期本地化问题 **反例：** ``` String dateStr = "Wed Mar 18 10:00:00 2020"; DateTimeFormatter formatter = DateTimeFormatter.ofPattern("EEE MMM dd HH:mm:ss yyyy"); LocalDateTime dateTime = LocalDateTime.parse(dateStr, formatter); System.out.println(dateTime); ``` **运行结果：** ``` Exception in thread "main" java.time.format.DateTimeParseException: Text 'Wed Mar 18 10:00:00 2020' could not be parsed at index 0 at java.time.format.DateTimeFormatter.parseResolved0(DateTimeFormatter.java:1949) at java.time.format.DateTimeFormatter.parse(DateTimeFormatter.java:1851) at java.time.LocalDateTime.parse(LocalDateTime.java:492) at com.example.demo.SynchronizedTest.main(SynchronizedTest.java:19) ``` **解析：** DateTimeFormatter 这个类默认进行本地化设置，如果默认是中文，解析英文字符串就会报异常。可以传入一个本地化参数（Locale.US）解决这个问题 **正例：** ``` String dateStr = "Wed Mar 18 10:00:00 2020"; DateTimeFormatter formatter = DateTimeFormatter.ofPattern("EEE MMM dd HH:mm:ss yyyy",Locale.US); LocalDateTime dateTime = LocalDateTime.parse(dateStr, formatter); System.out.println(dateTime); ``` ### 八、SimpleDateFormat 解析的时间精度问题 **反例：** ``` SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd"); String time = "2020-03"; System.out.println(sdf.parse(time)); ``` **运行结果：** ``` Exception in thread "main" java.text.ParseException: Unparseable date: "2020-03" at java.text.DateFormat.parse(DateFormat.java:366) at com.example.demo.SynchronizedTest.main(SynchronizedTest.java:19) ``` **解析：** SimpleDateFormat 可以解析长于/等于它定义的时间精度，但是不能解析小于它定义的时间精度。 **正例：** ``` SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM"); String time = "2020-03"; System.out.println(sdf.parse(time)); ``` ### 九、SimpleDateFormat 的线性安全问题 **反例：** ``` public class SimpleDateFormatTest { private static final SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); public static void main(String[] args) { ThreadPoolExecutor threadPoolExecutor = new ThreadPoolExecutor(10, 100, 1, TimeUnit.MINUTES, new LinkedBlockingQueue<>(1000)); while (true) { threadPoolExecutor.execute(() -> { String dateString = sdf.format(new Date()); try { Date parseDate = sdf.parse(dateString); String dateString2 = sdf.format(parseDate); System.out.println(dateString.equals(dateString2)); } catch (ParseException e) { e.printStackTrace(); } }); } } ``` **运行结果：** ``` Exception in thread "pool-1-thread-49" java.lang.NumberFormatException: For input string: "5151." at java.lang.NumberFormatException.forInputString(NumberFormatException.java:65) at java.lang.Long.parseLong(Long.java:589) at java.lang.Long.parseLong(Long.java:631) at java.text.DigitList.getLong(DigitList.java:195) at java.text.DecimalFormat.parse(DecimalFormat.java:2051) at java.text.SimpleDateFormat.subParse(SimpleDateFormat.java:2162) at java.text.SimpleDateFormat.parse(SimpleDateFormat.java:1514) at java.text.DateFormat.parse(DateFormat.java:364) at com.example.demo.SimpleDateFormatTest.lambda$main$0(SimpleDateFormatTest.java:19) at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149) at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624) at java.lang.Thread.run(Thread.java:748) Exception in thread "pool-1-thread-47" java.lang.NumberFormatException: For input string: "5151." at java.lang.NumberFormatException.forInputString(NumberFormatException.java:65) at java.lang.Long.parseLong(Long.java:589) at java.lang.Long.parseLong(Long.java:631) at java.text.DigitList.getLong(DigitList.java:195) at java.text.DecimalFormat.parse(DecimalFormat.java:2051) at java.text.SimpleDateFormat.subParse(SimpleDateFormat.java:2162) at java.text.SimpleDateFormat.parse(SimpleDateFormat.java:1514) at java.text.DateFormat.parse(DateFormat.java:364) at com.example.demo.SimpleDateFormatTest.lambda$main$0(SimpleDateFormatTest.java:19) at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149) at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624) at java.lang.Thread.run(Thread.java:748) ``` **解析：** 全局变量的SimpleDateFormat，在并发情况下，存在安全性问题。 - SimpleDateFormat继承了 DateFormat - DateFormat类中维护了一个全局的Calendar变量 - sdf.parse(dateStr)和sdf.format(date)，都是由Calendar引用来储存的。 - 如果SimpleDateFormat是static全局共享的，Calendar引用也会被共享。 - 又因为Calendar内部并没有线程安全机制，所以全局共享的SimpleDateFormat不是线性安全的。 **解决SimpleDateFormat线性不安全问题，有三种方式：** - 将SimpleDateFormat定义为局部变量 - 使用ThreadLocal。 - 方法加同步锁synchronized。 **正例：** ``` public class SimpleDateFormatTest { private static final String DATE_FORMAT = "yyyy-MM-dd HH:mm:ss"; private static ThreadLocal