【Java 基础篇】Java Calendar 类：日期和时间处理指南

比眉伴天荒 2023-10-15 18:29 29阅读 0赞

![在这里插入图片描述][c642a1716fe940889ad7daa70c47187c.png]

在 Java 中，日期和时间的处理是常见的任务之一。为了更灵活地处理日期和时间，Java 提供了 `java.util.Calendar` 类，它提供了一种面向对象的方式来操作日期和时间。本篇博客将详细介绍 `Calendar` 类的使用方法，特别是面向基础小白的读者。

## 什么是 Calendar 类？ ##

`Calendar` 类是 Java 中用于处理日期和时间的抽象类。它提供了一种独立于特定日历系统的方式来处理日期和时间。通过 `Calendar` 类，你可以执行许多常见的日期和时间操作，如计算日期差异、添加或减去时间单位等。

## 创建 Calendar 对象 ##

要使用 `Calendar` 类，首先需要创建一个 `Calendar` 对象。通常，你可以通过调用 `getInstance()` 方法来获取默认时区和区域设置的 `Calendar` 对象：

Calendar calendar = Calendar.getInstance();

这将创建一个代表当前日期和时间的 `Calendar` 对象。

## 获取日期和时间信息 ##

一旦有了 `Calendar` 对象，你可以获取日期和时间的各个部分，如年、月、日、小时、分钟、秒等。下面是一些示例代码：

int year = calendar.get(Calendar.YEAR);
    int month = calendar.get(Calendar.MONTH) + 1; // 月份从 0 开始，所以要加 1
    int day = calendar.get(Calendar.DAY_OF_MONTH);
    int hour = calendar.get(Calendar.HOUR_OF_DAY);
    int minute = calendar.get(Calendar.MINUTE);
    int second = calendar.get(Calendar.SECOND);
    
    System.out.println("Year: " + year);
    System.out.println("Month: " + month);
    System.out.println("Day: " + day);
    System.out.println("Hour: " + hour);
    System.out.println("Minute: " + minute);
    System.out.println("Second: " + second);

以上示例中，我们使用 `get()` 方法获取了年、月、日、小时、分钟和秒的值。需要注意的是，月份从 0 开始，所以我们在获取月份时加了 1。

## 设置日期和时间信息 ##

除了获取日期和时间信息，`Calendar` 类还允许你设置这些信息。你可以使用 `set()` 方法来设置特定的日期和时间部分。以下是一些示例：

calendar.set(Calendar.YEAR, 2023);
    calendar.set(Calendar.MONTH, Calendar.SEPTEMBER); // 月份也可以使用常量
    calendar.set(Calendar.DAY_OF_MONTH, 15);
    calendar.set(Calendar.HOUR_OF_DAY, 14);
    calendar.set(Calendar.MINUTE, 30);
    calendar.set(Calendar.SECOND, 0);

上述示例中，我们设置了 `Calendar` 对象的年、月、日、小时、分钟和秒。

## 添加和减去时间单位 ##

`Calendar` 类还提供了方法来添加和减去时间单位，例如，天、小时、分钟等。以下是一些示例：

calendar.add(Calendar.DAY_OF_MONTH, 5); // 添加 5 天
    calendar.add(Calendar.HOUR_OF_DAY, -3); // 减去 3 小时
    calendar.add(Calendar.MINUTE, 30); // 添加 30 分钟

上述示例中，我们使用 `add()` 方法来对 `Calendar` 对象的日期和时间进行操作。

## 获取日期差异 ##

你可以使用 `Calendar` 类来计算两个日期之间的差异，例如，计算两个日期相差的天数。以下是一个示例：

Calendar date1 = Calendar.getInstance();
    date1.set(2023, Calendar.SEPTEMBER, 1);
    
    Calendar date2 = Calendar.getInstance();
    date2.set(2023, Calendar.OCTOBER, 1);
    
    long diffInMillis = date2.getTimeInMillis() - date1.getTimeInMillis();
    long diffInDays = diffInMillis / (24 * 60 * 60 * 1000);
    
    System.out.println("Days between date1 and date2: " + diffInDays);

