字段详细信息

• ERA

  public static final int ERA

  get和set字段编号表示时代，例如Julian日历中的AD或BC。 这是特定于日历的值; 请参阅子类文档。

  另请参见：

  GregorianCalendar.AD ， GregorianCalendar.BC ， 常数字段值

• YEAR

  public static final int YEAR

  get和set字段编号表示年份。 这是特定于日历的值; 请参阅子类文档。

  另请参见：

  常数字段值

• MONTH

  public static final int MONTH

  get和set字段编号表示月份。 这是特定于日历的值。 格里高利和朱利安日历中的第一个月是JANUARY ，即0; 最后一个取决于一年中的月数。

  另请参见：

  JANUARY ， FEBRUARY ， MARCH ， APRIL ， MAY ， JUNE ， JULY ， AUGUST ， SEPTEMBER ， OCTOBER ， NOVEMBER ， DECEMBER ， UNDECIMBER ， 常数字段值

• WEEK_OF_YEAR

  public static final int WEEK_OF_YEAR

  get和set字段编号表示当年的周数。 由getFirstDayOfWeek()和getMinimalDaysInFirstWeek()定义的一年中的第一周具有值1.子类定义在一年的第一周之前的天数WEEK_OF_YEAR的值。

  另请参见：

  getFirstDayOfWeek() ， getMinimalDaysInFirstWeek() ， 常数字段值

• WEEK_OF_MONTH

  public static final int WEEK_OF_MONTH

  get和set字段编号表示get的周数。 由getFirstDayOfWeek()和getMinimalDaysInFirstWeek()定义的月份的第一周具有值1.子类定义在该月的第一周之前的天数的值WEEK_OF_MONTH 。

  另请参见：

  getFirstDayOfWeek() ， getMinimalDaysInFirstWeek() ， 常数字段值

• DATE

  public static final int DATE

  get和set字段编号表示当月的日期。 这是DAY_OF_MONTH的同义词。 该月的第一天的价值为1。

  另请参见：

  DAY_OF_MONTH ， 常数字段值

• DAY_OF_MONTH

  public static final int DAY_OF_MONTH

  get和set字段编号表示当月的日期。 这是DATE的同义词。 该月的第一天的价值为1。

  另请参见：

  DATE ， 常数字段值

• DAY_OF_YEAR

  public static final int DAY_OF_YEAR

  get和set字段编号表示当年的日期编号。 一年的第一天价值1。

  另请参见：

  常数字段值

• 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 ， 常数字段值

• 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 ， 常数字段值

• AM_PM

  public static final int AM_PM

  get和set字段编号表示HOUR是在中午之前还是之后。 例如，在下午10：04： AM_PM是PM 。

  另请参见：

  AM ， PM ， HOUR ， 常数字段值

• HOUR

  public static final int HOUR

  get和set字段编号表示上午或下午的小时。 HOUR用于12小时制（0 - 11）。 中午和午夜由0表示，而不是由12表示。例如，在10：04：15.250 PM， HOUR为10。

  另请参见：

  AM_PM ， HOUR_OF_DAY ， 常数字段值

• HOUR_OF_DAY

  public static final int HOUR_OF_DAY

  get和set字段编号表示当天的小时。 HOUR_OF_DAY用于24小时制。 例如，在下午10：04： HOUR_OF_DAY是22。

  另请参见：

  HOUR ， 常数字段值

• MINUTE

  public static final int MINUTE

  get和set字段编号表示小时内的分钟。 例如，在下午10：04： MINUTE是4。

  另请参见：

  常数字段值

• SECOND

  public static final int SECOND

  get和set字段编号表示分钟内的第二个。 例如，在下午10：04： SECOND是15。

  另请参见：

  常数字段值

• MILLISECOND

  public static final int MILLISECOND

  get和set字段编号表示秒内的毫秒数。 例如，在下午10：04： MILLISECOND是250。

  另请参见：

  常数字段值

• ZONE_OFFSET

  public static final int ZONE_OFFSET

  get和set字段编号指示GMT的原始偏移（以毫秒为单位）。

  如果TimeZone实现子类支持历史GMT偏移量更改，则此字段反映此Calendar的时区的正确GMT偏移值。

  另请参见：

  常数字段值

