Calendar (Java Platform SE 8 )

java.lang.Object
- java.util.Calendar

All Implemented Interfaces:

Serializable， Cloneable Comparable Calendar >，<

已知直接子类：

GregorianCalendar
```
public abstract class Calendar
extends Object
implements Serializable, Cloneable, Comparable<Calendar>
```
的 Calendar类是一个抽象类，为一个特定的瞬间和一套 calendar fields如 YEAR， MONTH， DAY_OF_MONTH， HOUR之间的转换提供了方法，等，和操纵日历字段，例如获得下一周的日期。瞬间可以通过，从 Epoch偏移毫秒值表示，1970年1月1日00:00: 0 GMT（阳历）。
该类还提供了用于在包外实现一个具体的日历系统的额外字段和方法。这些字段和方法被定义为protected。

像其他地方Calendar敏感类，提供了类的方法，getInstance，得到一个有用的对象，这种类型的。Calendar的getInstance方法返回的对象Calendar日历领域已与当前的日期和时间初始化：
```
     Calendar rightNow = Calendar.getInstance();
 
```
一个Calendar对象可以产生所有日历字段值需要实施日期时间格式设置为一个特定的语言和日历样式（例如，日本公历，日本传统）。Calendar定义的值的范围，通过一定的日历字段返回，以及它们的含义。例如，第一个月的日历系统都有价值MONTH == JANUARY日历。其他的价值是由具体的子类来定义的，如ERA。详情见个人领域的文档和子文档。

获取和设置日历字段值

日历字段值可以通过调用set方法。任何领域中设置的值将不会被解释Calendar直到它需要计算其时间价值（从时代的毫秒）或值的日历字段。调用get，getTimeInMillis，getTime，add和roll涉及计算。

宽严相济

Calendar已经解释历法领域两种模式，宽容和不宽容。当一个Calendar是宽松的模式，它接受比它产生更多的日历字段值的范围。当一个Calendar重新返回到get()日历字段值，所有的日历字段进行归一化处理。例如，一个宽容的GregorianCalendar解释MONTH == JANUARY，DAY_OF_MONTH == 32 2月1日。

当一个Calendar是非宽松的模式，它抛出一个异常，如果有任何不一致的日历字段。例如，一个GregorianCalendar总是产生DAY_OF_MONTH值1和长度之间的月。不宽容的GregorianCalendar抛出异常后，计算其时间或日历字段值是否超出范围的字段值已设置。

First Week
Calendar定义了一个特定区域的七天一周使用两个参数：一个星期的第一天和第一周的最小时间（从1到7）。这些数字是从区域资源数据时， Calendar构造。也可以通过设置它们的值的方法来显式地指定它们。
当设置或获取WEEK_OF_MONTH或WEEK_OF_YEAR领域，Calendar必须确定一个月或一年的第一周作为一个参考点。一个月或一年的第一周是最早的七天期间开始getFirstDayOfWeek()和含有至少getMinimalDaysInFirstWeek()日，月或年。星期数……，- 1，0在第一周之前；周编号2，3，…跟随它。请注意，标准编号由get()可能不同。例如，一个特定的Calendar子类可以指定周1周前一年的前一年n周。

日历字段的分辨率
在计算领域从日历的日期和时间，有可能为计算是信息不足（如只有年和月没有一天一个月），或可能存在不一致的信息（如星期二，1996年7月15日（阳历）1996年7月15日是一个星期一）。 Calendar将解决日历字段值来确定在以下日期和时间。
If there is any conflict in calendar field values, Calendar gives priorities to calendar fields that have been set more recently.以下是日历字段的默认组合。最近的组合，所确定的最近设置的单场，将被使用。

For the date fields：
```
 YEAR + MONTH + DAY_OF_MONTH
 YEAR + MONTH + WEEK_OF_MONTH + DAY_OF_WEEK
 YEAR + MONTH + DAY_OF_WEEK_IN_MONTH + DAY_OF_WEEK
 YEAR + DAY_OF_YEAR
 YEAR + DAY_OF_WEEK + WEEK_OF_YEAR
 
```
For the time of day fields：
```
 HOUR_OF_DAY
 AM_PM + HOUR
 
```
如果有任何日历字段的值没有设置在选定的领域相结合，Calendar使用默认值。每个字段的默认值可能会因具体的日历系统而有所不同。例如，在一场GregorianCalendar，默认的是这个时代的开始一样：即，YEAR = 1970，MONTH = JANUARY，DAY_OF_MONTH = 1，等。

注：存在某种奇异的时代解读某些可能的模糊性，这是通过以下方式解决：
1. 23:59是一天的最后一分钟，00:00是下一天的第一分钟。因此，在1999年12月31日00:00至2000年1月1日23:59 < < 00:01 2000年1月1日。
2. 虽然历史不精确，半夜也属于“是”，中午，属于“点”，所以在同一天，上午12:00（午夜）< 12:01，和下午12:00（中午）< 12:01 PM
日期和时间格式字符串不是一个日历定义的一部分，为那些必须由用户在运行时被修改或重写。使用DateFormat格式化日期。

现场操作
日历字段可以用三种方法改变： set()， add()，和 roll()。
set(f, value)变化领域对value f日历。此外，它设置一个内部成员变量表示日历字段f已经改变。虽然日历字段f马上改变，在毫秒级的时间价值计算日历不到get()，getTime()，getTimeInMillis()，add()下一个电话，或roll()了。因此，多次调用set()不触发多个不必要的计算。由于采用了set()改变历法领域，其他领域也可能改变日历，根据日历，日历字段值，以及日历系统。此外，get(f)不一定会有回报value由调用的方法后，set日历字段已被重新计算。具体情况由具体的日历类决定。

例如：考虑一个GregorianCalendar原定于1999年8月31日。打电话set(Calendar.MONTH, Calendar.SEPTEMBER)设置日期1999年9月31日。这是一个临时的内部表示，决心1999年10月1日如果getTime()is叫。然而，一个叫set(Calendar.DAY_OF_MONTH, 30)之前打电话getTime()设置日期到1999年9月30日，由于没有重新计算后出现的set()本身。

add(f, delta)加delta现场f。这相当于两set(f, get(f) + delta)调整要求：

Add rule 1. The value of field f after the call minus the value of field f before the call is delta, modulo any overflow that has occurred in field f. Overflow occurs when a field value exceeds its range and, as a result, the next larger field is incremented or decremented and the field value is adjusted back into its range.

Add rule 2. If a smaller field is expected to be invariant, but it is impossible for it to be equal to its prior value because of changes in its minimum or maximum after field f is changed or other constraints, such as time zone offset changes, then its value is adjusted to be as close as possible to its expected value. A smaller field represents a smaller unit of time. HOUR is a smaller field than DAY_OF_MONTH. No adjustment is made to smaller fields that are not expected to be invariant. The calendar system determines what fields are expected to be invariant.

此外，不同于set()，add()部队的日历的毫秒立即重新计算所有领域。

例如：考虑一个GregorianCalendar原定于1999年8月31日。打电话add(Calendar.MONTH, 13)集日历2000年9月30日。添加规则1集MONTH场到九月13个月，由于加入了明年九月。自九月31 DAY_OF_MONTH不能在GregorianCalendar，添加规则2集DAY_OF_MONTH 30，最接近的可能值。虽然这是一个较小的领域，DAY_OF_WEEK不是由规则2调整，因为它是预期的变化在GregorianCalendar月变化。

roll(f, delta)加delta现场f不改变较大的领域。这相当于下列调整呼叫add(f, delta)：

Roll rule. Larger fields are unchanged after the call. A larger field represents a larger unit of time. DAY_OF_MONTH is a larger field than HOUR.

例如：看到GregorianCalendar.roll(int, int)。