在上述示例中，我们创建了两个 `Calendar` 对象，分别表示两个日期，并计算了它们之间的天数差异。

## 格式化日期和时间 ##

`Calendar` 类通常用于执行日期和时间计算，而不是格式化日期和时间以供用户查看。如果需要格式化日期和时间，通常会使用 `SimpleDateFormat` 类，它在之前的博客中有详细介绍。

## Calendar 类的更多用法 ##

当涉及到日期和时间的操作，`Calendar` 类提供了许多更复杂的用法和选项，以满足各种需求。以下是一些 `Calendar` 类的更多用法：

### 1. 获取一周的第一天和最后一天 ###

有时你可能需要获取一周的第一天（通常是星期日）和最后一天（通常是星期六）。你可以使用以下代码来实现：

Calendar calendar = Calendar.getInstance();
    calendar.set(Calendar.DAY_OF_WEEK, Calendar.SUNDAY); // 设置为星期日
    Date firstDayOfWeek = calendar.getTime(); // 获取一周的第一天
    
    calendar.add(Calendar.DAY_OF_WEEK, 6); // 将日期移动到星期六
    Date lastDayOfWeek = calendar.getTime(); // 获取一周的最后一天
    
    System.out.println("First day of the week: " + firstDayOfWeek);
    System.out.println("Last day of the week: " + lastDayOfWeek);

### 2. 获取一月的第一天和最后一天 ###

类似于获取一周的第一天和最后一天，你也可以获取一月的第一天和最后一天：

Calendar calendar = Calendar.getInstance();
    calendar.set(Calendar.DAY_OF_MONTH, 1); // 设置为月份的第一天
    Date firstDayOfMonth = calendar.getTime(); // 获取一月的第一天
    
    calendar.add(Calendar.MONTH, 1); // 将日期移动到下个月的第一天
    calendar.add(Calendar.DAY_OF_MONTH, -1); // 减去一天，即为上个月的最后一天
    Date lastDayOfMonth = calendar.getTime(); // 获取一月的最后一天
    
    System.out.println("First day of the month: " + firstDayOfMonth);
    System.out.println("Last day of the month: " + lastDayOfMonth);

### 3. 判断是否为闰年 ###

你可以使用 `isLeapYear()` 方法来判断某一年是否为闰年：

int year = 2024;
    Calendar calendar = Calendar.getInstance();
    calendar.set(Calendar.YEAR, year);
    
    if (calendar.getActualMaximum(Calendar.DAY_OF_YEAR) > 365) {
        
        System.out.println(year + " is a leap year.");
    } else {
        
        System.out.println(year + " is not a leap year.");
    }

### 4. 获取一天的开始和结束时间 ###

如果你需要获取某一天的开始时间（通常是00:00:00）和结束时间（通常是23:59:59），可以使用以下代码：

Calendar calendar = Calendar.getInstance();
    calendar.set(Calendar.HOUR_OF_DAY, 0);
    calendar.set(Calendar.MINUTE, 0);
    calendar.set(Calendar.SECOND, 0);
    Date startTime = calendar.getTime(); // 获取一天的开始时间
    
    calendar.set(Calendar.HOUR_OF_DAY, 23);
    calendar.set(Calendar.MINUTE, 59);
    calendar.set(Calendar.SECOND, 59);
    Date endTime = calendar.getTime(); // 获取一天的结束时间
    
    System.out.println("Start time of the day: " + startTime);
    System.out.println("End time of the day: " + endTime);

### 5. 获取指定日期是星期几 ###

你可以使用 `get(Calendar.DAY_OF_WEEK)` 方法来获取指定日期是星期几。星期天对应的值是 `Calendar.SUNDAY`，星期一是 `Calendar.MONDAY`，以此类推。

