Calendar类

目录

是什么？

位于包

特点

关于Calendar实例

介绍

如何实例

常用方法

getInstance()

get()

getTime()

set()

setTime()

add()

getActualMaximum()

Calendar常量

年份相关

月份相关

日期相关

时间相关

其他

---

是什么？

Calendar是Java中日期处理的核心类之一，提供灵活的方式来处理日期和时间信息。

---

位于包

位于 java.util 包中，需要手动导入。

---

特点

允许进行日期和时间的字段操作，比如获取或设置年、月、日、小时、分钟等，同时也支持一些复杂的日期时间计算，比如计算两个日期之间的差值，或者给某个日期加上一定的时间量。

---

关于Calendar实例

介绍

Calendar 类是一个抽象类，它本身并不能被实例化。需要使用其子类之一来获取一个特定日历系统的实例。

如何实例

通过调用Calendar 类的 getInstance方法实例化子类。

Calendar.getInstance() 方法的实现依赖于底层系统提供的日期和时间服务。通常，它会调用Calendar.getInstance(TimeZone zone，Locale aLocale)方法，并传入默认的TimeZone和 Locale。

以下是Calendar.getInstance()方法的一个简化版本的示例代码，说明其工作原理：

public static Calendar getInstance() {  
    return getInstance(TimeZone.getDefault(), Locale.getDefault());  
}  
  
public static Calendar getInstance(TimeZone zone, Locale aLocale) {  
    CalendarProvider provider = CalendarProvider.getInstance();  
    if (provider != null) {  
        return provider.getInstance(zone, aLocale);  
    }  
    // 如果没有找到自定义的提供者，则使用默认的提供者  
    return createCalendar(zone, aLocale);  
}  
  
private static Calendar createCalendar(TimeZone zone, Locale aLocale) {  
    Calendar calendar = null;  
    String calendarType = aLocale.getUnicodeLocaleType("ca");  
    if (calendarType == null) {  
        // 使用默认的日历类型，通常是 GregorianCalendar  
        calendar = new GregorianCalendar(zone, aLocale);  
    } else {  
        // 根据指定的日历类型创建日历对象  
        switch (calendarType) {  
            case "buddhist":  
                calendar = new BuddhistCalendar(zone, aLocale);  
                break;  
            case "japanese":  
                calendar = new JapaneseImperialCalendar(zone, aLocale);  
                break;  
            case "gregory":  
            default:  
                calendar = new GregorianCalendar(zone, aLocale);  
        }  
    }  
    return calendar;  
}

PS：以上代码展示了 getInstance 方法如何根据默认的时区和语言环境创建一个 Calendar 对象。它首先尝试获取一个 CalendarProvider 实例，这允许自定义的日历提供者插入到系统中。如果没有找到自定义的提供者，则使用默认的提供者（在这个例子中，默认提供者是创建GregorianCalendar 实例）。

---

常用方法

getInstance()

说明：是 Calendar 类的一个静态方法，用于获取一个表示当前日期和时间的 Calendar 对象。（这个对象是根据默认时区和语言环境设置的）

举例：

// 获取当前日期和时间的 Calendar 对象  
Calendar calendar = Calendar.getInstance();

PS：我们使用 getInstance() 方法来获取一个 Calendar 的实例，这个实例通常是 GregorianCalendar 类的一个对象，它是 Calendar 的一个具体实现。

get()

说明：获取日期和时间指定字段的值。

举例：

Calendar calendar = Calendar.getInstance();  
int year = calendar.get(Calendar.YEAR); // 获取当前年份  
int month = calendar.get(Calendar.MONTH); // 获取当前月份（注意，月份是从0开始的，所以实际月份需要+1）  
int day = calendar.get(Calendar.DAY_OF_MONTH); // 获取当前日

getTime()

说明：获取当前Calendar对象表示的日期和时间，返回一个Date对象。

Calendar calendar = Calendar.getInstance();  
Date date = calendar.getTime(); // 获取当前日期和时间

set()

说明：设置日期和时间指定字段的值为给定的值。

举例:

Calendar calendar = Calendar.getInstance();  
calendar.set(Calendar.YEAR, 2023); // 设置年份为2023  
calendar.set(Calendar.MONTH, Calendar.MARCH); // 设置月份为3月（注意，月份是从0开始的，所以3月是Calendar.MARCH）  
calendar.set(Calendar.DAY_OF_MONTH, 15); // 设置日期为15日