使用模型。激发add()和roll()行为，考虑用户界面组件的递增和递减的月，日和年，按钮，和一个潜在的GregorianCalendar。如果接口读取1999年1月31日和用户按月增量按钮，它该怎么读？如果底层的实现使用set()，不妨读读1999年3月3日。一个更好的结果将是1999年2月28日。此外，如果用户再次按月份的增量按钮，它应该读到1999年3月31日，而不是1999年3月28日。通过保存原始数据和使用add()或roll()，取决于是否应该影响更大的领域，用户界面可以像大多数用户将直观的期望。
从以下版本开始：

JDK1.1

另请参见：

System.currentTimeMillis()， Date， GregorianCalendar， TimeZone， DateFormat， Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`Calendar.Builder` `Calendar.Builder`用于创建各种时间参数的 `Calendar`。

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`ALL_STYLES` 风格 `getDisplayNames`表示所有款式名称说明符，如“一月”和“简”。
`static int`	`AM` 指示在中午之前从午夜的日期 `AM_PM`字段值。
`static int`	`AM_PM` 对于 `get`和 `set`指示 `HOUR`是在中午前或后的场数。
`static int`	`APRIL` 价值的 `MONTH`指示一年中第四个月在格里高利和朱利安的日历。
`protected boolean`	`areFieldsSet` 如果 `fields[]`是与当前设置的时间同步。
`static int`	`AUGUST` 价值的 `MONTH`指示一年中第八个月在格里高利和朱利安的日历。
`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`指示一年中第十二个月在格里高利和朱利安的日历。
`static int`	`DST_OFFSET` 对于 `get`和 `set`表示夏令时偏移毫秒字段数目。
`static int`	`ERA` 场数 `get`和 `set`指示的时代，例如，在朱利安的日历AD或BC。
`static int`	`FEBRUARY` 价值的 `MONTH`指示一年中的第二个月在公历日历和朱利安。
`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` 如果再 `time`值是有效的。
`static int`	`JANUARY` 价值的 `MONTH`场表示一年的第一个月在格里高利和朱利安的日历。
`static int`	`JULY` 价值的 `MONTH`指示一年中第七个月在格里高利和朱利安的日历。
`static int`	`JUNE` 价值的 `MONTH`指示一年中第六个月在格里高利和朱利安的日历。
`static int`	`LONG` 一个名为 `getDisplayName`和 `getDisplayNames`相当于 `LONG_FORMAT`风格。
`static int`	`LONG_FORMAT` 一个样式为 `getDisplayName`和 `getDisplayNames`指示一个很长的名字用于格式。
`static int`	`LONG_STANDALONE` 一个样式为 `getDisplayName`和 `getDisplayNames`指示一个很长的名字单独使用，如一个月的日历标题名称。
`static int`	`MARCH` 价值的 `MONTH`指示一年中第三个月在格里高利和朱利安的日历。
`static int`	`MAY` 价值的 `MONTH`指示一年中第五个月在格里高利和朱利安的日历。
`static int`	`MILLISECOND` 对于 `get`和 `set`指示在第二毫秒字段数目。
`static int`	`MINUTE` 对于 `get`和 `set`指示在小时分钟的场数。
`static int`	`MONDAY` 星期一 `DAY_OF_WEEK`指示字段值。
`static int`	`MONTH` 对于 `get`和 `set`指示的月数。
`static int`	`NARROW_FORMAT` 一个名为 `getDisplayName`和 `getDisplayNames`指示一个狭窄的名称用于格式。
`static int`	`NARROW_STANDALONE` 一个名为 `getDisplayName`和 `getDisplayNames`指示窄名独立风格。
`static int`	`NOVEMBER` 价值的 `MONTH`指示一年中第十一个月在格里高利和朱利安的日历。
`static int`	`OCTOBER` 价值的 `MONTH`指示一年中第十个月在格里高利和朱利安的日历。
`static int`	`PM` 指示午夜前从中午一天的时间 `AM_PM`字段值。
`static int`	`SATURDAY` 星期六的 `DAY_OF_WEEK`指示值。
`static int`	`SECOND` 对于 `get`和 `set`指示第二分钟内场数。
`static int`	`SEPTEMBER` 价值的 `MONTH`指示一年中第九个月在格里高利和朱利安的日历。
`static int`	`SHORT` 一个名为 `getDisplayName`和 `getDisplayNames`相当于 `SHORT_FORMAT`风格。
`static int`	`SHORT_FORMAT` 一个名为 `getDisplayName`和 `getDisplayNames`指示短名称用于格式。
`static int`	`SHORT_STANDALONE` 一个样式为 `getDisplayName`和 `getDisplayNames`指示短名称独立使用，如一个月简称日历标题。
`static int`	`SUNDAY` 星期日 `DAY_OF_WEEK`指示字段值。
`static int`	`THURSDAY` 星期四 `DAY_OF_WEEK`指示字段值。
`protected long`	`time` 目前设置该日历时间，表示在毫秒后1970年1月1日，0:00:00 GMT。
`static int`	`TUESDAY` 星期二 `DAY_OF_WEEK`指示字段值。
`static int`	`UNDECIMBER` 表示一年的第十三个月的 `MONTH`字段值。
`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`指示从格林威治标准时间以毫秒为单位的原始偏移。

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`Calendar()` 构建了一个默认的时区和默认的 `FORMAT`现场日历。
`protected`	`Calendar(TimeZone zone, Locale aLocale)` 用指定的时区和区域设置构造一个日历。

方法摘要

