Java Calendar Class

The Calendar class is an abstract class in Java for handling dates and times. It is located in thejava.utilpackage. This class provides a series of methods to operate on date and time fields (such as year, month, day, hour, minute, etc.), and can perform date calculations and comparisons.

Why do we need the Calendar class?

In Java, although the Date class can also represent dates and times, it has the following limitations:

1. Most methods are deprecated
2. Does not support internationalization
3. Limited date calculation functionality

The Calendar class solves these problems and provides more powerful and flexible date-time manipulation capabilities.

Basic usage of the Calendar class

Getting a Calendar instance

Since Calendar is an abstract class, we cannot instantiate it directly. The standard way to obtain a Calendar instance is:

This method returns a Calendar instance (usually GregorianCalendar) based on the default time zone and locale.

Setting date and time

We can use theset()method to set the various fields of a Calendar object:

Note: Months are 0-based, where 0 represents January and 11 represents December. To avoid confusion, it is recommended to use the constants defined in the Calendar class (e.g., Calendar.JANUARY, Calendar.FEBRUARY, etc.).

Getting date and time information

Use theget()method to get the various fields of a Calendar object:

Common methods of the Calendar class

Date calculation

The Calendar class provides convenient date calculation methods:

Date comparison

We can use thecompareTo()method to compare two Calendar objects:

Getting a timestamp

You can use thegetTimeInMillis()method to get the timestamp (milliseconds) represented by a Calendar object:

You can also use thegetTime()method to convert it to a Date object:

Advanced usage of the Calendar class

Setting time zone

We can set a specific time zone for a Calendar object:

Calendar field operations

The Calendar class provides theroll()method, which can roll a field without affecting other fields:

Getting the first day of the week

Different regions define the first day of the week differently (some use Sunday, some use Monday):

Comprehensive example

Output result:

当前时间: 2023年5月15日 14:25:36
设置后的时间: 2023-05-15 10:30:00
运算后的时间: 2023-05-20 07:30:00
比较结果: 之前
星期二

Notes on the Calendar class

1. Months are 0-based: In the Calendar class, months are 0-based (0=January, 11=December), which can easily lead to errors.

2. Mutability: Calendar objects are mutable; modifying one Calendar object affects all places that reference it.

3. Thread safety: The Calendar class is not thread-safe, and extra synchronization is needed in multi-threaded environments.

4. Performance: Frequently creating Calendar instances affects performance; consider reusing instances.

5. Time zone issues: The system time zone is used by default, and special attention is needed for cross-time-zone applications.

Alternative in Java 8

Starting from Java 8, a new date-time API (thejava.timepackage) was introduced, providing a more modern and easier-to-use way to handle dates and times. If you are using Java 8 or later, it is recommended to prefer the new API:

The new API solves many problems of the Calendar class, including better thread safety, a more intuitive API design, and more powerful functionality.

Common methods of the Java Calendar class

The following are common methods of the java.util.Calendar class:

Basic methods

Field constants (common)

Date-time operation methods

Time comparison methods

Other useful methods