Java时间转换,日期格式化使用 YYYY-MM-dd 的潜在问题

ゝ一纸荒年。 2023-01-11 01:14 21阅读 0赞

### 日期格式化使用 YYYY-MM-dd 的潜在问题 ###

*  测试逻辑：
    
    1.  创建两个日期格式化，一个是出问题的YYYY-MM-dd，另一个是正确用法yyyy-MM-dd
    2.  分别去格式化两个不同的日期：2020年12月26日（周六），2020年12月27日（周日）
 *  代码如下

@Test
        public void dateTest() { 
            // 指定了两个时间
    
            // 通过指定具体的 年月日时分秒 构建 一个 LocalDateTime 对象(无时区), 绑定 到 北京时区,转为 实例,构建Date 对象
            test(Date.from(LocalDateTime.of(2020,12,27,12,1,35).atZone(ZoneId.of("Asia/Shanghai")).toInstant()));
            test(Date.from(LocalDateTime.of(2020,12,26,12,1,35).atZone(ZoneId.of("Asia/Shanghai")).toInstant()));
    
        }
    
        private void test(Date date) { 
            String loY = "yyyy-MM-dd HH:mm:ss";
            String upY = "YYYY-MM-dd HH:mm:ss";
            SimpleDateFormat loF = new SimpleDateFormat(loY);
            SimpleDateFormat upF = new SimpleDateFormat(upY);
            System.out.println("小Y格式化:" + loF.format(date));
            System.out.println("大Y格式化:" + upF.format(date));
            System.out.println("===========================");
        }

*  代码运行结果

> 小Y格式化:2020-12-27 12:01:35  
> 大Y格式化:2021-12-27 12:01:35  
> ===========================  
> 小Y格式化:2020-12-26 12:01:35  
> 大Y格式化:2020-12-26 12:01:35  
> ===========================

*  结果分析  
    发现当日期为 2020-12-27 时,两个 SimpleDateFormat 对象的转换的出来年份不一样,原因时一个的样式使用的 年份的 标识不同 “YYYY” 和 “yyyy”  
    具体原因时,"Y"是表示周年，表示：当天所在的周属于的年份，一周从周日开始，周六结束，只要本周跨年，那么这周就算入下一年  
    **对于周年的具体解释**:
    
    > 参考:GregorianCalendar\#getWeekYear() 这个方法上的注释  
    > 返回此公历所代表的周年。从“1”到“最大周数”之间的周中的日期具有相同的“周年”值，可以是“年(日历年)”值的前一年，也可以是“年(日历年)”值的后一年。  
    > 此方法在计算周年之前调用
    
    就是说对于年份的区分,是把一年的天数,分成多少周(能整除的天数,就算这个周年表示的年份和当前的公历年份相同),后面多余不满一周当年的多余天数的就表示是下一个周年(就是当前公历年份的下一年)
 *  说明  
    这里为了举例方便使用了 SimpleDateFormat 类,但是该类是线程不安全得,已经不推荐使用,需要特别注意,建议使用 DateTimeFormatter 类进行时间格式化
 *  SimpleDateFormat 类上的注释中的一些说明