所有方法静态方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`abstract void`	`add(int field, int amount)` 添加或减去指定的时间给定日历领域，基于日历的规则。
`boolean`	`after(Object when)` 是否这 `Calendar`代表由指定的 `Object`表示时间过了一段时间。
`boolean`	`before(Object when)` 是否这 `Calendar`代表一个时间由指定的 `Object`表示的时间。
`void`	`clear()` 将所有的日历字段值和时间值（毫秒偏离 Epoch）这 `Calendar`定义。
`void`	`clear(int field)` 设置给定的日历字段值和时间值（毫秒偏离 Epoch）这 `Calendar`定义。
`Object`	`clone()` 创建并返回此对象的副本。
`int`	`compareTo(Calendar anotherCalendar)` 比较时间（毫秒偏移值从 Epoch）由两 `Calendar`物体的代表。
`protected void`	`complete()` 填写日历领域的任何设置字段。
`protected abstract void`	`computeFields()` 将当前的毫秒时间价值 `time`在 `fields[]`日历字段值。
`protected abstract void`	`computeTime()` 将当前日历字段值在 `fields[]`到毫秒的时间价值 `time`。
`boolean`	`equals(Object obj)` 比较这 `Calendar`到指定的 `Object`。
`int`	`get(int field)` 返回给定日历字段的值。
`int`	`getActualMaximum(int field)` 返回指定日历字段可以有最大值，给出了 `Calendar`时间价值。
`int`	`getActualMinimum(int field)` 返回指定日历字段可以有最小值，给出了 `Calendar`时间价值。
`static Set<String>`	`getAvailableCalendarTypes()` 返回包含所有日历类型在运行时环境 `Calendar`支持的一个不可修改的 `Set`。
`static Locale[]`	`getAvailableLocales()` 返回一个数组的所有地方，这个班的 `getInstance`方法可以返回局部实例。
`String`	`getCalendarType()` 返回该 `Calendar`日历类型。
`String`	`getDisplayName(int field, int style, Locale locale)` 返回给定的 `style`和 `locale`日历的 `field`值的字符串表示形式。
`Map<String,Integer>`	`getDisplayNames(int field, int style, Locale locale)` 返回一个包含所有的名字 `Map`的日历 `field`在给定的 `style`和 `locale`及其相应的字段值。
`int`	`getFirstDayOfWeek()` 有一个星期的第一天是什么；例如，在美国 `SUNDAY`， `MONDAY`法国。
`abstract int`	`getGreatestMinimum(int field)` 返回本 `Calendar`实例给定日历领域最高最低值。
`static Calendar`	`getInstance()` 获取使用默认时区和区域设置的日历。
`static Calendar`	`getInstance(Locale aLocale)` 获取使用默认时区和指定区域设置的日历。
`static Calendar`	`getInstance(TimeZone zone)` 获取使用指定的时区和默认区域设置的日历。
`static Calendar`	`getInstance(TimeZone zone, Locale aLocale)` 获取指定的时区和区域设置的日历。
`abstract int`	`getLeastMaximum(int field)` 这 `Calendar`实例返回给定日历字段的最大值最低。
`abstract int`	`getMaximum(int field)` 这 `Calendar`实例返回给定日历字段的最大值。
`int`	`getMinimalDaysInFirstWeek()` 获取一年的第一周所需的最小天数；如果第一周被定义为包含一年的第一个月的第一天的第一天，该方法返回1。
`abstract int`	`getMinimum(int field)` 这 `Calendar`实例返回给定日历字段的最小值。
`Date`	`getTime()` 返回表示这 `Calendar`时间价值的 `Date`对象（毫秒偏离 Epoch”）。
`long`	`getTimeInMillis()` 返回此日历的时间值以毫秒为单位。
`TimeZone`	`getTimeZone()` 获取时区。
`int`	`getWeeksInWeekYear()` 返回的 `Calendar`代表周年的周数。
`int`	`getWeekYear()` 返回的 `Calendar`代表周年。
`int`	`hashCode()` 返回此日历的哈希代码。
`protected int`	`internalGet(int field)` 返回给定日历字段的值。
`boolean`	`isLenient()` 告诉是否日期/时间解释是宽松的。
`boolean`	`isSet(int field)` 确定给定日历字段值设置，包括案件的值已设置的内部字段的计算方法调用触发 `get`。
`boolean`	`isWeekDateSupported()` 是否这 `Calendar`支持周日期。
`abstract void`	`roll(int field, boolean up)` 添加或减去（上/下）一个单位的时间在给定的时间场不改变较大的领域。
`void`	`roll(int field, int amount)` 在不更改较大字段的范围内将指定的（符号）添加到指定的日历字段中。
`void`	`set(int field, int value)` 将给定的日历字段设置为给定的值。
`void`	`set(int year, int month, int date)` 设置日历字段值 `YEAR`， `MONTH`，和 `DAY_OF_MONTH`。
`void`	`set(int year, int month, int date, int hourOfDay, int minute)` 设置日历领域 `YEAR`， `MONTH`， `DAY_OF_MONTH`， `HOUR_OF_DAY`值，和 `MINUTE`。
`void`	`set(int year, int month, int date, int hourOfDay, int minute, int second)` 设置字段的值 `YEAR`， `MONTH`， `DAY_OF_MONTH`， `HOUR_OF_DAY`， `MINUTE`，和 `SECOND`。
`void`	`setFirstDayOfWeek(int value)` 设置一个星期的第一天是什么；例如，在美国 `SUNDAY`， `MONDAY`法国。
`void`	`setLenient(boolean lenient)` 指定日期/时间解释是否是宽松的。
`void`	`setMinimalDaysInFirstWeek(int value)` 设置一年的第一周所需的最小天数为；例如，如果第一个星期被定义为包含一年的第一个月的第一天的，称为价值1的方法。
`void`	`setTime(Date date)` 设置日历的时间与给定的 `Date`。
`void`	`setTimeInMillis(long millis)` 将此日历的当前时间从给定的长值设置为。
`void`	`setTimeZone(TimeZone value)` 用给定的时区值设置时区。
`void`	`setWeekDate(int weekYear, int weekOfYear, int dayOfWeek)` 设置此 `Calendar`日期与指定日期指定周年，周年和星期。
`Instant`	`toInstant()` 将这个对象的一个 `Instant`。
`String`	`toString()` 返回此日历的字符串表示形式。

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - ERA
```
public static final int ERA
```
    场数 get和 set指示的时代，例如，在朱利安的日历AD或BC。这是一个日历特定值；见子类文档。
    
    另请参见：
    
    GregorianCalendar.AD， GregorianCalendar.BC， Constant Field Values
  - YEAR
```
public static final int YEAR
```
    对于 get和 set指示年场数。这是一个日历特定值；见子类文档。
    
    另请参见：
    
    Constant Field Values
  - MONTH
```
public static final int MONTH
```
    对于 get和 set指示的月数。这是一个日历特定值。在格里高利和朱利安的日历，新年的第一个月 JANUARY这是0；最后取决于一年中的月数。
    
    另请参见：
    
    JANUARY， FEBRUARY， MARCH， APRIL， MAY， JUNE， JULY， AUGUST， SEPTEMBER， OCTOBER， NOVEMBER， DECEMBER， UNDECIMBER， Constant Field Values
  - WEEK_OF_YEAR
```
public static final int WEEK_OF_YEAR
```
    对于 get和 set指示当前的年内周数场数。这一年的第一周，由 getFirstDayOfWeek()和 getMinimalDaysInFirstWeek()定义，价值1。子类定义 WEEK_OF_YEAR为一年的第一周的前几天的价值。
    
    另请参见：
    
    getFirstDayOfWeek()， getMinimalDaysInFirstWeek()， Constant Field Values
  - WEEK_OF_MONTH
```
public static final int WEEK_OF_MONTH
```
    对于 get和 set指示当前的一个月内的周数场数。这个月的第一周，由 getFirstDayOfWeek()和 getMinimalDaysInFirstWeek()定义，价值1。子类定义 WEEK_OF_MONTH每月的第一周的前几天的价值。
    
    另请参见：
    
    getFirstDayOfWeek()， getMinimalDaysInFirstWeek()， Constant Field Values
  - DATE
```
public static final int DATE
```
    对于 get和 set显示该月的一天，场数。这是一个同义词 DAY_OF_MONTH。月的第一天有价值1。
    
    另请参见：
    
    DAY_OF_MONTH， Constant Field Values
  - DAY_OF_MONTH
```
public static final int DAY_OF_MONTH
```
    对于 get和 set显示该月的一天，场数。这是一个同义词 DATE。月的第一天有价值1。
    
    另请参见：
    
    DATE， Constant Field Values
  - DAY_OF_YEAR
```
public static final int DAY_OF_YEAR
```
    对于 get和 set指示当前的年内日数场数。一年的第一天有价值1。
    
    另请参见：
    
    Constant Field Values
  - DAY_OF_WEEK
```
public static final int DAY_OF_WEEK
```
    对于 get和 set显示星期日期字段数。这个字段的值 SUNDAY， MONDAY， TUESDAY， WEDNESDAY， THURSDAY， FRIDAY，和 SATURDAY。
    
    另请参见：
    
    SUNDAY， MONDAY， TUESDAY， WEDNESDAY， THURSDAY， FRIDAY， SATURDAY， Constant Field Values
  - DAY_OF_WEEK_IN_MONTH
```
public static final int DAY_OF_WEEK_IN_MONTH
```
    对于 get和 set指示当前月的星期序号字段数目。一起 DAY_OF_WEEK领域，这一天，一个月内唯一指定。不像 WEEK_OF_MONTH和 WEEK_OF_YEAR，该字段的值不依赖于 getFirstDayOfWeek()或 getMinimalDaysInFirstWeek()。 DAY_OF_MONTH 1通过 7总是对应于 DAY_OF_WEEK_IN_MONTH 1； 8通过 14对应 DAY_OF_WEEK_IN_MONTH 2，等等。 DAY_OF_WEEK_IN_MONTH 0表示一周前 DAY_OF_WEEK_IN_MONTH 1。负值回到本月结束，所以一个月的最后一个星期日被指定为 DAY_OF_WEEK = SUNDAY, DAY_OF_WEEK_IN_MONTH = -1。因为负值计数落后，他们通常会在一个月内对齐比积极的价值观。例如，如果一个月有31天， DAY_OF_WEEK_IN_MONTH -1重叠 DAY_OF_WEEK_IN_MONTH 5和 4结束。
    
    另请参见：
    
    DAY_OF_WEEK， WEEK_OF_MONTH， Constant Field Values
  - AM_PM
