Java.util.Calendar类

介绍

所述的java.util.Calendar类是一个抽象类，可以为在某一特定时刻和一组日历字段，诸如年，月，DAY_OF_MONTH，HOUR之间转换的方法，等等，以及用于操纵该日历字段，例如作为下一周的日期。以下是关于日历的重点

该类还提供了在包外实现具体日历系统的附加字段和方法。
日历定义某些日历字段返回的值范围。

类声明

以下是java.util.Calendar类的声明

public abstract class Calendar
   extends Object
   implements Serializable, Cloneable, Comparable<Calendar>

领域

以下是java.util.Calendar类的字段

static int ALL_STYLES - 这是getDisplayNames的样式说明符，表示所有样式中的名称，例如“January”和“Jan”。
static int AM - 这是AM_PM字段的值，表示从午夜到正午之前的一天的时间段。
static int AM_PM - 这是get和set的字段编号，指示HOUR是在中午之前还是之后。
static int APRIL - 这是MONTH字段的值，表示Gregorian和Julian日历中一年中的第四个月。
protected boolean areFieldsSet - 如果fields []与当前设置的时间同步，则为true。
static int AUGUST - 这是MONTH字段的值，表示Gregorian和Julian日历中一年中的第八个月。
static int DATE - 这是get和set的字段编号，表示该月的某一天。
static int DAY_OF_MONTH - 这是get和set的字段编号，表示该月的某一天。
static int DAY_OF_WEEK - 这是get和set的字段编号，表示星期几。
static int DAY_OF_WEEK_IN_MONTH - 这是get和set的字段编号，表示当前月份中星期几的序号。
static int DAY_OF_YEAR - 这是get和set的字段编号，表示当前年份中的日期编号。
static int DECEMBER - 这是MONTH字段的值，表示Gregorian和Julian日历中一年中的第12个月。
static int DST_OFFSET - 这是get和set的字段编号，指示夏令时偏移量（以毫秒为单位）。
static int ERA - 这是指示时代的get和set的字段编号，例如Julian日历中的AD或BC。
static int FEBRUARY - 这是MONTH字段的值，表示Gregorian和Julian日历中一年中的第二个月。
static int FIELD_COUNT - 这是get和set识别的不同字段的数量。
protected int [] fields - 这是此日历当前设置时间的日历字段值。
static int FRIDAY - 这是表示星期五的DAY_OF_WEEK字段的值。
static int HOUR - 这是get和set的字段编号，表示上午或下午的小时。
static int HOUR_OF_DAY - 这是get和set的字段编号，表示当天的小时。
protected boolean [] isSet - 这是用于指示是否设置了日历的指定日历字段的标志。
protected boolean isTimeSet - 如果时间值有效，则为true。
static int JANUARY - 这是MONTH字段的值，表示Gregorian和Julian日历中一年中的第一个月。
static int JULY - 这是MONTH字段的值，表示Gregorian和Julian日历中一年中的第七个月。
static int JUNE - 这是MONTH字段的值，表示Gregorian和Julian日历中一年中的第六个月。
static int LONG - 这是getDisplayName和getDisplayNames的样式说明符，表示长名称，例如“January”。
static int MARCH - 这是MONTH字段的值，表示Gregorian和Julian日历中一年中的第三个月。
static int MAY - 这是MONTH字段的值，表示Gregorian和Julian日历中一年中的第五个月。
static int MILLISECOND - 这是get和set的字段编号，表示秒内的毫秒数。
static int MINUTE - 这是get和set的字段编号，表示小时内的分钟。
static int MONDAY - 这是表示星期一的DAY_OF_WEEK字段的值。
static int MONTH - 这是表示月份的get和set的字段编号。
static int NOVEMBER - 这是MONTH字段的值，表示Gregorian和Julian日历中一年中的第11个月。
static int OCTOBER - 这是MONTH字段的值，表示Gregorian和Julian日历中一年中的第十个月。
static int PM - 这是AM_PM字段的值，表示从中午到午夜之前的一天的时间段。
static int SATURDAY - 这是表示星期六的DAY_OF_WEEK字段的值。
static int SECOND - 这是get和set的字段编号，表示分钟内的第二个。
static int SEPTEMBER - 这是MONTH字段的值，表示Gregorian和Julian日历中一年中的第九个月。
static int SHORT - 这是getDisplayName的样式说明符，getDisplayNames表示短名称，例如“Jan”。
static int SUNDAY - 这是表示星期日的DAY_OF_WEEK字段的值。
static int THURSDAY - 这是表示星期四的DAY_OF_WEEK字段的值。
protected long time - 这是此日历的当前设置时间，以1970年1月1日格林威治标准时间0:00:00之后的毫秒数表示。
static int TUESDAY - 这是表示星期二的DAY_OF_WEEK字段的值。
static int UNDECIMBER - 这是MONTH字段的值，表示一年中的第13个月。
static int WEDNESDAY - 这是表示星期三的DAY_OF_WEEK字段的值。
static int WEEK_OF_MONTH - 这是get和set的字段编号，表示当前月份中的周数。
static int WEEK_OF_YEAR - 这是get和set的字段编号，表示当前年份中的周数。。
static int YEAR - 这是指示年份的get和set的字段编号。
static int ZONE_OFFSET - 这是get和set的字段编号，表示GMT的原始偏移量，以毫秒为单位。
### 类构造函数