• DST_OFFSET

  public static final int DST_OFFSET

  get和set字段编号，指示夏令时偏移量（以毫秒为单位）。

  如果TimeZone实施子类支持历史夏令时时间表更改，则此字段反映此Calendar的时区的正确夏令时偏移值。

  另请参见：

  常数字段值

• FIELD_COUNT

  public static final int FIELD_COUNT

  get和set识别的不同字段数。 字段编号范围为0..FIELD_COUNT-1 。

  另请参见：

  常数字段值

• SUNDAY

  public static final int SUNDAY

  表示星期日的 DAY_OF_WEEK字段的值。

  另请参见：

  常数字段值

• MONDAY

  public static final int MONDAY

  DAY_OF_WEEK字段的值表示星期一。

  另请参见：

  常数字段值

• TUESDAY

  public static final int TUESDAY

  表示星期二的 DAY_OF_WEEK字段的值。

  另请参见：

  常数字段值

• WEDNESDAY

  public static final int WEDNESDAY

  DAY_OF_WEEK字段的值表示星期三。

  另请参见：

  常数字段值

• THURSDAY

  public static final int THURSDAY

  DAY_OF_WEEK字段的值表示星期四。

  另请参见：

  常数字段值

• FRIDAY

  public static final int FRIDAY

  表示星期五的 DAY_OF_WEEK字段的值。

  另请参见：

  常数字段值

• SATURDAY

  public static final int SATURDAY

  表示星期六的 DAY_OF_WEEK字段的值。

  另请参见：

  常数字段值

• JANUARY

  public static final int JANUARY

  MONTH字段的值，表示格里高利和朱利安日历中一年中的第一个月。

  另请参见：

  常数字段值

• FEBRUARY

  public static final int FEBRUARY

  MONTH字段的值，表示格里高利和朱利安日历中一年中的第二个月。

  另请参见：

  常数字段值

• MARCH

  public static final int MARCH

  MONTH字段的值，表示格里高利和朱利安日历中一年中的第三个月。

  另请参见：

  常数字段值

• APRIL

  public static final int APRIL

  MONTH字段的值，表示格里高利和朱利安日历中一年中的第四个月。

  另请参见：

  常数字段值

• MAY

  public static final int MAY

  MONTH字段的值，表示格里高利和朱利安日历中一年中的第五个月。

  另请参见：

  常数字段值

• JUNE

  public static final int JUNE

  MONTH字段的值，表示格里高利和朱利安日历中的第六个月。

  另请参见：

  常数字段值

• JULY

  public static final int JULY

  MONTH字段的值，表示格里高利和朱利安日历中一年中的第七个月。

  另请参见：

  常数字段值

• AUGUST

  public static final int AUGUST

  MONTH字段的值，表示格里高利和朱利安日历中一年中的第八个月。

  另请参见：

  常数字段值

• SEPTEMBER

  public static final int SEPTEMBER

  MONTH字段的值，表示格里高利和朱利安日历中一年中的第九个月。

  另请参见：

  常数字段值

• OCTOBER

  public static final int OCTOBER

  MONTH字段的值，表示格里高利和朱利安日历中一年中的第十个月。

  另请参见：

  常数字段值

• NOVEMBER

  public static final int NOVEMBER

  MONTH字段的值，表示格里高利和朱利安日历中的一年中的第十一个月。

  另请参见：

  常数字段值

• DECEMBER

  public static final int DECEMBER

  MONTH字段的值，表示格里高利和朱利安日历中的一年中的第十二个月。

  另请参见：

  常数字段值

• UNDECIMBER

  public static final int UNDECIMBER

  MONTH字段的值，表示一年中的第13个月。 虽然GregorianCalendar不使用此值，但是月历会这样做。

  另请参见：

  常数字段值

• AM

  public static final int AM

  AM_PM字段的值，表示从午夜到正午之前的一天的时段。

  另请参见：

  常数字段值

• PM

  public static final int PM

  AM_PM字段的值，表示从中午到午夜之前的一天的时段。

  另请参见：

  常数字段值

• ALL_STYLES

  public static final int ALL_STYLES

  getDisplayNames的样式说明符，表示所有样式的名称，例如“January”和“Jan”。

  从以下版本开始：

  1.6

  另请参见：

  SHORT_FORMAT ， LONG_FORMAT ， SHORT_STANDALONE ， LONG_STANDALONE ， SHORT ， LONG ， 常数字段值

