使用 Ctrl+D 可将网站添加到书签
 
当前位置：码云笔记 > 后端开发 > 为什么现在连Date类都不建议使用了？
水冗水孚水冗水孚 后端开发

为什么现在连Date类都不建议使用了？

目录
文章目录隐藏
  1. 一、有什么问题吗 java.util.Date？
  2. 二、为啥要改？
  3. 三、怎么改？
  4. 四、总结

一、有什么问题吗 java.util.Date？

java.util.Date（Date从现在开始）是一个糟糕的类型，这解释了为什么它的大部分内容在 Java 1.1 中被弃用（但不幸的是仍在使用）。

设计缺陷包括：

  • 它的名称具有误导性：它并不代表一个日期，而是代表时间的一个瞬间。所以它应该被称为Instant——正如它的java.time等价物一样。
  • 它是非最终的：这鼓励了对继承的不良使用，例如java.sql.Date（这意味着代表一个日期，并且由于具有相同的短名称而也令人困惑）
  • 它是可变的：日期/时间类型是自然值，可以通过不可变类型有效地建模。可变的事实Date（例如通过setTime方法）意味着勤奋的开发人员最终会在各处创建防御性副本。
  • 它在许多地方（包括）隐式使用系统本地时区，toString()这让许多开发人员感到困惑。有关此内容的更多信息，请参阅“什么是即时”部分
  • 它的月份编号是从 0 开始的，是从 C 语言复制的。这导致了很多很多相差一的错误。
  • 它的年份编号是基于 1900 年的，也是从 C 语言复制的。当然，当 Java 出现时，我们已经意识到这不利于可读性？
  • 它的方法命名不明确：getDate()返回月份中的某一天，并getDay()返回星期几。给这些更具描述性的名字有多难？
  • 对于是否支持闰秒含糊其辞：“秒由 0 到 61 之间的整数表示；值 60 和 61 仅在闰秒时出现，即使如此，也仅在实际正确跟踪闰秒的 Java 实现中出现。” 我强烈怀疑大多数开发人员（包括我自己）都做了很多假设，认为 for 的范围getSeconds()实际上在 0-59 范围内（含）。
  • 它的宽容没有明显的理由：“在所有情况下，为这些目的而对方法给出的论据不必落在指定的范围内; 例如，日期可以指定为 1 月 32 日，并被解释为 2 月 1 日。” 多久有用一次？

关键原因如下：

为什么现在连 Date 类都不建议使用了？

二、为啥要改？

我们要改的原因很简单，我们的代码缺陷扫描规则认为这是一个必须修改的缺陷，否则不给发布，不改不行，服了。

代码缺陷扫描规则

解决思路：避免使用java.util.Date与java.sql.Date类和其提供的 API，考虑使用java.time.Instant类或java.time.LocalDateTime类及其提供的 API 替代。

三、怎么改？

只能说这种基础的类改起来牵一发动全身，需要从 DO 实体类看起，然后就是各种 Converter，最后是 DTO。由于我们还是微服务架构，业务服务依赖于基础服务的 API，所以必须要一起改否则就会报错。这里就不细说修改流程了，主要说一下我们在改造的时候遇到的一些问题。

1. 耐心比对数据库日期字段和 DO 的映射

（1）确定字段类型

首先你需要确定数据对象中的 Date 字段代表的是日期、时间还是时间戳。

  • 如果字段代表日期和时间，则可能需要使用 LocalDateTime。
  • 如果字段仅代表日期，则可能需要使用 LocalDate。
  • 如果字段仅代表时间，则可能需要使用 LocalTime。
  • 如果字段需要保存时间戳（带时区的），则可能需要使用 Instant 或 ZonedDateTime。

（2）更新数据对象类

更新数据对象类中的字段，把 Date 类型改为适当的 java.time 类型。

2. 将 DateUtil 中的方法改造

（1）替换原来的 new Date()和 Calendar.getInstance().getTime()

原来的方式:

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

使用 java.time 改造后:

// 使用 Instant 代表一个时间点，这与 Date 类似
Instant nowInstant = Instant.now();

// 如果需要用到具体的日期和时间（例如年、月、日、时、分、秒）
LocalDateTime nowLocalDateTime = LocalDateTime.now();

// 如果你需要和特定的时区交互，可以使用 ZonedDateTime
ZonedDateTime nowZonedDateTime = ZonedDateTime.now();

// 如果你需要转换回 java.util.Date，你可以这样做（假设你的代码其他部分还需要使用 Date）
Date nowFromDateInstant = Date.from(nowInstant);

// 如果需要与 java.sql.Timestamp 交互
java.sql.Timestamp nowFromInstant = java.sql.Timestamp.from(nowInstant);

一些注意点:

  1. Instant 表示的是一个时间点，它是时区无关的，相当于旧的 Date 类。它通常用于表示时间戳。
  2. LocalDateTime 表示没有时区信息的日期和时间，它不能直接转换为时间戳，除非你将其与时区结合使用（例如通过 ZonedDateTime）。
  3. ZonedDateTime 包含时区信息的日期和时间，它更类似于 Calendar，因为 Calendar 也包含时区信息。
  4. 当你需要将 java.time 对象转换回 java.util.Date 对象时，可以使用 Date.from(Instant) 方法。这在你的代码需要与旧的 API 或库交互时非常有用。

（2）一些基础的方法改造

  1. a. dateFormat
    原来的方式

    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);
}
  2. b. addSecond、addMinute、addHour、addDay、addMonth、addYear
    原来的方式

    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
    原来的方式

    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];
}

    d. getStartOfDay 和 getEndOfDay
    原来的方式

    public static Date getStartTimeOfDay(Date date) {
if (date == null) {
    return null;
} 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) {
    return null;
} 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) {
    return null;
} else {
    // 获取一天的开始时间，即 00:00
    return date.toLocalDate().atStartOfDay();
}
}

public static LocalDateTime getEndTimeOfDay(LocalDateTime date) {
if (date == null) {
    return null;
} else {
    // 获取一天的结束时间，即 23:59:59.999999999
    return date.toLocalDate().atTime(LocalTime.MAX);
}
}

    e. betweenStartAndEnd
    原来的方式

    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);
}

我这里就只列了一些，如果有缺失的可以自己补充，不会写的话直接问问 ChatGPT，它最会干这事了。最后把这些修改后的方法替换一下就行了。

四、总结

这个改造难度不高，但是复杂度非常高，一个地方没改好，轻则接口报错，重则启动失败，非常耗费精力，真不想改。

「点点赞赏，手留余香」

赞 0 赏

给作者打赏，鼓励TA抓紧创作！

微信微信 支付宝支付宝

还没有人赞赏，快来当第一个赞赏的人吧！

声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。
码云笔记 » 为什么现在连Date类都不建议使用了？

水冗水孚 普通

分享到：

相关推荐

发表回复