setTime()

说明：设置当前Calendar对象表示的日期和时间为给定的Date对象表示的值。

举例：

Date date = new Date(); // 创建一个Date对象，表示当前日期和时间  
Calendar calendar = Calendar.getInstance();  
calendar.setTime(date); // 设置Calendar对象的日期和时间为date的值

add()

说明：在日期和时间指定字段上增加或减少指定的数量。

第一个参与为Calendar常量，第二个参数是根据第一个参数增加或减少的数量。

举例：

Calendar calendar = Calendar.getInstance();  
calendar.add(Calendar.DAY_OF_MONTH, 1); // 当前日期加1天
calendar.add(Calendar.WEEK_OF_YEAR, 1); // 当前日期加一周  
calendar.add(Calendar.MONTH, -1); // 当前日期减1个月
calendar.add(Calendar.YEAR, 2); // 当前日期加2年

PS：第一个参数也可以是写具体数值，但尽量使用Calendar定义好的常量。

getActualMaximum()

说明：获取指定字段的最大值。

举例：

Calendar calendar = Calendar.getInstance();  
int maxDaysInMonth = calendar.getActualMaximum(Calendar.DAY_OF_MONTH); // 获取当前月份的最大天数

---

Calendar常量

主要是为了提供方便、可读性强且类型安全的方式来表示特定的值。

具体体现有：

特定的数值（Calendar.YEAR、Calendar.MONTH、Calendar.DAY_OF_MONTH等）使用这些常量而不是直接使用字面量或变量，可以确保在代码中使用的值始终是预期的  类型，防止类型错误等问题。

年份相关

Calendar.YEAR：表示年份。

示例：

Calendar calendar = Calendar.getInstance(); 
int year = calendar.get(Calendar.YEAR); // 获取当前年份
calendar.set(Calendar.YEAR, 2023); // 设置年份（为2023）
calendar.add(Calendar.YEAR, 1);//添加年份（1年）

月份相关

Calendar.MONTH：表示月份。注意，月份是从0开始的，即0代表1月，11代表12月。

示例：

Calendar calendar = Calendar.getInstance(); 
int month = calendar.get(Calendar.MONTH) + 1; // 获取当前月份，并加1以符合日常习惯

日期相关

Calendar.DAY_OF_MONTH：表示一个月中的某一天。

示例：

Calendar calendar = Calendar.getInstance(); 
int day = calendar.get(Calendar.DAY_OF_MONTH); // 获取当前日期

Calendar.DAY_OF_WEEK：表示一周中的某一天（星期几）。星期日为一周的第一天，其值为1；星期六为一周的最后一天，其值为7。

示例：

Calendar calendar = Calendar.getInstance(); 
int dayOfWeek = calendar.get(Calendar.DAY_OF_WEEK); // 获取当前是星期几

Calendar.DAY_OF_YEAR：表示一年中的某一天。

示例：

Calendar calendar = Calendar.getInstance(); 
int dayOfYear = calendar.get(Calendar.DAY_OF_YEAR); // 获取当前是一年中的第几天

时间相关

Calendar.HOUR_OF_DAY：表示一天中的小时数（24小时制）。

示例：

Calendar calendar = Calendar.getInstance(); 
int hour = calendar.get(Calendar.HOUR_OF_DAY); // 获取当前小时数（24小时制）

Calendar.HOUR：表示一天中的小时数（12小时制）。

示例：

Calendar calendar = Calendar.getInstance(); 
int hour12 = calendar.get(Calendar.HOUR); // 获取当前小时数（12小时制）

Calendar.MINUTE：表示分钟数。

示例：

Calendar calendar = Calendar.getInstance(); 
int minute = calendar.get(Calendar.MINUTE); // 获取当前分钟数

Calendar.SECOND：表示秒数。

示例：

Calendar calendar = Calendar.getInstance(); 
int second = calendar.get(Calendar.SECOND); // 获取当前秒数

Calendar.MILLISECOND：表示毫秒数。

示例：

Calendar calendar = Calendar.getInstance(); 
int millisecond = calendar.get(Calendar.MILLISECOND); // 获取当前毫秒数

其他

Calendar.AM_PM：表示上午或下午的标记。

示例：

Calendar calendar = Calendar.getInstance(); 
int amPm = calendar.get(Calendar.AM_PM); // 获取当前是上午还是下午