• SHORT

  public static final int SHORT

  getDisplayName和 getDisplayNames的样式说明 符 ，相当于 SHORT_FORMAT 。

  从以下版本开始：

  1.6

  另请参见：

  SHORT_STANDALONE ， LONG ， 常数字段值

• LONG

  public static final int LONG

  getDisplayName和 getDisplayNames的样式说明 符 ，相当于 LONG_FORMAT 。

  从以下版本开始：

  1.6

  另请参见：

  LONG_STANDALONE ， SHORT ， 常数字段值

• NARROW_FORMAT

  public static final int NARROW_FORMAT

  getDisplayName和getDisplayNames的样式说明符 ，指示用于格式的窄名称。 窄名称通常是单个字符串，例如星期一的“M”。

  从以下版本开始：

  1.8

  另请参见：

  NARROW_STANDALONE ， SHORT_FORMAT ， LONG_FORMAT ， 常数字段值

• NARROW_STANDALONE

  public static final int NARROW_STANDALONE

  getDisplayName和getDisplayNames的样式说明符 ， 独立指示窄名称。 窄名称通常是单个字符串，例如星期一的“M”。

  从以下版本开始：

  1.8

  另请参见：

  NARROW_FORMAT ， SHORT_STANDALONE ， LONG_STANDALONE ， 常数字段值

• SHORT_FORMAT

  public static final int SHORT_FORMAT

  getDisplayName和 getDisplayNames的样式说明 符 ，指示用于格式的短名称。

  从以下版本开始：

  1.8

  另请参见：

  SHORT_STANDALONE ， LONG_FORMAT ， LONG_STANDALONE ， 常数字段值

• LONG_FORMAT

  public static final int LONG_FORMAT

  getDisplayName和 getDisplayNames的样式说明 符 ，指示用于格式的长名称。

  从以下版本开始：

  1.8

  另请参见：

  LONG_STANDALONE ， SHORT_FORMAT ， SHORT_STANDALONE ， 常数字段值

• SHORT_STANDALONE

  public static final int SHORT_STANDALONE

  getDisplayName和 getDisplayNames的样式说明 符 ，指示独立使用的短名称，例如月份缩写作为日历标题。

  从以下版本开始：

  1.8

  另请参见：

  SHORT_FORMAT ， LONG_FORMAT ， LONG_STANDALONE ， 常数字段值

• LONG_STANDALONE

  public static final int LONG_STANDALONE

  getDisplayName和 getDisplayNames的样式说明 符 ，表示独立使用的长名称，例如月份名称作为日历标题。

  从以下版本开始：

  1.8

  另请参见：

  LONG_FORMAT ， SHORT_FORMAT ， SHORT_STANDALONE ， 常数字段值

• 字段

  protected int[] fields

  此日历的当前设置时间的日历字段值。 这是一个FIELD_COUNT整数数组，索引值为ERA到DST_OFFSET 。

• isSet

  protected boolean[] isSet

  用于指示是否设置了日历的指定日历字段的标志。 新对象没有设置字段。 在第一次调用生成字段的方法之后，它们都会在此之后保持设置状态。 这是一组FIELD_COUNT布尔值，索引值为ERA到DST_OFFSET 。

• time

  protected long time

  此日历的当前设置时间，以1970年1月1日格林威治标准时间0:00:00之后的毫秒数表示。

  另请参见：

  isTimeSet

• isTimeSet

  protected boolean isTimeSet

  如果那么time的值有效time真。 通过更改项目field[]使时间无效。

  另请参见：

  time

• areFieldsSet

  protected boolean areFieldsSet

  如果fields[]与当前设置的时间同步， fields[] True。 如果为false，则下一次获取字段值的尝试将强制重新计算当前值time的所有字段。

构造方法详细信息

• Calendar

  protected Calendar()

  使用默认时区和默认的 FORMAT语言环境构造日历。

  另请参见：

  TimeZone.getDefault()

• Calendar

  protected Calendar​(TimeZone zone,
                     Locale aLocale)

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

  参数

  zone - 要使用的时区

  aLocale - 周数据的区域设置

方法详细信息