> <table> 
>  <tbody> 
>   <tr> 
>    <th align="left">Letter </th> 
>    <th align="left">Date or Time Component </th> 
>    <th align="left">Presentation </th> 
>    <th align="left">Examples </th> 
>   </tr> 
>   <tr> 
>    <td><code>G</code> </td> 
>    <td>Era designator </td> 
>    <td><a rel="nofollow">Text</a> </td> 
>    <td><code>AD</code> </td> 
>   </tr> 
>   <tr> 
>    <td><code>y</code> </td> 
>    <td>Year </td> 
>    <td><a rel="nofollow">Year</a> </td> 
>    <td><code>1996</code>; <code>96</code> </td> 
>   </tr> 
>   <tr> 
>    <td><code>Y</code> </td> 
>    <td>Week year </td> 
>    <td><a rel="nofollow">Year</a> </td> 
>    <td><code>2009</code>; <code>09</code> </td> 
>   </tr> 
>   <tr> 
>    <td><code>M</code> </td> 
>    <td>Month in year (context sensitive) </td> 
>    <td><a rel="nofollow">Month</a> </td> 
>    <td><code>July</code>; <code>Jul</code>; <code>07</code> </td> 
>   </tr> 
>   <tr> 
>    <td><code>L</code> </td> 
>    <td>Month in year (standalone form) </td> 
>    <td><a rel="nofollow">Month</a> </td> 
>    <td><code>July</code>; <code>Jul</code>; <code>07</code> </td> 
>   </tr> 
>   <tr> 
>    <td><code>w</code> </td> 
>    <td>Week in year </td> 
>    <td><a rel="nofollow">Number</a> </td> 
>    <td><code>27</code> </td> 
>   </tr> 
>   <tr> 
>    <td><code>W</code> </td> 
>    <td>Week in month </td> 
>    <td><a rel="nofollow">Number</a> </td> 
>    <td><code>2</code> </td> 
>   </tr> 
>   <tr> 
>    <td><code>D</code> </td> 
>    <td>Day in year </td> 
>    <td><a rel="nofollow">Number</a> </td> 
>    <td><code>189</code> </td> 
>   </tr> 
>   <tr> 
>    <td><code>d</code> </td> 
>    <td>Day in month </td> 
>    <td><a rel="nofollow">Number</a> </td> 
>    <td><code>10</code> </td> 
>   </tr> 
>   <tr> 
>    <td><code>F</code> </td> 
>    <td>Day of week in month </td> 
>    <td><a rel="nofollow">Number</a> </td> 
>    <td><code>2</code> </td> 
>   </tr> 
>   <tr> 
>    <td><code>E</code> </td> 
>    <td>Day name in week </td> 
>    <td><a rel="nofollow">Text</a> </td> 
>    <td><code>Tuesday</code>; <code>Tue</code> </td> 
>   </tr> 
>   <tr> 
>    <td><code>u</code> </td> 
>    <td>Day number of week (1 = Monday, ..., 7 = Sunday) </td> 
>    <td><a rel="nofollow">Number</a> </td> 
>    <td><code>1</code> </td> 
>   </tr> 
>   <tr> 
>    <td><code>a</code> </td> 
>    <td>Am/pm marker </td> 
>    <td><a rel="nofollow">Text</a> </td> 
>    <td><code>PM</code> </td> 
>   </tr> 
>   <tr> 
>    <td><code>H</code> </td> 
>    <td>Hour in day (0-23) </td> 
>    <td><a rel="nofollow">Number</a> </td> 
>    <td><code>0</code> </td> 
>   </tr> 
>   <tr> 
>    <td><code>k</code> </td> 
>    <td>Hour in day (1-24) </td> 
>    <td><a rel="nofollow">Number</a> </td> 
>    <td><code>24</code> </td> 
>   </tr> 
>   <tr> 
>    <td><code>K</code> </td> 
>    <td>Hour in am/pm (0-11) </td> 
>    <td><a rel="nofollow">Number</a> </td> 
>    <td><code>0</code> </td> 
>   </tr> 
>   <tr> 
>    <td><code>h</code> </td> 
>    <td>Hour in am/pm (1-12) </td> 
>    <td><a rel="nofollow">Number</a> </td> 
>    <td><code>12</code> </td> 
>   </tr> 
>   <tr> 
>    <td><code>m</code> </td> 
>    <td>Minute in hour </td> 
>    <td><a rel="nofollow">Number</a> </td> 
>    <td><code>30</code> </td> 
>   </tr> 
>   <tr> 
>    <td><code>s</code> </td> 
>    <td>Second in minute </td> 
>    <td><a rel="nofollow">Number</a> </td> 
>    <td><code>55</code> </td> 
>   </tr> 
>   <tr> 
>    <td><code>S</code> </td> 
>    <td>Millisecond </td> 
>    <td><a rel="nofollow">Number</a> </td> 
>    <td><code>978</code> </td> 
>   </tr> 
>   <tr> 
>    <td><code>z</code> </td> 
>    <td>Time zone </td> 
>    <td><a rel="nofollow">General time zone</a> </td> 
>    <td><code>Pacific Standard Time</code>; <code>PST</code>; <code>GMT-08:00</code> </td> 
>   </tr> 
>   <tr> 
>    <td><code>Z</code> </td> 
>    <td>Time zone </td> 
>    <td><a rel="nofollow">RFC 822 time zone</a> </td> 
>    <td><code>-0800</code> </td> 
>   </tr> 
>   <tr> 
>    <td><code>X</code> </td> 
>    <td>Time zone </td> 
>    <td><a rel="nofollow">ISO 8601 time zone</a> </td> 
>    <td><code>-08</code>; <code>-0800</code>; <code>-08:00</code> </td> 
>   </tr> 
>  </tbody> 
> </table>