```
public static final int AM_PM
```
    对于 get和 set指示 HOUR是在中午前或后的场数。例如，在10:04:下午15.250点 AM_PM是 PM。
    
    另请参见：
    
    AM， PM， HOUR， Constant Field Values
  - HOUR
```
public static final int HOUR
```
    场数 get和 set表示上午或下午的时间。 HOUR用于12小时时钟（0 - 11）。中午和午夜的代表0，而不是12。例如，在10:04:下午15.250点 HOUR 10。
    
    另请参见：
    
    AM_PM， HOUR_OF_DAY， Constant Field Values
  - HOUR_OF_DAY
```
public static final int HOUR_OF_DAY
```
    对于 get和 set指示小时的一天场数。 HOUR_OF_DAY用于24小时。例如，在10:04:下午15.250点 HOUR_OF_DAY 22。
    
    另请参见：
    
    HOUR， Constant Field Values
  - MINUTE
```
public static final int MINUTE
```
    对于 get和 set指示在小时分钟的场数。例如，在10:04:下午15.250点 MINUTE 4。
    
    另请参见：
    
    Constant Field Values
  - SECOND
```
public static final int SECOND
```
    对于 get和 set指示第二分钟内场数。例如，在10:04:下午15.250点 SECOND 15。
    
    另请参见：
    
    Constant Field Values
  - MILLISECOND
```
public static final int MILLISECOND
```
    对于 get和 set指示在第二毫秒字段数目。例如，在10:04:下午15.250点 MILLISECOND 250。
    
    另请参见：
    
    Constant Field Values
  - ZONE_OFFSET
```
public static final int ZONE_OFFSET
```
    对于 get和 set指示从格林威治标准时间以毫秒为单位的原始偏移场数。
    这场反映了这Calendar时区的正确时间偏移值，如果TimeZone实现的子类支持历史GMT偏移的变化。
    
    另请参见：
    
    Constant Field Values
  - DST_OFFSET
```
public static final int DST_OFFSET
```
    对于 get和 set表示夏令时偏移毫秒字段数目。
    这场正确反映日光节约抵消这Calendar时区值如果TimeZone实现的子类支持历史日光节约时间安排的变化。
    
    另请参见：
    
    Constant Field Values
  - FIELD_COUNT
```
public static final int FIELD_COUNT
```
    不同领域的 get和 set认可数量。场数范围从 0..FIELD_COUNT-1。
    
    另请参见：
    
    Constant Field Values
  - SUNDAY
```
public static final int SUNDAY
```
    星期日 DAY_OF_WEEK指示字段值。
    
    另请参见：
    
    Constant Field Values
  - MONDAY
```
public static final int MONDAY
```
    星期一 DAY_OF_WEEK指示字段值。
    
    另请参见：
    
    Constant Field Values
  - TUESDAY
```
public static final int TUESDAY
```
    星期二 DAY_OF_WEEK指示字段值。
    
    另请参见：
    
    Constant Field Values
  - WEDNESDAY
```
public static final int WEDNESDAY
```
    星期三 DAY_OF_WEEK指示字段值。
    
    另请参见：
    
    Constant Field Values
  - THURSDAY
```
public static final int THURSDAY
```
    星期四 DAY_OF_WEEK指示字段值。
    
    另请参见：
    
    Constant Field Values
  - FRIDAY
```
public static final int FRIDAY
```
    星期五 DAY_OF_WEEK指示字段值。
    
    另请参见：
    
    Constant Field Values
  - SATURDAY
```
public static final int SATURDAY
```
    星期六的 DAY_OF_WEEK指示值。
    
    另请参见：
    
    Constant Field Values
  - JANUARY
```
public static final int JANUARY
```
    价值的 MONTH场表示一年的第一个月在格里高利和朱利安的日历。
    
    另请参见：
    
    Constant Field Values
  - FEBRUARY
```
public static final int FEBRUARY
```
    价值的 MONTH指示一年中的第二个月在公历日历和朱利安。
    
    另请参见：
    
    Constant Field Values
  - MARCH
```
public static final int MARCH
```
    价值的 MONTH指示一年中第三个月在格里高利和朱利安的日历。
    
    另请参见：
    
    Constant Field Values
  - APRIL
```
public static final int APRIL
```
    价值的 MONTH指示一年中第四个月在格里高利和朱利安的日历。
    
    另请参见：
    
    Constant Field Values
  - MAY
```
public static final int MAY
```
    价值的 MONTH指示一年中第五个月在格里高利和朱利安的日历。
    
    另请参见：
    
    Constant Field Values
  - JUNE
```
public static final int JUNE
```
    价值的 MONTH指示一年中第六个月在格里高利和朱利安的日历。
    
    另请参见：
    
    Constant Field Values
  - JULY
```
public static final int JULY
```
    价值的 MONTH指示一年中第七个月在格里高利和朱利安的日历。
    
    另请参见：
    
    Constant Field Values
  - AUGUST
```
public static final int AUGUST
```
    价值的 MONTH指示一年中第八个月在格里高利和朱利安的日历。
    
    另请参见：
    
    Constant Field Values
  - SEPTEMBER
```
public static final int SEPTEMBER
```
    价值的 MONTH指示一年中第九个月在格里高利和朱利安的日历。
    
    另请参见：
    
    Constant Field Values
  - OCTOBER
```
public static final int OCTOBER
```
    价值的 MONTH指示一年中第十个月在格里高利和朱利安的日历。
    
    另请参见：
    
    Constant Field Values
  - NOVEMBER
```
public static final int NOVEMBER
```
    价值的 MONTH指示一年中第十一个月在格里高利和朱利安的日历。
    
    另请参见：
    
    Constant Field Values
  - DECEMBER
```
public static final int DECEMBER
```
    价值的 MONTH指示一年中第十二个月在格里高利和朱利安的日历。
    
    另请参见：
    
    Constant Field Values
  - UNDECIMBER
```
public static final int UNDECIMBER
```
    表示一年的第十三个月的 MONTH字段值。虽然 GregorianCalendar不使用此值，阴历做。
    
    另请参见：
    
    Constant Field Values
  - AM
```
public static final int AM
```
    指示在中午之前从午夜的日期 AM_PM字段值。
    
    另请参见：
    
    Constant Field Values
  - PM
```
public static final int PM
```
    指示午夜前从中午一天的时间 AM_PM字段值。
    
    另请参见：
    
    Constant Field Values
  - ALL_STYLES
```
public static final int ALL_STYLES
```
    风格 getDisplayNames表示所有款式名称说明符，如“一月”和“简”。
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    SHORT_FORMAT， LONG_FORMAT， SHORT_STANDALONE， LONG_STANDALONE， SHORT， LONG， Constant Field Values
  - SHORT
```
public static final int SHORT
```
    一个名为 getDisplayName和 getDisplayNames相当于 SHORT_FORMAT风格。
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    SHORT_STANDALONE， LONG， Constant Field Values
  - LONG
```
public static final int LONG
```
    一个名为 getDisplayName和 getDisplayNames相当于 LONG_FORMAT风格。
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    LONG_STANDALONE， SHORT， Constant Field Values
  - NARROW_FORMAT
```
public static final int NARROW_FORMAT
```
    一个名为 getDisplayName和 getDisplayNames指示一个狭窄的名称用于格式。窄的名称通常是单一的字符串，如“M”为星期一。
    
    从以下版本开始：
    
    一点八
    
    另请参见：
    
    NARROW_STANDALONE， SHORT_FORMAT， LONG_FORMAT， Constant Field Values
  - NARROW_STANDALONE
