Date 類(lèi)已被廢棄了，強(qiáng)烈建議不要再使用 java.util.Date 了！

釣友寶 （微信小程序）：一款專門(mén)為 釣友 開(kāi)發(fā)的 免費(fèi)的 分享釣點(diǎn)地圖與實(shí)時(shí)天氣的軟件，地圖中標(biāo)記了所有野釣、釣場(chǎng)、公共水域等的精確位置，支持導(dǎo)航、 預(yù)測(cè)釣魚(yú)位置的魚(yú)情 等功能。

一、有什么問(wèn)題嗎java.util.Date？

java.util.Date（Date從現(xiàn)在開(kāi)始）是一個(gè)糟糕的類(lèi)型，這解釋了為什么它的大部分內(nèi)容在 Java 1.1 中被棄用（但不幸的是仍在使用）。

設(shè)計(jì)缺陷包括：

• 它的名稱具有誤導(dǎo)性： 它并不代表一個(gè)日期，而是代表時(shí)間的一個(gè)瞬間。所以它應(yīng)該被稱為Instant——正如它的java.time等價(jià)物一樣。

• 它是非最終的： 這鼓勵(lì)了對(duì)繼承的不良使用，例如java.sql.Date（這意味著代表一個(gè)日期，并且由于具有相同的短名稱而也令人困惑）

• 它是可變的： 日期/時(shí)間類(lèi)型是自然值，可以通過(guò)不可變類(lèi)型有效地建模。可變的事實(shí)Date（例如通過(guò)setTime方法）意味著勤奮的開(kāi)發(fā)人員最終會(huì)在各處創(chuàng)建防御性副本。

• 它在許多地方（包括）隱式使用系統(tǒng)本地時(shí)區(qū)，toString()這讓許多開(kāi)發(fā)人員感到困惑。有關(guān)此內(nèi)容的更多信息，請(qǐng)參閱“什么是即時(shí)”部分

• 它的月份編號(hào)是從 0 開(kāi)始的，是從 C 語(yǔ)言復(fù)制的。這導(dǎo)致了很多很多相差一的錯(cuò)誤。

• 它的年份編號(hào)是基于 1900 年的，也是從 C 語(yǔ)言復(fù)制的。當(dāng)然，當(dāng) Java 出現(xiàn)時(shí)，我們已經(jīng)意識(shí)到這不利于可讀性？

• 它的方法命名不明確： getDate()返回月份中的某一天，并getDay()返回星期幾。給這些更具描述性的名字有多難？

• 對(duì)于是否支持閏秒含糊其辭： “秒由 0 到 61 之間的整數(shù)表示；值 60 和 61 僅在閏秒時(shí)出現(xiàn)，即使如此，也僅在實(shí)際正確跟蹤閏秒的 Java 實(shí)現(xiàn)中出現(xiàn)。” 我強(qiáng)烈懷疑大多數(shù)開(kāi)發(fā)人員（包括我自己）都做了很多假設(shè)，認(rèn)為 for 的范圍getSeconds()實(shí)際上在 0-59 范圍內(nèi)（含）。

• 它的寬容沒(méi)有明顯的理由： “在所有情況下，為這些目的而對(duì)方法給出的論據(jù)不必落在指定的范圍內(nèi); 例如，日期可以指定為 1 月 32 日，并被解釋為 2 月 1 日。” 多久有用一次？

關(guān)鍵原因如下：

原文如下：為什么要避免使用Date類(lèi)？

“https://codeblog.jonskeet.uk/2017/04/23/all-about-java-util-date/

二、為啥要改？

我們要改的原因很簡(jiǎn)單，我們的代碼缺陷掃描規(guī)則認(rèn)為這是一個(gè)必須修改的缺陷，否則不給發(fā)布，不改不行，服了。

解決思路：避免使用java.util.Date與java.sql.Date類(lèi)和其提供的API，考慮使用java.time.Instant類(lèi)或java.time.LocalDateTime類(lèi)及其提供的API替代。

三、怎么改？

只能說(shuō)這種基礎(chǔ)的類(lèi)改起來(lái)牽一發(fā)動(dòng)全身，需要從DO實(shí)體類(lèi)看起，然后就是各種Converter，最后是DTO。

由于我們還是微服務(wù)架構(gòu)，業(yè)務(wù)服務(wù)依賴于基礎(chǔ)服務(wù)的API，所以必須要一起改否則就會(huì)報(bào)錯(cuò)。這里就不細(xì)說(shuō)修改流程了，主要說(shuō)一下我們?cè)诟脑斓臅r(shí)候遇到的一些問(wèn)題。

1. 耐心比對(duì)數(shù)據(jù)庫(kù)日期字段和DO的映射

1）確定字段類(lèi)型