• getInstance

  public static Calendar getInstance()

  使用默认时区和区域设置获取日历。 返回的Calendar基于默认时区中的当前时间，默认为FORMAT语言环境。

  如果语言环境包含时区“tz” Unicode extension ，则使用该时区。

  结果

  日历。

• getInstance

  public static Calendar getInstance​(TimeZone zone)

  使用指定的时区和默认语言环境获取日历。 返回的Calendar基于给定时区中的当前时间，具有默认的FORMAT语言环境。

  参数

  zone - 要使用的时区

  结果

  日历。

• getInstance

  public static Calendar getInstance​(Locale aLocale)

  使用默认时区和指定的区域设置获取日历。 返回的Calendar基于具有给定语言环境的默认时区中的当前时间。

  如果区域设置包含时区“tz” Unicode extension ，则使用该时区。

  参数

  aLocale - 周数据的区域设置

  结果

  日历。

• getInstance

  public static Calendar getInstance​(TimeZone zone,
                                     Locale aLocale)

  获取具有指定时区和区域设置的日历。 返回的Calendar基于给定时区中具有给定语言环境的当前时间。

  参数

  zone - 要使用的时区

  aLocale - 周数据的区域设置

  结果

  日历。

• getAvailableLocales

  public static Locale[] getAvailableLocales()

  返回getInstance方法可以返回本地化实例的所有语言环境的数组。 返回的数组必须至少包含一个等于Locale.US的Locale实例。

  结果

  一组区域设置，其本地化的 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的时间值（距离 Epoch的毫秒偏移量）的 Date对象。

  结果

  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()

  以毫秒为单位返回此Calendar的时间值。

  结果

  从纪元开始的当前时间为UTC毫秒。

  另请参见：

  getTime() ， setTimeInMillis(long)

• setTimeInMillis

  public void setTimeInMillis​(long millis)

  从给定的long值设置此Calendar的当前时间。

  参数

  millis - 距离纪元的UTC毫秒的新时间。

  另请参见：

  setTime(Date) ， getTimeInMillis()

• get

  public int get​(int field)

  返回给定日历字段的值。 在宽松模式下，所有日历字段都已标准化。 在非宽松模式下，所有日历字段都经过验证，如果任何日历字段具有超出范围的值，则此方法将引发异常。 规范化和验证由complete()方法处理，该方法依赖于日历系统。

  参数

  字段 - 给定的日历字段。

  结果

  给定日历字段的值。

  异常

  ArrayIndexOutOfBoundsException - 如果指定的字段超出范围（ field < 0 || field >= FIELD_COUNT ）。

  另请参见：

  set(int,int) ， complete()

• internalGet

  protected final int internalGet​(int field)

  返回给定日历字段的值。 该方法不涉及字段值的标准化或验证。

  参数

  字段 - 给定的日历字段。

  结果

  给定日历字段的值。

  另请参见：

  get(int)

• set

  public void set​(int field,
                  int value)

  将给定的日历字段设置为给定值。 无论宽大模式如何，此方法都不会解释该值。

  参数

  字段 - 给定的日历字段。

  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表示1月份。

  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表示1月份。

  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表示1月份。

  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()

  设置此Calendar未定义的所有日历字段值和时间值（与Epoch的毫秒偏移量）。 这意味着isSet()将为所有日历字段返回false ，日期和时间计算将字段视为从未设置过。 Calendar实现类可以使用其特定的默认字段值进行日期/时间计算。 例如，如果YEAR字段值未定义，则GregorianCalendar使用1970。

  另请参见：

  clear(int)

• clear

  public final void clear​(int field)

  设置此Calendar undefined的给定日历字段值和时间值（距离Epoch的毫秒偏移量）。 这意味着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)重置小时值。

  参数

  字段 - 要清除的日历字段。

  另请参见：

  clear()

• isSet

  public final boolean isSet​(int field)

  确定给定的日历字段是否具有值集，包括由 get方法调用触发的内部字段计算设置的值的情况。

  参数

  字段 - 要测试的日历字段

  结果

  true如果给定的日历字段具有值集; 否则为false 。