```
public static final int NARROW_STANDALONE
```
    一个名为 getDisplayName和 getDisplayNames指示窄名独立风格。窄的名称通常是单一的字符串，如“M”为星期一。
    
    从以下版本开始：
    
    一点八
    
    另请参见：
    
    NARROW_FORMAT， SHORT_STANDALONE， LONG_STANDALONE， Constant Field Values
  - SHORT_FORMAT
```
public static final int SHORT_FORMAT
```
    一个名为 getDisplayName和 getDisplayNames指示短名称用于格式。
    
    从以下版本开始：
    
    一点八
    
    另请参见：
    
    SHORT_STANDALONE， LONG_FORMAT， LONG_STANDALONE， Constant Field Values
  - LONG_FORMAT
```
public static final int LONG_FORMAT
```
    一个名为 getDisplayName和 getDisplayNames指示一个很长的名字用于格式。
    
    从以下版本开始：
    
    一点八
    
    另请参见：
    
    LONG_STANDALONE， SHORT_FORMAT， SHORT_STANDALONE， Constant Field Values
  - SHORT_STANDALONE
```
public static final int SHORT_STANDALONE
```
    一个样式为 getDisplayName和 getDisplayNames指示短名称独立使用，如一个月简称日历标题。
    
    从以下版本开始：
    
    一点八
    
    另请参见：
    
    SHORT_FORMAT， LONG_FORMAT， LONG_STANDALONE， Constant Field Values
  - LONG_STANDALONE
```
public static final int LONG_STANDALONE
```
    一个样式为 getDisplayName和 getDisplayNames指示一个很长的名字单独使用，如一个月的日历标题名称。
    
    从以下版本开始：
    
    一点八
    
    另请参见：
    
    LONG_FORMAT， SHORT_FORMAT， SHORT_STANDALONE， Constant Field Values
  - fields
```
protected int[] fields
```
    此日历的当前设置时间的日历字段值。这是 FIELD_COUNT整数数组索引值，通过 DST_OFFSET ERA。
  - isSet
```
protected boolean[] isSet
```
    该标志，它告诉如果一个指定的日历字段为日历设置。一个新的对象没有字段集。在第一次调用生成字段的方法后，它们都将在该字段中设置。这是 FIELD_COUNT布尔数组，索引值 ERA通过 DST_OFFSET。
  - time
```
protected long time
```
    目前设置该日历时间，表示在毫秒后1970年1月1日，0:00:00 GMT。
    
    另请参见：
    
    isTimeSet
  - isTimeSet
```
protected boolean isTimeSet
```
    如果再 time值是有效的。时间的变化对 field[]项目作无效。
    
    另请参见：
    
    time
  - areFieldsSet
```
protected boolean areFieldsSet
```
    如果 fields[]是与当前设置的时间同步。如果为false，则得到一个字段的值，下次尝试将力从 time当前值重新计算所有领域。
- Constructor Detail
  - Calendar
```
protected Calendar()
```
    构建了一个默认的时区和默认的 FORMAT现场日历。
    
    另请参见：
    
    TimeZone.getDefault()
  - Calendar
```
protected Calendar(TimeZone zone,
                   Locale aLocale)
```
    用指定的时区和区域设置构造一个日历。
    
    参数
    
    zone -时区使用
    
    aLocale -本周数据区域
- 方法详细信息
  - getInstance
```
public static Calendar getInstance()
```
    获取使用默认时区和区域设置的日历。返回的 Calendar基于默认 FORMAT现场在默认时区的当前时间。
    
    结果
    
    一个日历。
  - getInstance
```
public static Calendar getInstance(TimeZone zone)
```
    获取使用指定的时区和默认区域设置的日历。返回的 Calendar基于默认 FORMAT现场在特定时区的当前时间。
    
    参数
    
    zone -时区使用
    
    结果
    
    一个日历。
  - getInstance
```
public static Calendar getInstance(Locale aLocale)
```
    获取使用默认时区和指定区域设置的日历。返回的 Calendar基于给定的区域设置在默认时区的当前时间。
    
    参数
    
    aLocale -本周数据区域
    
    结果
    
    一个日历。
  - getInstance
```
public static Calendar getInstance(TimeZone zone,
                                   Locale aLocale)
```
    获取指定的时区和区域设置的日历。返回的 Calendar基于给定的区域在特定的时区的当前时间。
    
    参数
    
    zone -时区使用
    
    aLocale -本周数据区域
    
    结果
    
    一个日历。
  - getAvailableLocales
```
public static Locale[] getAvailableLocales()
```
    返回一个数组的所有地方，这个班的 getInstance方法可以返回局部实例。返回的数组必须包含至少一个 Locale实例等于 Locale.US。
    
    结果
    
    地区进行本地化的 Calendar实例可用数组。
  - computeTime
```
protected abstract void computeTime()
```
    将当前日历字段值在 fields[]到毫秒的时间价值 time。
    
    另请参见：
    
    complete()， computeFields()
  - computeFields
```
protected abstract void computeFields()
```
    将当前的毫秒时间价值 time在 fields[]日历字段值。这允许您用一个新的时间为日历设置日历字段值。时间不计算第一；重新计算时间，然后等 complete()方法调用。
    
    另请参见：
    
    computeTime()
  - getTime
```
public final Date getTime()
```
    返回表示这 Calendar时间价值的一 Date对象（毫秒偏离 Epoch”）。
    
    结果
    
    一个 Date代表时间价值。
    
    另请参见：
    
    setTime(Date)， getTimeInMillis()
  - setTime
```
public final void setTime(Date date)
```
    设置日历的时间与给定的 Date。
    注：与Date(Long.MAX_VALUE)或Date(Long.MIN_VALUE)调用setTime()可能产生错误的字段值从get()。
    
    参数
    
    date -给定的日期。
    
    另请参见：
    
    getTime()， setTimeInMillis(long)
  - getTimeInMillis
```
public long getTimeInMillis()
```
    返回此日历的时间值以毫秒为单位。
    
    结果
    
    当前时间为UTC毫秒的时代。
    
    另请参见：
    
    getTime()， setTimeInMillis(long)
  - setTimeInMillis
```
public void setTimeInMillis(long millis)
```
    将此日历的当前时间从给定的长值设置为。
    
    参数
    
    millis从UTC时间的毫秒的新时代。
    
    另请参见：
    
    setTime(Date)， getTimeInMillis()
  - get
```
public int get(int field)
```
    返回给定日历字段的值。在宽松模式下，所有的日历字段都是正常的。在非宽松模式中，所有的日历字段都被验证，如果任何日历字段都有范围值，这种方法将抛出一个异常。规范和验证的 complete()方法处理，其过程的日历系统依赖性。
    
    参数
    
    field -给定的日历字段。
    
    结果
    
    给定日历字段的值。
    
    异常
    
    ArrayIndexOutOfBoundsException -如果指定字段的范围（ field < 0 || field >= FIELD_COUNT）。
    
    另请参见：
    
    set(int,int)， complete()
  - internalGet
```
protected final int internalGet(int field)
```
    返回给定日历字段的值。此方法不涉及字段值的正常化或验证。
    
    参数
    
    field -给定的日历字段。
    
    结果
    
    给定日历字段的值。
    
    另请参见：
    
    get(int)
  - set
```
public void set(int field,
                int value)
```
    将给定的日历字段设置为给定的值。该方法不考虑宽恕模式，而不是解释的价值。
    
    参数
    
    field -给定的日历字段。
    
    value -被设置为给定的日历字段的值。
    
    异常
    
    ArrayIndexOutOfBoundsException -如果指定字段的范围（ field < 0 || field >= FIELD_COUNT）。在非宽松模式。
    
    另请参见：
    
    set(int,int,int)， set(int,int,int,int,int)， set(int,int,int,int,int,int)， get(int)
  - set