Sr.No.	构造函数和描述
1	protected Calendar() 此构造函数使用默认时区和语言环境构造Calendar。
2	protected Calendar(TimeZone zone, Locale aLocale) 此构造函数构造具有指定时区和区域设置的日历。

Sr.No.

构造函数和描述

protected Calendar()

此构造函数使用默认时区和语言环境构造Calendar。

protected Calendar(TimeZone zone, Locale aLocale)

此构造函数构造具有指定时区和区域设置的日历。

类方法

Sr.No.	方法和描述
1	abstract void add（int field，int amount）此方法根据日历的规则将指定的时间量添加或减去给定的日历字段。
2	boolean after（Object when）此方法返回此Calendar是否表示指定Object表示的时间之后的时间。
3	boolean before（Object when）此方法返回此Calendar是否表示指定Object表示的时间之前的时间。
4	void clear（）此方法设置此日历的所有日历字段值和时间值（与Epoch的毫秒偏移量）未定义。
5	void clear（int field）此方法设置此Calendar的给定日历字段值和时间值（与Epoch的毫秒偏移量）undefined。
6	Object clone() 此方法创建并返回此对象的副本。
7	int compareTo（Calendar anotherCalendar）此方法比较两个Calendar对象表示的时间值（与Epoch的毫秒偏移量）。
8	protected void complete（）此方法填写日历字段中的任何未设置字段。
9	protected abstract void computeFields（）此方法将当前毫秒时间值时间转换为字段[]中的日历字段值。
10	protected abstract void computeTime（）此方法将fields []中的当前日历字段值转换为毫秒时间值时间。
11	boolean equals（Object obj）此方法将此Calendar与指定的Object进行比较。
12	int get（int field）此方法返回给定日历字段的值。
13	int getActualMaximum（int field）在给定此Calendar的时间值的情况下，此方法返回指定日历字段可能具有的最大值。
14	int getActualMinimum（int field）在给定此Calendar的时间值的情况下，此方法返回指定日历字段可能具有的最小值。
15	static Locale [] getAvailableLocales（）此方法返回所有语言环境的数组，此类的getInstance方法可以为其返回已本地化的实例。
16	String getDisplayName（int field，int style，Locale locale）此方法返回给定样式和区域设置中日历字段值的字符串表示形式。
17	Map <String，Integer> getDisplayNames（int field，int style，Locale locale）此方法返回一个Map，其中包含给定样式和区域设置中日历字段的所有名称及其对应的字段值。
18	int getFirstDayOfWeek（）这个方法得到了一周的第一天; 例如，美国的星期日，法国的星期一。
19	abstract int getGreatestMinimum（int field）此方法返回此Calendar实例的给定日历字段的最高最小值。
20	static Calendar getInstance()）此方法使用默认时区和区域设置获取日历。
21	static Calendar getInstance（Locale aLocale）此方法使用默认时区和指定的区域设置获取日历。
22	static Calendar getInstance(TimeZone zone) 此方法使用指定的时区和默认语言环境获取日历。
23	static Calendar getInstance(TimeZone zone, Locale aLocale) 此方法获取具有指定时区和区域设置的日历。
24	abstract int getLeastMaximum（int field）此方法返回此Calendar实例的给定日历字段的最小最大值。
25	abstract int getMaximum（int field）此方法返回此Calendar实例的给定日历字段的最大值。
26	int getMinimalDaysInFirstWeek（）这种方法可以获得一年中第一周所需的最短天数; 例如，如果第一周被定义为包含一年中第一个月的第一天的那一周，则该方法返回1。
27	abstract int getMinimum（int field）此方法返回此Calendar实例的给定日历字段的最小值。
28	Date getTime（）此方法返回表示此Calendar的时间值的Date对象（距Epoch的毫秒偏移量）。
29	long getTimeInMillis（）此方法以毫秒为单位返回此Calendar的时间值。
30	TimeZone getTimeZone（）此方法获取时区。
31	int hashCode（）此方法返回此日历的哈希码。
32	protected int internalGet（int field）此方法返回给定日历字段的值。
33	boolean isLenient（）此方法告知日期/时间解释是否宽松。
34	boolean isSet（int field）此方法确定给定的日历字段是否具有值集，包括由get方法调用触发的内部字段计算设置的值的情况。
35	abstract void roll（int field，boolean up）此方法在给定时间字段上添加或减去（上/下）单个时间单位而不更改更大的字段。
36	void roll（int field，int amount）此方法将指定的（签名）金额添加到指定的日历字段，而不更改更大的字段。
37	void set（int field，int value）此方法将给定的日历字段设置为给定值。
38	void set（int year，int month，int date）此方法设置日历字段YEAR，MONTH和DAY_OF_MONTH的值。
39	void set（int year，int month，int date，int hourOfDay，int minute）此方法设置日历字段YEAR，MONTH，DAY_OF_MONTH，HOUR_OF_DAY和MINUTE的值。
40	void set（int year，int month，int date，int hourOfDay，int minute，int second）此方法设置字段YEAR，MONTH，DAY_OF_MONTH，HOUR，MINUTE和SECOND的值。
41	void setFirstDayOfWeek（int value）这个方法设定一周的第一天是什么; 例如，美国的星期日，法国的星期一。
42	void setLenient（boolean lenient）此方法指定日期/时间解释是否宽松。
43	void setMinimalDaysInFirstWeek（int value）此方法设定一年中第一周所需的最小天数; 例如，如果第一周定义为包含一年中第一个月的第一天的那一周，请使用值调用此方法。
44	void setTime（Date date）此方法使用给定日期设置此日历的时间。
45	void setTimeInMillis（long millis）此方法根据给定的long值设置此Calendar的当前时间。
46	void setTimeZone（TimeZone value）此方法使用给定的时区值设置时区。
47	Strinf toString（）此方法返回此日历的字符串表示形式。