Calendar calendar = Calendar.getInstance();
    calendar.set(2023, Calendar.SEPTEMBER, 1); // 设置日期为 2023 年 9 月 1 日
    int dayOfWeek = calendar.get(Calendar.DAY_OF_WEEK);
    
    switch (dayOfWeek) {
        
        case Calendar.SUNDAY:
            System.out.println("It's Sunday!");
            break;
        case Calendar.MONDAY:
            System.out.println("It's Monday!");
            break;
        // 其他星期几的判断
        default:
            System.out.println("It's another day of the week.");
    }

### 6. 获取月份的天数 ###

你可以使用 `getActualMaximum(Calendar.DAY_OF_MONTH)` 方法来获取指定月份的天数。这对于计算每月的最后一天特别有用。

Calendar calendar = Calendar.getInstance();
    calendar.set(Calendar.MONTH, Calendar.FEBRUARY); // 设置月份为二月
    int daysInMonth = calendar.getActualMaximum(Calendar.DAY_OF_MONTH);
    
    System.out.println("Days in February: " + daysInMonth);

这些是 `Calendar` 类的一些高级用法，它们可以帮助你更灵活地处理日期和时间操作。但需要注意的是，`Calendar` 类在 Java 8 之后已经被新的日期和时间 API（`java.time` 包）取代，新 API 更简单、更安全，推荐在新项目中使用。但如果你在旧项目中需要处理日期和时间，`Calendar` 类仍然是一个有用的工具。

## Calendar 类使用的注意事项 ##

在使用 `Calendar` 类时，需要注意以下一些使用注意事项，以确保日期和时间的操作正确、安全，避免潜在的问题：

1.  **月份从0开始**：`Calendar` 类中的月份是从0开始的，即0表示一月，1表示二月，以此类推，11表示十二月。这与人们通常的月份表示方式不同，要格外注意月份的设置和获取。
2.  **时区和区域设置**：`Calendar` 类的行为受到默认时区和区域设置的影响。在涉及跨时区操作时，应该特别注意时区的设置，以避免出现意外的偏移。
3.  **线程安全性**：`Calendar` 类不是线程安全的，因此在多线程环境下使用时需要额外小心。通常情况下，最好将 `Calendar` 对象限定在单个线程内，或使用线程安全的日期和时间库，如 `java.time`（Java 8及更高版本引入）。
4.  **日期和时间范围**：`Calendar` 类的日期和时间范围受到系统实现的限制。例如，一些操作系统可能无法表示某些日期（特别是在1970年之前或2038年之后），因此在处理非常早期或非常晚期的日期时要格外小心。
5.  **月份的天数**：要谨慎处理月份的天数，不同月份的天数是不同的，如果不考虑这一点可能会导致日期计算的错误。
6.  **避免魔法数值**：在代码中避免硬编码日期和时间的数值，而是使用 `Calendar` 常量和方法来表示日期和时间部分，以提高可读性和可维护性。
7.  **异常处理**：在进行日期和时间计算时，要格外小心异常情况，如日期不存在、时间超出范围等。在必要的情况下，要使用异常处理机制来处理这些情况，以确保程序的稳定性。
8.  **不建议使用**：Java 8 引入了新的日期和时间 API（`java.time` 包），如 `LocalDate`、`LocalTime` 和 `ZonedDateTime` 等类，这些类更简单、更安全，推荐在新项目中使用。`Calendar` 类在新 API 出现后逐渐被淘汰，不建议在新项目中使用。

总之，在使用 `Calendar` 类时，要小心处理日期和时间的各种情况，谨慎操作，确保结果符合预期，同时考虑到时区和区域设置等因素，以确保日期和时间的准确性和一致性。

## 总结 ##

`Calendar` 类是 Java 中用于处理日期和时间的重要工具之一。通过创建 `Calendar` 对象，你可以获取和设置日期和时间的各个部分，执行日期和时间的计算，以及计算日期差异。然而，需要注意的是，`Calendar` 类的使用可能较为繁琐，而且并不是线程安全的。在 Java 8 之后，引入了新的日期和时间 API（`java.time` 包），提供了更好的日期和时间处理方式，推荐在新项目中使用。

[c642a1716fe940889ad7daa70c47187c.png]: https://img-blog.csdnimg.cn/c642a1716fe940889ad7daa70c47187c.png