```
public final void set(int year,
                      int month,
                      int date)
```
    设置日历字段值 YEAR， MONTH，和 DAY_OF_MONTH。保留其他日历字段的前值。如果这是不需要的，叫 clear()第一。
    
    参数
    
    year -用于设置 YEAR日历字段的值。
    
    month -用于设置 MONTH日历字段的值。月值是0。例如，一月的0。
    
    date -用于设置 DAY_OF_MONTH日历字段的值。
    
    另请参见：
    
    set(int,int)， set(int,int,int,int,int)， set(int,int,int,int,int,int)
  - set
```
public final void set(int year,
                      int month,
                      int date,
                      int hourOfDay,
                      int minute)
```
    设置日历领域 YEAR， MONTH， DAY_OF_MONTH， HOUR_OF_DAY，和 MINUTE值。其他字段保留以前的值。如果这是不需要的，第一个电话 clear()。
    
    参数
    
    year -用于设置 YEAR日历字段的值。
    
    month -用于设置 MONTH日历字段的值。月值是0。例如，一月的0。
    
    date -用于设置 DAY_OF_MONTH日历字段的值。
    
    hourOfDay -用于设置 HOUR_OF_DAY日历字段的值。
    
    minute -用于设置 MINUTE日历字段的值。
    
    另请参见：
    
    set(int,int)， set(int,int,int)， set(int,int,int,int,int,int)
  - set
```
public final void set(int year,
                      int month,
                      int date,
                      int hourOfDay,
                      int minute,
                      int second)
```
    设置字段的值 YEAR， MONTH， DAY_OF_MONTH， HOUR_OF_DAY， MINUTE，和 SECOND。保留其他字段的前值。如果这是不需要的，叫 clear()第一。
    
    参数
    
    year -用于设置 YEAR日历字段的值。
    
    month -用于设置 MONTH日历字段的值。月值是0。例如，一月的0。
    
    date -用于设置 DAY_OF_MONTH日历字段的值。
    
    hourOfDay -用于设置 HOUR_OF_DAY日历字段的值。
    
    minute -用于设置 MINUTE日历字段的值。
    
    second -用于设置 SECOND日历字段的值。
    
    另请参见：
    
    set(int,int)， set(int,int,int)， set(int,int,int,int,int)
  - clear
```
public final void clear()
```
    将所有的日历字段值和时间值（毫秒偏离 Epoch）这 Calendar定义。这意味着， isSet()将返回 false所有日历字段，以及日期和时间计算处理领域好像从来没有被设置。一个 Calendar实现类可以使用其特定的默认字段值为日期/时间计算。例如， GregorianCalendar使用1970如果 YEAR字段的值是未定义的。
    
    另请参见：
    
    clear(int)
  - clear
```
public final void clear(int field)
```
    设置给定的日历字段值和时间值（毫秒偏离 Epoch）这 Calendar定义。这意味着， isSet(field)将返回 false，以及日期和时间计算处理领域似乎从来没有被设置。一个 Calendar实现类可以使用日期和时间计算的领域特定的默认值。
    的HOUR_OF_DAY，HOUR和AM_PM场独立处理和应用的the resolution rule for the time of day。结算的领域不重置该Calendar天值小时。使用set(Calendar.HOUR_OF_DAY, 0)重置小时值。
    
    参数
    
    field -日历字段将被清除。
    
    另请参见：
    
    clear()
  - isSet
```
public final boolean isSet(int field)
```
    确定给定日历字段值设置，包括案件的值已设置的内部字段的计算方法调用触发 get。
    
    参数
    
    field -日历字段测试
    
    结果
    
    true如果给定日历字段值设置； false否则。
  - getDisplayName
```
public String getDisplayName(int field,
                             int style,
                             Locale locale)
```
    返回给定的 style和 locale日历的 field值的字符串表示形式。如果没有字符串表示形式是适用的， null返回。此方法调用 get(field)如果字符串表示形式适用于给定的日历 field得到日历 field
    例如，如果这是一个GregorianCalendar Calendar及其日期2005-01-01，然后对MONTH字段的字符串表示形式将“一月”在长期的风格在英语语言环境或“简”的风格。然而，没有字符串表示形式可为DAY_OF_MONTH领域，该方法将返回null。
    
    默认的实现支持日历字段的DateFormatSymbols在给定的locale名称。
    价值。
    
    参数
    
    field -日历字段的字符串表示形式返回
    
    style -应用于字符串表示的风格；一个 SHORT_FORMAT（ SHORT）， SHORT_STANDALONE， LONG_FORMAT（ LONG）， LONG_STANDALONE， NARROW_FORMAT，或 NARROW_STANDALONE。
    
    locale为字符串表示的区域（指定的 locale任何日历类型被忽略）
    
    结果
    
    字符串表示的给定的 field在给定的 style，或 null如果没有字符串表示形式是适用的。
    
    异常
    
    IllegalArgumentException -如果 field或 style是无效的，或者如果这 Calendar非宽容和任何日历字段值无效
    
    NullPointerException -如果 locale是空的
    
    从以下版本开始：
    
    一点六
  - getDisplayNames
```
public Map<String,Integer> getDisplayNames(int field,
                                           int style,
                                           Locale locale)
```
    返回一个包含所有的名字 Map的日历 field在给定的 style和 locale及其相应的字段值。例如，如果这是一个 GregorianCalendar Calendar，返回的Map将包含“简” JANUARY，“月” FEBRUARY，等等，在 short风格在英语语言环境。
    窄的名字可能不是唯一的，由于使用单一的字符，如“S”为星期日和星期六。在这种情况下，狭窄的名称不包含在返回的Map。
    
    可以考虑其他日历字段的值，以确定一组显示名称。例如，如果这Calendar是阴阳历系统的YEAR字段中指定的年值有一个闰月，此方法将返回包含闰月名称月份名称，和月份名称映射到其值为年比。
    
    默认的实现支持显示名称中包含一个DateFormatSymbols。例如，如果field是MONTH和style是ALL_STYLES，此方法返回一个包含所有的Map DateFormatSymbols.getShortMonths()和DateFormatSymbols.getMonths()返回的字符串。
    
    参数
    
    field -日历字段的显示名称返回
    
    style -应用于字符串表示的风格；一个 SHORT_FORMAT（ SHORT）， SHORT_STANDALONE， LONG_FORMAT（ LONG）， LONG_STANDALONE， NARROW_FORMAT，或 NARROW_STANDALONE
    
    locale -显示名称现场
    
    结果
    
    一个 Map含有 style和 locale及其字段的值都显示名称，或 null如果没有显示名称被定义为 field
    
    异常
    
    IllegalArgumentException -如果 field或 style是无效的，或者如果这 Calendar非宽容和任何日历字段值无效
    
    NullPointerException -如果 locale是空的
    
    从以下版本开始：
    
    一点六
  - complete
```
protected void complete()
```
    填写日历领域的任何设置字段。首先，该 computeTime()方法如果时间（毫秒值称为偏离 Epoch）尚未从日历字段值的计算。然后，该 computeFields()方法来计算所有日历字段值。
  - getAvailableCalendarTypes
```
public static Set<String> getAvailableCalendarTypes()
```
    返回包含所有日历类型在运行时环境 Calendar支持的一个不可修改的 Set。可用的日历类型可用于 Unicode locale extensions， Set返回包含至少 "gregory"。日历类型不包括别名，如 "gregorian"为 "gregory"。
    
    结果
    
    包含所有可用的日历类型的一个不可修改的 Set
    
    从以下版本开始：
    
    一点八
    
    另请参见：
    
    getCalendarType()， Calendar.Builder.setCalendarType(String)， Locale.getUnicodeLocaleType(String)
  - getCalendarType