• getDisplayName

  public String getDisplayName​(int field,
                               int style,
                               Locale locale)

  返回给定style和locale日历字段值的字符串表示locale 。 如果没有适用的字符串表示，则返回null 。 如果字符串表示适用于给定日历字段则此方法调用get(field)以获取日历字段值。

  例如，如果此Calendar是GregorianCalendar且其日期是2005-01-01，那么MONTH字段的字符串表示形式将是英语区域设置中的长样式中的“1月”或短样式中的“Jan”。 但是， DAY_OF_MONTH字段没有可用的字符串表示形式，此方法将返回null 。

  默认实现支持其中的日历字段DateFormatSymbols在给定的名字locale 。

  参数

  字段 - 返回字符串表示形式的日历字段

  style - 应用于字符串表示的样式; 之一SHORT_FORMAT （ SHORT ）， SHORT_STANDALONE ， LONG_FORMAT （ LONG ）， LONG_STANDALONE ， NARROW_FORMAT ，或NARROW_STANDALONE 。

  locale - 字符串表示的语言环境（由 locale指定的任何日历类型都将被忽略）

  结果

  给定 字段中给定 style字符串表示 style ，如果没有适用的字符串表示 style ， null 。

  异常

  IllegalArgumentException - 如果 字段或 style无效，或者此 Calendar不宽松且任何日历字段具有无效值

  NullPointerException - 如果 locale为空

  从以下版本开始：

  1.6

• getDisplayNames

  public Map<String,​Integer> getDisplayNames​(int field,
                                                   int style,
                                                   Locale locale)

  返回Map其中包含给定style和locale日历字段所有名称及其对应的字段值。 例如，如果此Calendar是GregorianCalendar ，则返回的地图将包含“Jan”到JANUARY ，“Feb”到FEBRUARY ，依此类推，在英语语言环境中的short样式中。

  由于使用单个字符，缩小的名称可能不是唯一的，例如星期日和星期六的“S”。 在这种情况下，缩小的名称不包括在返回的Map 。

  可以考虑其他日历字段的值以确定一组显示名称。 例如，如果此Calendar是阴阳历系统并且YEAR字段给出的年份值具有闰月，则此方法将返回包含闰月名称的月份名称，并且月份名称将映射到特定于年份的月份名称。

  默认实现支持DateFormatSymbols中包含的显示名称。 例如，如果字段是MONTH并且style是ALL_STYLES ，则此方法返回Map其中包含由DateFormatSymbols.getShortMonths()和DateFormatSymbols.getMonths()返回的所有字符串。

  参数

  字段 - 返回显示名称的日历字段

  style - 应用于字符串表示的样式; 之一SHORT_FORMAT （ SHORT ）， SHORT_STANDALONE ， LONG_FORMAT （ LONG ）， LONG_STANDALONE ， NARROW_FORMAT ，或NARROW_STANDALONE

  locale - 显示名称的语言环境

  结果

  一个 Map包含在所有显示名称 style和 locale和它们的字段值，或 null如果没有显示名称为定义 字段

  异常

  IllegalArgumentException - 如果 字段或 style无效，或者此 Calendar不宽松且任何日历字段具有无效值

  NullPointerException - 如果 locale为空

  从以下版本开始：

  1.6

• complete

  protected void complete()

  填写日历字段中的任何未设置字段。 首先，如果尚未根据日历字段值计算时间值（距离Epoch的毫秒偏移量），则调用computeTime()方法。 然后，调用computeFields()方法来计算所有日历字段值。

• getAvailableCalendarTypes

  public static Set<String> getAvailableCalendarTypes()

  返回不可修改的Set其中包含运行时环境中Calendar支持的所有日历类型。 可用的日历类型可用于Unicode locale extensions 。 返回的Set包含至少"gregory" 。 日历类型不包含别名，例如"gregorian" （ "gregory" 。

  结果

  包含所有可用日历类型的不可修改的 Set

  从以下版本开始：

  1.8

  另请参见：

  getCalendarType() ， Calendar.Builder.setCalendarType(String) ， Locale.getUnicodeLocaleType(String)

• getCalendarType

  public String getCalendarType()

  返回此Calendar的日历类型。 日历类型由Unicode区域设置数据标记语言（LDML）规范定义。

  此方法的默认实现返回此Calendar实例的类名。 实现LDML定义的日历系统的任何子类都应覆盖此方法以返回适当的日历类型。

  结果

  LDML定义的日历类型或此 Calendar实例的类名

  从以下版本开始：

  1.8

  另请参见：

  Locale extensions ， Locale.Builder.setLocale(Locale) ， Locale.Builder.setUnicodeLocaleKeyword(String, String)