方法继承

该类继承以下类中的方法

java.util.Object

Sr.No.	方法和描述
1	abstract void add（int field，int amount）此方法根据日历的规则将指定的时间量添加或减去给定的日历字段。
2	boolean after（Object when）此方法返回此Calendar是否表示指定Object表示的时间之后的时间。
3	boolean before（Object when）此方法返回此Calendar是否表示指定Object表示的时间之前的时间。
4	void clear（）此方法设置此日历的所有日历字段值和时间值（与Epoch的毫秒偏移量）未定义。
5	void clear（int field）此方法设置此Calendar的给定日历字段值和时间值（与Epoch的毫秒偏移量）undefined。
6	Object clone() 此方法创建并返回此对象的副本。
7	int compareTo（Calendar anotherCalendar）此方法比较两个Calendar对象表示的时间值（与Epoch的毫秒偏移量）。
8	protected void complete（）此方法填写日历字段中的任何未设置字段。
9	protected abstract void computeFields（）此方法将当前毫秒时间值时间转换为字段[]中的日历字段值。
10	protected abstract void computeTime（）此方法将fields []中的当前日历字段值转换为毫秒时间值时间。
11	boolean equals（Object obj）此方法将此Calendar与指定的Object进行比较。
12	int get（int field）此方法返回给定日历字段的值。
13	int getActualMaximum（int field）在给定此Calendar的时间值的情况下，此方法返回指定日历字段可能具有的最大值。
14	int getActualMinimum（int field）在给定此Calendar的时间值的情况下，此方法返回指定日历字段可能具有的最小值。
15	static Locale [] getAvailableLocales（）此方法返回所有语言环境的数组，此类的getInstance方法可以为其返回已本地化的实例。
16	String getDisplayName（int field，int style，Locale locale）此方法返回给定样式和区域设置中日历字段值的字符串表示形式。
17	Map <String，Integer> getDisplayNames（int field，int style，Locale locale）此方法返回一个Map，其中包含给定样式和区域设置中日历字段的所有名称及其对应的字段值。
18	int getFirstDayOfWeek（）这个方法得到了一周的第一天; 例如，美国的星期日，法国的星期一。
19	abstract int getGreatestMinimum（int field）此方法返回此Calendar实例的给定日历字段的最高最小值。
20	static Calendar getInstance()）此方法使用默认时区和区域设置获取日历。
21	static Calendar getInstance（Locale aLocale）此方法使用默认时区和指定的区域设置获取日历。
22	static Calendar getInstance(TimeZone zone) 此方法使用指定的时区和默认语言环境获取日历。
23	static Calendar getInstance(TimeZone zone, Locale aLocale) 此方法获取具有指定时区和区域设置的日历。
24	abstract int getLeastMaximum（int field）此方法返回此Calendar实例的给定日历字段的最小最大值。
25	abstract int getMaximum（int field）此方法返回此Calendar实例的给定日历字段的最大值。
26	int getMinimalDaysInFirstWeek（）这种方法可以获得一年中第一周所需的最短天数; 例如，如果第一周被定义为包含一年中第一个月的第一天的那一周，则该方法返回1。
27	abstract int getMinimum（int field）此方法返回此Calendar实例的给定日历字段的最小值。
28	Date getTime（）此方法返回表示此Calendar的时间值的Date对象（距Epoch的毫秒偏移量）。
29	long getTimeInMillis（）此方法以毫秒为单位返回此Calendar的时间值。
30	TimeZone getTimeZone（）此方法获取时区。
31	int hashCode（）此方法返回此日历的哈希码。
32	protected int internalGet（int field）此方法返回给定日历字段的值。
33	boolean isLenient（）此方法告知日期/时间解释是否宽松。
34	boolean isSet（int field）此方法确定给定的日历字段是否具有值集，包括由get方法调用触发的内部字段计算设置的值的情况。
35	abstract void roll（int field，boolean up）此方法在给定时间字段上添加或减去（上/下）单个时间单位而不更改更大的字段。
36	void roll（int field，int amount）此方法将指定的（签名）金额添加到指定的日历字段，而不更改更大的字段。
37	void set（int field，int value）此方法将给定的日历字段设置为给定值。
38	void set（int year，int month，int date）此方法设置日历字段YEAR，MONTH和DAY_OF_MONTH的值。
39	void set（int year，int month，int date，int hourOfDay，int minute）此方法设置日历字段YEAR，MONTH，DAY_OF_MONTH，HOUR_OF_DAY和MINUTE的值。
40	void set（int year，int month，int date，int hourOfDay，int minute，int second）此方法设置字段YEAR，MONTH，DAY_OF_MONTH，HOUR，MINUTE和SECOND的值。
41	void setFirstDayOfWeek（int value）这个方法设定一周的第一天是什么; 例如，美国的星期日，法国的星期一。
42	void setLenient（boolean lenient）此方法指定日期/时间解释是否宽松。
43	void setMinimalDaysInFirstWeek（int value）此方法设定一年中第一周所需的最小天数; 例如，如果第一周定义为包含一年中第一个月的第一天的那一周，请使用值调用此方法。
44	void setTime（Date date）此方法使用给定日期设置此日历的时间。
45	void setTimeInMillis（long millis）此方法根据给定的long值设置此Calendar的当前时间。
46	void setTimeZone（TimeZone value）此方法使用给定的时区值设置时区。
47	Strinf toString（）此方法返回此日历的字符串表示形式。