```
public String getCalendarType()
```
    返回该 Calendar日历类型。日历类型以Unicode的现场数据定义的标记语言（LDML）规范。
    此方法的默认实现返回该Calendar实例的类的名字。任何子类实现LDML定义日历系统应重写此方法以返回相应的日历类型。
    
    结果
    
    日历类型或定义的LDML这 Calendar实例的类的名字
    
    从以下版本开始：
    
    一点八
    
    另请参见：
    
    Locale extensions， Locale.Builder.setLocale(Locale)， Locale.Builder.setUnicodeLocaleKeyword(String, String)
  - equals
```
public boolean equals(Object obj)
```
    比较这 Calendar到指定的 Object。其结果是 true当且仅当参数是一个表示同一时间值相同的日历系统 Calendar对象（毫秒偏离 Epoch）相同的 Calendar参数下这个对象。
    的Calendar参数由isLenient，getFirstDayOfWeek所代表的价值观，getMinimalDaysInFirstWeek和getTimeZone方法。如果有那两Calendars参数之间的任何差异，此方法返回false。
    
    使用compareTo法比较，只有时间值。
    
    重写：
    
    equals 方法重写，继承类 Object
    
    参数
    
    obj -比较对象。
    
    结果
    
    true该对象是否等于 obj； false否则。
    
    另请参见：
    
    Object.hashCode()， HashMap
  - hashCode
```
public int hashCode()
```
    返回此日历的哈希代码。
    
    重写：
    
    hashCode 方法重写，继承类 Object
    
    结果
    
    此对象的哈希代码值。
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)
  - before
```
public boolean before(Object when)
```
    是否这 Calendar代表一个时间由指定的 Object表示的时间。这种方法是等价的：
```
         compareTo(when) < 0
 
```
    当且仅当 when是 Calendar实例。否则，该方法返回 false。
    参数
    
    when - Object进行比较
    
    结果
    
    true如果这 Calendar时间由 when之前的时间； false否则。
    
    另请参见：
    
    compareTo(Calendar)
  - after
```
public boolean after(Object when)
```
    是否这 Calendar代表由指定的 Object表示时间过了一段时间。这种方法是等价的：
```
         compareTo(when) > 0
 
```
    当且仅当 when是 Calendar实例。否则，该方法返回 false。
    参数
    
    when - Object进行比较
    
    结果
    
    true如果这 Calendar时间由 when时间后； false否则。
    
    另请参见：
    
    compareTo(Calendar)
  - compareTo
```
public int compareTo(Calendar anotherCalendar)
```
    比较时间（毫秒偏移值从 Epoch）由两 Calendar物体的代表。
    
    Specified by:
    
    compareTo 接口 Comparable<Calendar>
    
    参数
    
    anotherCalendar - Calendar进行比较。
    
    结果
    
    价值 0如果参数表示的时间等于该 Calendar代表时间；值小于 0如果这 Calendar时间由参数表示的时间；和一个值大于 0如果这 Calendar时间由参数表示的时间后。
    
    异常
    
    NullPointerException -如果指定 Calendar是 null。
    
    IllegalArgumentException -如果指定 Calendar对象时间价值不能由于任何无效的日历值。
    
    从以下版本开始：
    
    一点五
  - add
```
public abstract void add(int field,
                         int amount)
```
    添加或减去指定的时间给定日历领域，基于日历的规则。例如，从日历的当前时间减去5天，你可以通过调用：
    add(Calendar.DAY_OF_MONTH, -5)。
    
    参数
    
    field -日历字段。
    
    amount -日期或时间被添加到字段。
    
    另请参见：
    
    roll(int,int)， set(int,int)
  - roll
```
public abstract void roll(int field,
                          boolean up)
```
    添加或减去（上/下）一个单位的时间在给定的时间场不改变较大的领域。例如，将当前日期的一天，你可以通过调用：
    卷（calendar.date，真的）。当滚动在一年或calendar.year领域，它将在1年的价值和价值之间的范围称getMaximum(Calendar.YEAR)返回。上滚动时，月或calendar.month领域，其他领域如日期可能冲突，需要改变。例如，滚动月的日期01 / 31 / 96将导致02 / 29 / 96。当滚动在一天或calendar.hour_of_day领域时，它将在0和23之间的范围内的小时值的卷，这是零基础。
    
    参数
    
    field -时间域。
    
    up -表示如果指定时间字段的值是可以卷起或滚下。使用真实，如果卷起，否则虚假。
    
    另请参见：
    
    add(int,int)， set(int,int)
  - roll
```
public void roll(int field,
                 int amount)
```
    在不更改较大字段的范围内将指定的（符号）添加到指定的日历字段中。负量意味着滚。
    注：此默认实现Calendar只是反复调用，一个单位roll()卷版。这可能并不总是做正确的事。例如，如果DAY_OF_MONTH字段为31，滚动通过二月会把它设置为28。这个函数的GregorianCalendar版本需要关心这个问题。其他子类还应提供重写这个函数，做正确的事。
    
    参数
    
    field -日历字段。
    
    amount的签约金额添加到日历 field。
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    roll(int,boolean)， add(int,int)， set(int,int)
  - setTimeZone
```
public void setTimeZone(TimeZone value)
```
    用给定的时区值设置时区。
    
    参数
    
    value -给定的时间区。
  - getTimeZone
```
public TimeZone getTimeZone()
```
    获取时区。
    
    结果
    
    与此日历关联的时区对象。
  - setLenient
```
public void setLenient(boolean lenient)
```
    指定日期/时间解释是否是宽松的。随着宽松的解释，日期，如“二月942日，1996日”将被视为相当于1996年2月1日后的第九百四十一天。有了严格的（非仁慈的）解释，这样的日期将导致一个异常被抛出。默认是宽容的。
    
    参数
    
    lenient - true如果宽松的模式被开启； false如果是关闭的。
    
    另请参见：
    
    isLenient()， DateFormat.setLenient(boolean)
  - isLenient
```
public boolean isLenient()
```
    告诉是否日期/时间解释是宽松的。
    
    结果
    
    true如果本日历的解释模式是宽松； false否则。
    
    另请参见：
    
    setLenient(boolean)
  - setFirstDayOfWeek
```
public void setFirstDayOfWeek(int value)
```
    设置一个星期的第一天是什么；例如，在美国 SUNDAY， MONDAY法国。
    
    参数
    
    value -给定的第一天。
    
    另请参见：
    
    getFirstDayOfWeek()， getMinimalDaysInFirstWeek()
  - getFirstDayOfWeek
```
public int getFirstDayOfWeek()
```
    有一个星期的第一天是什么；例如，在美国 SUNDAY， MONDAY法国。
    
    结果
    
    本周的第一天。
    
    另请参见：
    
    setFirstDayOfWeek(int)， getMinimalDaysInFirstWeek()
  - setMinimalDaysInFirstWeek
```
public void setMinimalDaysInFirstWeek(int value)
```
    设置一年的第一周所需的最小天数为；例如，如果第一个星期被定义为包含一年的第一个月的第一天的，称为价值1的方法。如果它必须是一个完整的一周，使用价值7。
    
    参数
    
    value -在今年第一周所需最小的天。
    
    另请参见：
    
    getMinimalDaysInFirstWeek()
  - getMinimalDaysInFirstWeek
```
public int getMinimalDaysInFirstWeek()
```
    获取一年的第一周所需的最小天数；如果第一周被定义为包含一年的第一个月的第一天的第一天，该方法返回1。如果所需的最小天必须是一个完整的一周，这个方法返回7。
    
    结果
    
    一年中的第一周所需的最少天数。
    
    另请参见：
    
    setMinimalDaysInFirstWeek(int)
  - isWeekDateSupported
```
public boolean isWeekDateSupported()
```
    是否这 Calendar支持周日期。
    此方法的默认实现将返回false。
    
    结果
    
    如果这 true Calendar支持周期； false否则。
    
    从以下版本开始：
    
    一点七
    
    另请参见：
    
    getWeekYear()， setWeekDate(int,int,int)， getWeeksInWeekYear()
  - getWeekYear