• equals

  public boolean equals​(Object obj)

  将此Calendar与指定的Object 。 当且仅当参数是同一日历系统的Calendar对象时，结果为true ，该对象表示与此对象相同的Calendar参数下的相同时间值（距离Epoch的毫秒偏移）。

  的Calendar参数是由表示的值isLenient ， getFirstDayOfWeek ， getMinimalDaysInFirstWeek和getTimeZone方法。 如果两个Calendar之间的参数有任何差异，则此方法返回false 。

  使用compareTo方法仅比较时间值。

  重写：

  equals类 Object

  参数

  obj - 要与之比较的对象。

  结果

  true如果此对象等于obj ; 否则为false 。

  另请参见：

  Object.hashCode() ， HashMap

• hashCode

  public int hashCode()

  返回此日历的哈希码。

  重写：

  hashCode ，类 Object

  结果

  此对象的哈希码值。

  从以下版本开始：

  1.2

  另请参见：

  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于when表示的时间; 否则为false 。

  另请参见：

  compareTo(Calendar)

• compareTo

  public int compareTo​(Calendar anotherCalendar)

  比较两个 Calendar对象表示的时间值（从 Epoch开始的毫秒偏移）。

  Specified by:

  compareTo in interface Comparable<Calendar>

  参数

  anotherCalendar - 待比较的 Calendar 。

  结果

  值0如果由所述参数表示的时间等于由此表示的时间Calendar ; 如果此Calendar的时间早于参数所代表的时间，则该值小于0 ; 如果此Calendar的时间在参数表示的时间之后，则值大于0 。

  异常

  NullPointerException - 如果指定的 Calendar是 null 。

  IllegalArgumentException - 如果由于任何无效的日历值而无法获取指定的 Calendar对象的时间值。

  从以下版本开始：

  1.5

• add

  public abstract void add​(int field,
                           int amount)

  根据日历的规则，将指定的时间量添加或减去给定的日历字段。 例如，要从日历的当前时间减去5天，您可以通过调用以下方法来实现：

  add(Calendar.DAY_OF_MONTH, -5) 。

  参数

  字段 - 日历字段。

  amount - 要添加到字段中的日期或时间量。

  另请参见：

  roll(int,int) ， set(int,int)

• roll

  public abstract void roll​(int field,
                            boolean up)

  在给定时间字段上添加或减去（向上/向下）单个时间单位而不更改更大的字段。 例如，要将当前日期提前一天，您可以通过调用以下方式实现：

  roll（Calendar.DATE，true）。 在年份或Calendar.YEAR字段上滚动时，它将滚动年份值，范围介于1和通过调用getMaximum(Calendar.YEAR)返回的值之间。 在月份或Calendar.MONTH字段上滚动时，其他字段（如日期）可能会发生冲突，需要更改。 例如，在01/31/96日期滚动月份将导致02/29/96。 在小时或Calendar.HOUR_OF_DAY字段上滚动时，它将在0到23之间的范围内滚动小时值，该值从零开始。

  参数

  字段 - 时间字段。

  up - 指示是否要汇总或滚动指定时间字段的值。 如果滚动则使用true，否则使用false。

  另请参见：

  add(int,int) ， set(int,int)

• roll

  public void roll​(int field,
                   int amount)

  将指定的（已签名）金额添加到指定的日历字段，而不更改更大的字段。 负数表示向下滚动。

  注意： Calendar上的此默认实现仅重复调用以一个单位滚动的版本roll() 。 这可能并不总是做正确的事情。 例如，如果DAY_OF_MONTH字段为31，则滚动到2月将其设置为28.此函数的GregorianCalendar版本可以解决此问题。 其他子类也应提供此功能的覆盖，以做正确的事情。

  参数

  字段 - 日历字段。

  amount - 要添加到日历 字段的签名金额。

  从以下版本开始：

  1.2

  另请参见：

  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)

  指定日期/时间解释是否宽松。 通过宽松的解释，诸如“1996年2月942”之类的日期将被视为等同于1996年2月1日之后的第941天。通过严格（非宽松）的解释，这样的日期将导致例外被抛出。 默认值是宽松的。

  参数

  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 。

  从以下版本开始：

  1.7

  另请参见：

  getWeekYear() ， setWeekDate(int,int,int) ， getWeeksInWeekYear()