首先你需要確定數(shù)據(jù)對(duì)象中的 Date 字段代表的是日期、時(shí)間還是時(shí)間戳。

如果字段代表日期和時(shí)間，則可能需要使用 LocalDateTime。

如果字段僅代表日期，則可能需要使用 LocalDate。

如果字段僅代表時(shí)間，則可能需要使用 LocalTime。

如果字段需要保存時(shí)間戳（帶時(shí)區(qū)的），則可能需要使用 Instant 或 ZonedDateTime。

2）更新數(shù)據(jù)對(duì)象類(lèi)

更新數(shù)據(jù)對(duì)象類(lèi)中的字段，把 Date 類(lèi)型改為適當(dāng)?shù)?java.time 類(lèi)型。

2. 將DateUtil中的方法改造

1）替換原來(lái)的new Date()和Calendar.getInstance().getTime()

原來(lái)的方式：

Date nowDate = new Date(); Date nowCalendarDate = Calendar.getInstance().getTime();

使用 java.time 改造后：

// 使用Instant代表一個(gè)時(shí)間點(diǎn)，這與Date類(lèi)似 Instant nowInstant = Instant.now(); // 如果需要用到具體的日期和時(shí)間（例如年、月、日、時(shí)、分、秒） LocalDateTime nowLocalDateTime = LocalDateTime.now(); // 如果你需要和特定的時(shí)區(qū)交互，可以使用ZonedDateTime ZonedDateTime nowZonedDateTime = ZonedDateTime.now(); // 如果你需要轉(zhuǎn)換回java.util.Date，你可以這樣做（假設(shè)你的代碼其他部分還需要使用Date） Date nowFromDateInstant = Date.from(nowInstant); // 如果需要與java.sql.Timestamp交互 java.sql.Timestamp nowFromInstant = java.sql.Timestamp.from(nowInstant);

一些注意點(diǎn):

Instant 表示的是一個(gè)時(shí)間點(diǎn)，它是時(shí)區(qū)無(wú)關(guān)的，相當(dāng)于舊的 Date 類(lèi)。它通常用于表示時(shí)間戳。

LocalDateTime 表示沒(méi)有時(shí)區(qū)信息的日期和時(shí)間，它不能直接轉(zhuǎn)換為時(shí)間戳，除非你將其與時(shí)區(qū)結(jié)合使用（例如通過(guò) ZonedDateTime）。

ZonedDateTime 包含時(shí)區(qū)信息的日期和時(shí)間，它更類(lèi)似于 Calendar，因?yàn)?Calendar 也包含時(shí)區(qū)信息。

當(dāng)你需要將 java.time 對(duì)象轉(zhuǎn)換回 java.util.Date 對(duì)象時(shí)，可以使用 Date.from(Instant) 方法。這在你的代碼需要與舊的API或庫(kù)交互時(shí)非常有用。

2）一些基礎(chǔ)的方法改造

a. dateFormat

原來(lái)的方式

public static String dateFormat(Date date, String dateFormat) {     SimpleDateFormat formatter = new SimpleDateFormat(dateFormat);     return formatter.format(date); }

使用java.time改造后

public static String dateFormat(LocalDateTime date, String dateFormat) {     DateTimeFormatter formatter = DateTimeFormatter.ofPattern(dateFormat);     return date.format(formatter); }

b. addSecond、addMinute、addHour、addDay、addMonth、addYear

原來(lái)的方式

public static Date addSecond(Date date, int second) {     Calendar calendar = Calendar.getInstance();     calendar.setTime(date);     calendar.add(13, second);     return calendar.getTime(); } public static Date addMinute(Date date, int minute) {     Calendar calendar = Calendar.getInstance();     calendar.setTime(date);     calendar.add(12, minute);     return calendar.getTime(); } public static Date addHour(Date date, int hour) {     Calendar calendar = Calendar.getInstance();     calendar.setTime(date);     calendar.add(10, hour);     return calendar.getTime(); } public static Date addDay(Date date, int day) {     Calendar calendar = Calendar.getInstance();     calendar.setTime(date);     calendar.add(5, day);     return calendar.getTime(); } public static Date addMonth(Date date, int month) {     Calendar calendar = Calendar.getInstance();     calendar.setTime(date);     calendar.add(2, month);     return calendar.getTime(); } public static Date addYear(Date date, int year) {     Calendar calendar = Calendar.getInstance();     calendar.setTime(date);     calendar.add(1, year);     return calendar.getTime(); }

使用java.time改造后

public static LocalDateTime addSecond(LocalDateTime date, int second) {     return date.plusSeconds(second); } public static LocalDateTime addMinute(LocalDateTime date, int minute) {     return date.plusMinutes(minute); } public static LocalDateTime addHour(LocalDateTime date, int hour) {     return date.plusHours(hour); } public static LocalDateTime addDay(LocalDateTime date, int day) {     return date.plusDays(day); } public static LocalDateTime addMonth(LocalDateTime date, int month) {     return date.plusMonths(month); } public static LocalDateTime addYear(LocalDateTime date, int year) {     return date.plusYears(year); }

