深入探讨Calendar类中的时间设置误区

Calendar.HOUR与Calendar.HOUR_OF_DAY的区别

在开发过程中，我们经常需要处理日期和时间，Java的Calendar类是一个强大的工具。然而，如果对其内部机制不够了解，很容易陷入一些常见的陷阱。本文将重点讨论一个关于如何正确设置一天中特定时间的问题。

假设我们需要确定一个时间段（该时间段不会跨越两天）是否属于当前日，这通常涉及到获取当天的起始时间和结束时间。错误的做法如下所示：

Calendar todayStart = Calendar.getInstance();
todayStart.set(Calendar.HOUR, 0); // 错误
...省略其他设置...
Long todayStart = todayStart.getTimeInMillis();

以及结束时间的设置：

Calendar todayEnd = Calendar.getInstance();
todayEnd.set(Calendar.HOUR, 23); // 错误
...省略其他设置...
Long todayEnd = todayEnd.getTimeInMillis();

通过这种方式，在0点至12点之间获取的时间戳看起来没有问题。然而，当时间进入12点后，使用相同的代码逻辑获取的时间戳则会显示出异常，具体表现为从当天12点开始计算直到次日12点。这意味着，如果在上午进行测试，可能不会发现这个问题，但是一旦应用上线并在下午使用，就会暴露出数据异常的情况。

为了理解为什么会发生这种情况，我们需要查看Calendar类中HOUR和HOUR_OF_DAY字段的定义：

public final static int HOUR = 10; // 12小时制
public final static int HOUR_OF_DAY = 11; // 24小时制

HOUR字段用于表示12小时制的时间，范围是从0到11；而HOUR_OF_DAY字段则是24小时制，范围从0到23。因此，对于需要覆盖全天时间的需求来说，应该使用HOUR_OF_DAY字段来设置时间。正确的做法如下：

Calendar todayStart = Calendar.getInstance();
todayStart.set(Calendar.HOUR_OF_DAY, 0); // 正确
...省略其他设置...
Long todayStart = todayStart.getTimeInMillis();

以及结束时间的正确设置：

Calendar todayEnd = Calendar.getInstance();
todayEnd.set(Calendar.HOUR_OF_DAY, 23); // 正确
...省略其他设置...
Long todayEnd = todayEnd.getTimeInMillis();

通过这样的调整，可以确保无论何时执行代码，都能准确地获取到当天的起始和结束时间，避免了之前提到的数据异常问题。