• getWeekYear

  public int getWeekYear()

  返回此Calendar表示的Calendar 。 周年与周周期同步。 first day of the first week是一周的第一天。

  此方法的默认实现抛出UnsupportedOperationException 。

  结果

  这个 Calendar的这 Calendar

  异常

  UnsupportedOperationException - 如果此 Calendar不支持任何周年编号。

  从以下版本开始：

  1.7

  另请参见：

  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不支持任何周年编号。

  从以下版本开始：

  1.7

  另请参见：

  isWeekDateSupported() ， getFirstDayOfWeek() ， getMinimalDaysInFirstWeek()

• getWeeksInWeekYear

  public int getWeeksInWeekYear()

  返回此Calendar表示的周年中的周Calendar 。

  此方法的默认实现抛出UnsupportedOperationException 。

  结果

  一周中的周数。

  异常

  UnsupportedOperationException - 如果此 Calendar不支持任何周年编号。

  从以下版本开始：

  1.7

  另请参见：

  WEEK_OF_YEAR ， isWeekDateSupported() ， getWeekYear() ， getActualMaximum(int)

• getMinimum

  public abstract int getMinimum​(int field)

  返回此Calendar实例的给定日历字段的Calendar 。 最小值定义为get方法为任何可能的时间值返回的最小值。 最小值取决于实例的日历系统特定参数。

  参数

  字段 - 日历字段。

  结果

  给定日历字段的最小值。

  另请参见：

  getMaximum(int) ， getGreatestMinimum(int) ， getLeastMaximum(int) ， getActualMinimum(int) ， getActualMaximum(int)

• getMaximum

  public abstract int getMaximum​(int field)

  返回此Calendar实例的给定日历字段的Calendar 。 最大值定义为get方法为任何可能的时间值返回的最大值。 最大值取决于实例的日历系统特定参数。

  参数

  字段 - 日历字段。

  结果

  给定日历字段的最大值。

  另请参见：

  getMinimum(int) ， getGreatestMinimum(int) ， getLeastMaximum(int) ， getActualMinimum(int) ， getActualMaximum(int)

• getGreatestMinimum

  public abstract int getGreatestMinimum​(int field)

  返回此Calendar实例的给定日历字段的最高最小值。 最高最小值定义为getActualMinimum(int)为任何可能的时间值返回的最大值。 最大的最小值取决于实例的日历系统特定参数。

  参数

  字段 - 日历字段。

  结果

  给定日历字段的最小最小值。

  另请参见：

  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领域，由于28日是这个日历，二月在一个共同的一年中最短的月份的最后一天。

  参数

  字段 - 日历字段。

  结果

  给定日历字段的最小最大值。

  另请参见：

  getMinimum(int) ， getMaximum(int) ， getGreatestMinimum(int) ， getActualMinimum(int) ， getActualMaximum(int)

• getActualMinimum

  public int getActualMinimum​(int field)

  给定此Calendar的时间值，返回指定日历字段可能具有的Calendar 。

  此方法的默认实现使用迭代算法来确定日历字段的实际最小值。 如果可能，子类应该使用更有效的实现来覆盖它 - 在许多情况下，它们可以简单地返回getMinimum() 。

  参数

  字段 - 日历字段

  结果

  此 Calendar的时间值的给定日历字段的 Calendar

  从以下版本开始：

  1.2

  另请参见：

  getMinimum(int) ， getMaximum(int) ， getGreatestMinimum(int) ， getLeastMaximum(int) ， getActualMaximum(int)

• getActualMaximum

  public int getActualMaximum​(int field)

  给定此Calendar的时间值，返回指定日历字段可能具有的Calendar 。 例如， MONTH字段的实际最大值在某些年份为12，在希伯来日历系统中为其他年份的13。

  此方法的默认实现使用迭代算法来确定日历字段的实际最大值。 如果可能，子类应该使用更有效的实现来覆盖它。

  参数

  字段 - 日历字段

  结果

  此 Calendar的时间值的给定日历字段的 Calendar

  从以下版本开始：

  1.2

  另请参见：

  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相同的点。

  结果

  表示时间线上相同点的瞬间

  从以下版本开始：

  1.8