c. dateToWeek

原來(lái)的方式

public static final String[] WEEK_DAY_OF_CHINESE = new String[]{"周日", "周一", "周二", "周三", "周四", "周五", "周六"}; public static String dateToWeek(Date date) {     Calendar cal = Calendar.getInstance();     cal.setTime(date);     return WEEK_DAY_OF_CHINESE[cal.get(7) - 1]; }

使用java.time改造后

public static final String[] WEEK_DAY_OF_CHINESE = new String[]{"周日", "周一", "周二", "周三", "周四", "周五", "周六"}; public static String dateToWeek(LocalDate date) {     DayOfWeek dayOfWeek = date.getDayOfWeek();     return WEEK_DAY_OF_CHINESE[dayOfWeek.getValue() % 7]; }

原來(lái)的方式

public static Date getStartTimeOfDay(Date date) {     if (date == null) {         returnnull;     } else {         LocalDateTime localDateTime = LocalDateTime.ofInstant(Instant.ofEpochMilli(date.getTime()), ZoneId.systemDefault());         LocalDateTime startOfDay = localDateTime.with(LocalTime.MIN);         return Date.from(startOfDay.atZone(ZoneId.systemDefault()).toInstant());     } } public static Date getEndTimeOfDay(Date date) {     if (date == null) {         returnnull;     } else {         LocalDateTime localDateTime = LocalDateTime.ofInstant(Instant.ofEpochMilli(date.getTime()), ZoneId.systemDefault());         LocalDateTime endOfDay = localDateTime.with(LocalTime.MAX);         return Date.from(endOfDay.atZone(ZoneId.systemDefault()).toInstant());     } }

使用java.time改造后

public static LocalDateTime getStartTimeOfDay(LocalDateTime date) {     if (date == null) {         returnnull;     } else {         // 獲取一天的開(kāi)始時(shí)間，即00:00         return date.toLocalDate().atStartOfDay();     } } public static LocalDateTime getEndTimeOfDay(LocalDateTime date) {     if (date == null) {         returnnull;     } else {         // 獲取一天的結(jié)束時(shí)間，即23:59:59.999999999         return date.toLocalDate().atTime(LocalTime.MAX);     } }

e. betweenStartAndEnd

原來(lái)的方式

public static Boolean betweenStartAndEnd(Date nowTime, Date beginTime, Date endTime) {     Calendar date = Calendar.getInstance();     date.setTime(nowTime);     Calendar begin = Calendar.getInstance();     begin.setTime(beginTime);     Calendar end = Calendar.getInstance();     end.setTime(endTime);     return date.after(begin) && date.before(end); }

使用java.time改造后

public static Boolean betweenStartAndEnd(Instant nowTime, Instant beginTime, Instant endTime) {     return nowTime.isAfter(beginTime) && nowTime.isBefore(endTime); }

我這里就只列了一些，如果有缺失的可以自己補(bǔ)充，不會(huì)寫(xiě)的話直接問(wèn)問(wèn)ChatGPT，它最會(huì)干這事了。最后把這些修改后的方法替換一下就行了。

四、小結(jié)一下

這個(gè)改造難度不高，但是復(fù)雜度非常高，一個(gè)地方?jīng)]改好，輕則接口報(bào)錯(cuò)，重則啟動(dòng)失敗，非常耗費(fèi)精力，真不想改。

JDK8以上版本建議直接使用LocalDate和LocalDateTime。

Java精選面試題 （微信小程序）：5000+道面試題和選擇題，包含Java基礎(chǔ)、MQ、Redis、SpringBoot、Elasticsearch、Docker、K8s、Flink、Spark、架構(gòu)設(shè)計(jì)、大廠真題等，在線隨時(shí)刷題！

來(lái)源：https://www.cnblogs.com/wlovet/p/18058514

公眾號(hào)“Java精選”所發(fā)表內(nèi)容注明來(lái)源的，版權(quán)歸原出處所有（無(wú)法查證版權(quán)的或者未注明出處的均來(lái)自網(wǎng)絡(luò)，系轉(zhuǎn)載，轉(zhuǎn)載的目的在于傳遞更多信息，版權(quán)屬于原作者。如有侵權(quán)，請(qǐng)聯(lián)系，筆者會(huì)第一時(shí)間刪除處理！

最近有很多人問(wèn)，有沒(méi)有讀者或者摸魚(yú)交流群！加入方式很簡(jiǎn)單，公眾號(hào)Java精選，回復(fù)“加群”，即可入群！

文章有幫助的話，點(diǎn)在看，轉(zhuǎn)發(fā)吧！