```
public int getWeekYear()
```
    返回的 Calendar代表周年。这一周与周周期是同步的。本周的 first day of the first week是新年的第一天。
    此方法的默认实现将抛出一个UnsupportedOperationException。
    
    结果
    
    这 Calendar周年
    
    异常
    
    UnsupportedOperationException若周纪年不在这 Calendar支持。
    
    从以下版本开始：
    
    一点七
    
    另请参见：
    
    isWeekDateSupported()， getFirstDayOfWeek()， getMinimalDaysInFirstWeek()
  - setWeekDate
```
public void setWeekDate(int weekYear,
                        int weekOfYear,
                        int dayOfWeek)
```
    设置此 Calendar日期与指定日期指定周年，周年和星期。
    不像set方法，所有的日历字段值的计算和time返回时。
    
    如果weekOfYear出每年的范围有效周的weekYear，weekYear和weekOfYear值以宽松的方式进行调整，或IllegalArgumentException扔在非宽松的模式。
    
    此方法的默认实现将抛出一个UnsupportedOperationException。
    
    参数
    
    weekYear -周年
    
    weekOfYear基于 weekYear周数
    
    dayOfWeek -星期值日：一为 DAY_OF_WEEK场常数： SUNDAY，…， SATURDAY。
    
    异常
    
    IllegalArgumentException -如果任何给定的日期说明符无效或任何日历字段是给定的日期，说明非宽松模式不一致
    
    UnsupportedOperationException若周纪年不在这 Calendar支持。
    
    从以下版本开始：
    
    一点七
    
    另请参见：
    
    isWeekDateSupported()， getFirstDayOfWeek()， getMinimalDaysInFirstWeek()
  - getWeeksInWeekYear
```
public int getWeeksInWeekYear()
```
    返回的 Calendar代表周年的周数。
    此方法的默认实现将抛出一个UnsupportedOperationException。
    
    结果
    
    一周内的周数。
    
    异常
    
    UnsupportedOperationException若周纪年不在这 Calendar支持。
    
    从以下版本开始：
    
    一点七
    
    另请参见：
    
    WEEK_OF_YEAR， isWeekDateSupported()， getWeekYear()， getActualMaximum(int)
  - getMinimum
```
public abstract int getMinimum(int field)
```
    这 Calendar实例返回给定日历字段的最小值。最小值被定义为最小的方法返回的值 get任何可能的时间价值。最小值取决于实例的日历系统特定参数。
    
    参数
    
    field -日历字段。
    
    结果
    
    给定日历字段的最小值。
    
    另请参见：
    
    getMaximum(int)， getGreatestMinimum(int)， getLeastMaximum(int)， getActualMinimum(int)， getActualMaximum(int)
  - getMaximum
```
public abstract int getMaximum(int field)
```
    这 Calendar实例返回给定日历字段的最大值。最大值是指最大值 get方法返回的任何可能的时间价值。最大值取决于实例的日历系统特定参数。
    
    参数
    
    field -日历字段。
    
    结果
    
    给定日历字段的最大值。
    
    另请参见：
    
    getMinimum(int)， getGreatestMinimum(int)， getLeastMaximum(int)， getActualMinimum(int)， getActualMaximum(int)
  - getGreatestMinimum
```
public abstract int getGreatestMinimum(int field)
```
    返回本 Calendar实例给定日历领域最高最低值。最高最低值定义为最大值 getActualMinimum(int)返回的任何可能的时间价值。最大最小值取决于实例的日历系统特定参数。
    
    参数
    
    field -日历字段。
    
    结果
    
    给定日历字段的最高的最小值。
    
    另请参见：
    
    getMinimum(int)， getMaximum(int)， getLeastMaximum(int)， getActualMinimum(int)， getActualMaximum(int)
  - getLeastMaximum
```
public abstract int getLeastMaximum(int field)
```
    这 Calendar实例返回给定日历字段的最大值最低。最低的最大值被定义为最小的值返回 getActualMaximum(int)任何可能的时间价值。最小最大值取决于实例的日历系统特定参数。例如，一个公历体系 Calendar返回28的 DAY_OF_MONTH领域，因为第二十八是最短的这个月的最后一天，二月在平年。
    
    参数
    
    field -日历字段。
    
    结果
    
    给定日历字段的最低最大值。
    
    另请参见：
    
    getMinimum(int)， getMaximum(int)， getGreatestMinimum(int)， getActualMinimum(int)， getActualMaximum(int)
  - getActualMinimum
```
public int getActualMinimum(int field)
```
    返回指定日历字段可以有最小值，给出了 Calendar时间价值。
    该方法的默认实现使用一个迭代算法来确定日历字段的实际最小值。子类应该，如果可能的话，重写这个在许多情况下，更有效的实现，他们可以简单地返回getMinimum()。
    
    参数
    
    field -日历字段
    
    结果
    
    对于这 Calendar时间值的给定日历字段的最小
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    getMinimum(int)， getMaximum(int)， getGreatestMinimum(int)， getLeastMaximum(int)， getActualMaximum(int)
  - getActualMaximum
```
public int getActualMaximum(int field)
```
    返回指定日历字段可以有最大值，给出了 Calendar时间价值。例如，在 MONTH领域实际的最大值是12年，13年在希伯来日历系统。
    该方法的默认实现使用一个迭代算法来确定日历字段的实际最大值。子类应该，如果可能的话，重写一个更有效的实现。
    
    参数
    
    field -日历字段
    
    结果
    
    对于这 Calendar时间值给定日历字段的最大值
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    getMinimum(int)， getMaximum(int)， getGreatestMinimum(int)， getLeastMaximum(int)， getActualMinimum(int)
  - clone
```
public Object clone()
```
    创建并返回此对象的副本。
    
    重写：
    
    clone 方法重写，继承类 Object
    
    结果
    
    这个对象的一个副本。
    
    另请参见：
    
    Cloneable
  - toString
```
public String toString()
```
    返回此日历的字符串表示形式。此方法仅用于调试目的，返回的字符串的格式可能会在实现中有所不同。返回的字符串是空的但可能不 null。
    
    重写：
    
    toString 方法重写，继承类 Object
    
    结果
    
    此日历的字符串表示形式。
  - toInstant
```
public final Instant toInstant()
```
    将这个对象的一个 Instant。
    转换创建一个Instant代表时间轴上的同一点为这Calendar。
    
    结果
    
    表示时间线上的同一点的瞬间
    
    从以下版本开始：
    
    一点八

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class Calendar

获取和设置日历字段值

宽严相济

First Week

日历字段的分辨率

现场操作

Nested Class Summary

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Field Detail

ERA

YEAR

MONTH

WEEK_OF_YEAR

WEEK_OF_MONTH

DATE

DAY_OF_MONTH

DAY_OF_YEAR

DAY_OF_WEEK

DAY_OF_WEEK_IN_MONTH

AM_PM

HOUR

HOUR_OF_DAY

MINUTE

SECOND

MILLISECOND

ZONE_OFFSET

DST_OFFSET

FIELD_COUNT

SUNDAY

MONDAY

TUESDAY

WEDNESDAY

THURSDAY

FRIDAY

SATURDAY

JANUARY

FEBRUARY

MARCH

APRIL

MAY

JUNE

JULY

AUGUST

SEPTEMBER

OCTOBER

NOVEMBER

DECEMBER

UNDECIMBER

AM

PM

ALL_STYLES

SHORT

LONG

NARROW_FORMAT

NARROW_STANDALONE

SHORT_FORMAT

LONG_FORMAT

SHORT_STANDALONE

LONG_STANDALONE

fields

isSet

time

isTimeSet

areFieldsSet

Constructor Detail

Calendar

Calendar

方法详细信息

getInstance

getInstance

getInstance

getInstance

getAvailableLocales

computeTime

computeFields

getTime

setTime