HebrewCalendar

java.lang.Object
- ohos.global.icu.util.Calendar
- - ohos.global.icu.util.HebrewCalendar

所有已实现的接口:

Serializable, Cloneable, Comparable<Calendar>
```
public class HebrewCalendar
extends Calendar
```
HebrewCalendar is a subclass of Calendar that that implements the traditional Hebrew calendar. This is the civil calendar in Israel and the liturgical calendar of the Jewish faith worldwide.
The Hebrew calendar is lunisolar and thus has a number of interesting properties that distinguish it from the Gregorian. Months start on the day of (an arithmetic approximation of) each new moon. Since the solar year (approximately 365.24 days) is not an even multiple of the lunar month (approximately 29.53 days) an extra "leap month" is inserted in 7 out of every 19 years. To make matters even more interesting, the start of a year can be delayed by up to three days in order to prevent certain holidays from falling on the Sabbath and to prevent certain illegal year lengths. Finally, the lengths of certain months can vary depending on the number of days in the year.
The leap month is known as "Adar 1" and is inserted between the months of Shevat and Adar in leap years. Since the leap month does not come at the end of the year, calculations involving month numbers are particularly complex. Users of this class should make sure to use the roll and add methods rather than attempting to perform date arithmetic by manipulating the fields directly.
Note: In the traditional Hebrew calendar, days start at sunset. However, in order to keep the time fields in this class synchronized with those of the other calendars and with local clock time, we treat days and months as beginning at midnight, roughly 6 hours after the corresponding sunset.
If you are interested in more information on the rules behind the Hebrew calendar, see one of the following references:
- "Calendrical Calculations", by Nachum Dershowitz & Edward Reingold, Cambridge University Press, 1997, pages 85-91.
- Hebrew Calendar Science and Myths, http://web.archive.org/web/20090423084613/http://www.geocities.com/Athens/1584/
- The Calendar FAQ, http://www.faqs.org/faqs/calendars/faq/
This class should not be subclassed.

HebrewCalendar usually should be instantiated using Calendar.getInstance(ULocale) passing in a ULocale with the tag "@calendar=hebrew".
另请参阅:

GregorianCalendar, Calendar, 序列化表格

嵌套类概要
- 从类继承的嵌套类/接口 ohos.global.icu.util.Calendar
  Calendar.WeekData

字段概要

字段
限定符和类型	字段	说明
`static int`	`ADAR`	Constant for the Adar, the 7th month of the Hebrew year.
`static int`	`ADAR_1`	Constant for Adar I, the 6th month of the Hebrew year (present in leap years only).
`static int`	`AV`	Constant for Av, the 12th month of the Hebrew year.
`static int`	`ELUL`	Constant for Elul, the 13th month of the Hebrew year.
`static int`	`HESHVAN`	Constant for Heshvan, the 2nd month of the Hebrew year.
`static int`	`IYAR`	Constant for Iyar, the 9th month of the Hebrew year.
`static int`	`KISLEV`	Constant for Kislev, the 3rd month of the Hebrew year.
`static int`	`NISAN`	Constant for Nisan, the 8th month of the Hebrew year.
`static int`	`SHEVAT`	Constant for Shevat, the 5th month of the Hebrew year.
`static int`	`SIVAN`	Constant for Sivan, the 10th month of the Hebrew year.
`static int`	`TAMUZ`	Constant for Tammuz, the 11th month of the Hebrew year.
`static int`	`TEVET`	Constant for Tevet, the 4th month of the Hebrew year.
`static int`	`TISHRI`	Constant for Tishri, the 1st month of the Hebrew year.

从类继承的字段 ohos.global.icu.util.Calendar
AM, AM_PM, APRIL, AUGUST, BASE_FIELD_COUNT, DATE, DAY_OF_MONTH, DAY_OF_WEEK, DAY_OF_WEEK_IN_MONTH, DAY_OF_YEAR, DECEMBER, DOW_LOCAL, DST_OFFSET, EPOCH_JULIAN_DAY, ERA, EXTENDED_YEAR, FEBRUARY, FRIDAY, GREATEST_MINIMUM, HOUR, HOUR_OF_DAY, INTERNALLY_SET, IS_LEAP_MONTH, JAN_1_1_JULIAN_DAY, JANUARY, JULIAN_DAY, JULY, JUNE, LEAST_MAXIMUM, MARCH, MAX_DATE, MAX_FIELD_COUNT, MAX_JULIAN, MAX_MILLIS, MAXIMUM, MAY, MILLISECOND, MILLISECONDS_IN_DAY, MIN_DATE, MIN_JULIAN, MIN_MILLIS, MINIMUM, MINIMUM_USER_STAMP, MINUTE, MONDAY, MONTH, NOVEMBER, OCTOBER, ONE_DAY, ONE_HOUR, ONE_MINUTE, ONE_SECOND, ONE_WEEK, PM, RESOLVE_REMAP, SATURDAY, SECOND, SEPTEMBER, SUNDAY, THURSDAY, TUESDAY, UNDECIMBER, UNSET, WALLTIME_FIRST, WALLTIME_LAST, WALLTIME_NEXT_VALID, WEDNESDAY, WEEK_OF_MONTH, WEEK_OF_YEAR, YEAR, YEAR_WOY, ZONE_OFFSET

构造器概要

构造器
构造器	说明
`HebrewCalendar()`	Constructs a default `HebrewCalendar` using the current time in the default time zone with the default `FORMAT` locale.
`HebrewCalendar(int year, int month, int date)`	Constructs a `HebrewCalendar` with the given date set in the default time zone with the default `FORMAT` locale.
`HebrewCalendar(int year, int month, int date, int hour, int minute, int second)`	Constructs a `HebrewCalendar` with the given date and time set for the default time zone with the default `FORMAT` locale.
`HebrewCalendar(Date date)`	Constructs a `HebrewCalendar` with the given date set in the default time zone with the default `FORMAT` locale.
`HebrewCalendar(Locale aLocale)`	Constructs a `HebrewCalendar` based on the current time in the default time zone with the given locale.
`HebrewCalendar(TimeZone zone)`	Constructs a `HebrewCalendar` based on the current time in the given time zone with the default `FORMAT` locale.
`HebrewCalendar(TimeZone zone, Locale aLocale)`	Constructs a `HebrewCalendar` based on the current time in the given time zone with the given locale.
`HebrewCalendar(TimeZone zone, ULocale locale)`	Constructs a `HebrewCalendar` based on the current time in the given time zone with the given locale.
`HebrewCalendar(ULocale locale)`	Constructs a `HebrewCalendar` based on the current time in the default time zone with the given locale.

方法概要

所有方法实例方法具体方法已过时的方法
限定符和类型	方法	说明
`void`	`add(int field, int amount)`	Add a signed amount to a specified field, using this calendar's rules.
`String`	`getType()`	[icu] Returns the calendar type name string for this Calendar object.
`protected void`	`handleComputeFields(int julianDay)`	Subclasses may override this method to compute several fields specific to each calendar system.
`protected int`	`handleComputeMonthStart(int eyear, int month, boolean useMonth)`	Return JD of start of given month/year.
`protected int`	`handleGetExtendedYear()`	Returns the extended year defined by the current fields.
`protected int`	`handleGetLimit(int field, int limitType)`	Subclass API for defining limits of different types.
`protected int`	`handleGetMonthLength(int extendedYear, int month)`	Returns the length of the given month in the given year
`protected int`	`handleGetYearLength(int eyear)`	Returns the number of days in the given Hebrew year
`void`	`roll(int field, int amount)`	Rolls (up/down) a specified amount time on the given field.
`protected void`	`validateField(int field)`	已过时。 This API is ICU internal only.

从类继承的方法 ohos.global.icu.util.Calendar
after, before, clear, clear, clone, compareTo, complete, computeFields, computeGregorianFields, computeGregorianMonthStart, computeJulianDay, computeMillisInDay, computeTime, computeZoneOffset, equals, fieldDifference, fieldName, floorDivide, floorDivide, floorDivide, floorDivide, get, getActualMaximum, getActualMinimum, getAvailableLocales, getDateTimeFormat, getDateTimeFormat, getDisplayName, getDisplayName, getFieldCount, getFieldResolutionTable, getFirstDayOfWeek, getGreatestMinimum, getGregorianDayOfMonth, getGregorianDayOfYear, getGregorianMonth, getGregorianYear, getInstance, getInstance, getInstance, getInstance, getInstance, getInstance, getKeywordValuesForLocale, getLeastMaximum, getLimit, getMaximum, getMinimalDaysInFirstWeek, getMinimum, getRepeatedWallTimeOption, getSkippedWallTimeOption, getStamp, getTime, getTimeInMillis, getTimeZone, getWeekData, getWeekDataForRegion, gregorianMonthLength, gregorianPreviousMonthLength, handleComputeJulianDay, handleCreateFields, handleGetDateFormat, handleGetDateFormat, handleGetDateFormat, hashCode, internalGet, internalGet, internalGetTimeInMillis, internalSet, isEquivalentTo, isGregorianLeapYear, isLenient, isSet, isWeekend, isWeekend, julianDayToDayOfWeek, julianDayToMillis, millisToJulianDay, newerField, newestStamp, pinField, prepareGetActual, resolveFields, roll, set, set, set, set, setFirstDayOfWeek, setLenient, setMinimalDaysInFirstWeek, setRepeatedWallTimeOption, setSkippedWallTimeOption, setTime, setTimeInMillis, setTimeZone, setWeekData, toString, validateField, validateFields, weekNumber, weekNumber

从类继承的方法 java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

- 字段详细资料
  - ADAR
```
public static final int ADAR
```
    Constant for the Adar, the 7th month of the Hebrew year.
    
    另请参阅:
    
    常量字段值
  - ADAR_1
```
public static final int ADAR_1
```
    Constant for Adar I, the 6th month of the Hebrew year (present in leap years only). In non-leap years, the calendar jumps from Shevat (5th month) to Adar (7th month).
    
    另请参阅:
    
    常量字段值
  - AV
```
public static final int AV
```
    Constant for Av, the 12th month of the Hebrew year.
    
    另请参阅:
    
    常量字段值
  - ELUL
```
public static final int ELUL
```
    Constant for Elul, the 13th month of the Hebrew year.
    
    另请参阅:
    
    常量字段值
  - HESHVAN
```
public static final int HESHVAN
```
    Constant for Heshvan, the 2nd month of the Hebrew year.
    
    另请参阅:
    
    常量字段值
  - IYAR
```
public static final int IYAR
```
    Constant for Iyar, the 9th month of the Hebrew year.
    
    另请参阅:
    
    常量字段值
  - KISLEV
```
public static final int KISLEV
```
    Constant for Kislev, the 3rd month of the Hebrew year.
    
    另请参阅:
    
    常量字段值
  - NISAN
```
public static final int NISAN
```
    Constant for Nisan, the 8th month of the Hebrew year.
    
    另请参阅:
    
    常量字段值
  - SHEVAT
```
public static final int SHEVAT
```
    Constant for Shevat, the 5th month of the Hebrew year.
    
    另请参阅:
    
    常量字段值
  - SIVAN
```
public static final int SIVAN
```
    Constant for Sivan, the 10th month of the Hebrew year.
    
    另请参阅:
    
    常量字段值
  - TAMUZ
```
public static final int TAMUZ
```
    Constant for Tammuz, the 11th month of the Hebrew year.
    
    另请参阅:
    
    常量字段值
  - TEVET
```
public static final int TEVET
```
    Constant for Tevet, the 4th month of the Hebrew year.
    
    另请参阅:
    
    常量字段值
  - TISHRI
```
public static final int TISHRI
```
    Constant for Tishri, the 1st month of the Hebrew year.
    
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - HebrewCalendar
```
public HebrewCalendar()
```
    Constructs a default HebrewCalendar using the current time in the default time zone with the default FORMAT locale.
    
    另请参阅:
    
    ULocale.Category.FORMAT
  - HebrewCalendar
```
public HebrewCalendar(TimeZone zone)
```
    Constructs a HebrewCalendar based on the current time in the given time zone with the default FORMAT locale.
    
    参数:
    
    zone - The time zone for the new calendar.
    
    另请参阅:
    
    ULocale.Category.FORMAT
  - HebrewCalendar
```
public HebrewCalendar(Locale aLocale)
```
    Constructs a HebrewCalendar based on the current time in the default time zone with the given locale.
    
    参数:
    
    aLocale - The locale for the new calendar.
  - HebrewCalendar
```
public HebrewCalendar(ULocale locale)
```
    Constructs a HebrewCalendar based on the current time in the default time zone with the given locale.
    
    参数:
    
    locale - The locale for the new calendar.
  - HebrewCalendar
```
public HebrewCalendar(TimeZone zone,
                      Locale aLocale)
```
    Constructs a HebrewCalendar based on the current time in the given time zone with the given locale.
    
    参数:
    
    zone - The time zone for the new calendar.
    
    aLocale - The locale for the new calendar.
  - HebrewCalendar
```
public HebrewCalendar(TimeZone zone,
                      ULocale locale)
```
    Constructs a HebrewCalendar based on the current time in the given time zone with the given locale.
    
    参数:
    
    zone - The time zone for the new calendar.
    
    locale - The locale for the new calendar.
  - HebrewCalendar
```
public HebrewCalendar(int year,
                      int month,
                      int date)
```
    Constructs a HebrewCalendar with the given date set in the default time zone with the default FORMAT locale.
    
    参数:
    
    year - The value used to set the calendar's YEAR time field.
    
    month - The value used to set the calendar's MONTH time field. The value is 0-based. e.g., 0 for Tishri.
    
    date - The value used to set the calendar's DATE time field.
    
    另请参阅:
    
    ULocale.Category.FORMAT
  - HebrewCalendar
```
public HebrewCalendar(Date date)
```
    Constructs a HebrewCalendar with the given date set in the default time zone with the default FORMAT locale.
    
    参数:
    
    date - The date to which the new calendar is set.
    
    另请参阅:
    
    ULocale.Category.FORMAT
  - HebrewCalendar
```
public HebrewCalendar(int year,
                      int month,
                      int date,
                      int hour,
                      int minute,
                      int second)
```
    Constructs a HebrewCalendar with the given date and time set for the default time zone with the default FORMAT locale.
    
    参数:
    
    year - The value used to set the calendar's YEAR time field.
    
    month - The value used to set the calendar's MONTH time field. The value is 0-based. e.g., 0 for Tishri.
    
    date - The value used to set the calendar's DATE time field.
    
    hour - The value used to set the calendar's HOUR_OF_DAY time field.
    
    minute - The value used to set the calendar's MINUTE time field.
    
    second - The value used to set the calendar's SECOND time field.
    
    另请参阅:
    
    ULocale.Category.FORMAT
- 方法详细资料
  - add
```
public void add(int field,
                int amount)
```
    Add a signed amount to a specified field, using this calendar's rules. For example, to add three days to the current date, you can call add(Calendar.DATE, 3).
    When adding to certain fields, the values of other fields may conflict and need to be changed. For example, when adding one to the MONTH field for the date "30 Av 5758", the DAY_OF_MONTH field must be adjusted so that the result is "29 Elul 5758" rather than the invalid "30 Elul 5758".
    This method is able to add to all fields except for ERA, DST_OFFSET, and ZONE_OFFSET.
    Note: You should always use roll and add rather than attempting to perform arithmetic operations directly on the fields of a HebrewCalendar. Since the MONTH field behaves discontinuously in non-leap years, simple arithmetic can give invalid results.
    
    覆盖:
    
    add 在类中 Calendar
    
    参数:
    
    field - the time field.
    
    amount - the amount to add to the field.
    
    抛出:
    
    IllegalArgumentException - if the field is invalid or refers to a field that cannot be handled by this method.
    
    另请参阅:
    
    Calendar.roll(int, int)
  - roll
```
public void roll(int field,
                 int amount)
```
    Rolls (up/down) a specified amount time on the given field. For example, to roll the current date up by three days, you can call roll(Calendar.DATE, 3). If the field is rolled past its maximum allowable value, it will "wrap" back to its minimum and continue rolling. For example, calling roll(Calendar.DATE, 10) on a Hebrew calendar set to "25 Av 5758" will result in the date "5 Av 5758".
    When rolling certain fields, the values of other fields may conflict and need to be changed. For example, when rolling the MONTH field upward by one for the date "30 Av 5758", the DAY_OF_MONTH field must be adjusted so that the result is "29 Elul 5758" rather than the invalid "30 Elul".
    This method is able to roll all fields except for ERA, DST_OFFSET, and ZONE_OFFSET. Subclasses may, of course, add support for additional fields in their overrides of roll.
    Note: You should always use roll and add rather than attempting to perform arithmetic operations directly on the fields of a HebrewCalendar. Since the MONTH field behaves discontinuously in non-leap years, simple arithmetic can give invalid results.
    
    覆盖:
    
    roll 在类中 Calendar
    
    参数:
    
    field - the time field.
    
    amount - the amount by which the field should be rolled.
    
    抛出:
    
    IllegalArgumentException - if the field is invalid or refers to a field that cannot be handled by this method.
    
    另请参阅:
    
    Calendar.roll(int, boolean), Calendar.add(int, int)
  - handleGetLimit
```
protected int handleGetLimit(int field,
                             int limitType)
```
    从类复制的说明: Calendar
    Subclass API for defining limits of different types. Subclasses must implement this method to return limits for the following fields:
```
ERA
 YEAR
 MONTH
 WEEK_OF_YEAR
 WEEK_OF_MONTH
 DAY_OF_MONTH
 DAY_OF_YEAR
 DAY_OF_WEEK_IN_MONTH
 YEAR_WOY
 EXTENDED_YEAR
```
    指定者:
    
    handleGetLimit 在类中 Calendar
    
    参数:
    
    field - one of the above field numbers
    
    limitType - one of MINIMUM, GREATEST_MINIMUM, LEAST_MAXIMUM, or MAXIMUM
  - handleGetMonthLength
```
protected int handleGetMonthLength(int extendedYear,
                                   int month)
```
    Returns the length of the given month in the given year
    
    覆盖:
    
    handleGetMonthLength 在类中 Calendar
  - handleGetYearLength
```
protected int handleGetYearLength(int eyear)
```
    Returns the number of days in the given Hebrew year
    
    覆盖:
    
    handleGetYearLength 在类中 Calendar
  - validateField
```
@Deprecated
protected void validateField(int field)
```
    已过时。 This API is ICU internal only.
    
    Validate a single field of this calendar. Subclasses should override this method to validate any calendar-specific fields. Generic fields can be handled by Calendar.validateField().
    Overrides Calendar#validateField(int) to provide special handling for month validation for Hebrew calendar.
    
    覆盖:
    
    validateField 在类中 Calendar
    
    另请参阅:
    
    Calendar.validateField(int, int, int)
  - handleComputeFields
```
protected void handleComputeFields(int julianDay)
```
    Subclasses may override this method to compute several fields specific to each calendar system. These are:
    - ERA
    - YEAR
    - MONTH
    - DAY_OF_MONTH
    - DAY_OF_YEAR
    - EXTENDED_YEAR
    Subclasses can refer to the DAY_OF_WEEK and DOW_LOCAL fields, which will be set when this method is called. Subclasses can also call the getGregorianXxx() methods to obtain Gregorian calendar equivalents for the given Julian day.
    In addition, subclasses should compute any subclass-specific fields, that is, fields from BASE_FIELD_COUNT to getFieldCount() - 1.
    覆盖:
    
    handleComputeFields 在类中 Calendar
  - handleGetExtendedYear
```
protected int handleGetExtendedYear()
```
    从类复制的说明: Calendar
    
    Returns the extended year defined by the current fields. This will use the EXTENDED_YEAR field or the YEAR and supra-year fields (such as ERA) specific to the calendar system, depending on which set of fields is newer.
    
    指定者:
    
    handleGetExtendedYear 在类中 Calendar
    
    返回:
    
    the extended year
  - handleComputeMonthStart
```
protected int handleComputeMonthStart(int eyear,
                                      int month,
                                      boolean useMonth)
```
    Return JD of start of given month/year.
    
    指定者:
    
    handleComputeMonthStart 在类中 Calendar
    
    参数:
    
    eyear - the extended year
    
    month - the zero-based month, or 0 if useMonth is false
    
    useMonth - if false, compute the day before the first day of the given year, otherwise, compute the day before the first day of the given month
    
    返回:
    
    the Julian day number of the day before the first day of the given month and year
  - getType
```
public String getType()
```
    [icu] Returns the calendar type name string for this Calendar object. The returned string is the legacy ICU calendar attribute value, for example, "gregorian" or "japanese".
    See type="old type name" for the calendar attribute of locale IDs at http://www.unicode.org/reports/tr35/#Key_Type_Definitions
    
    覆盖:
    
    getType 在类中 Calendar
    
    返回:
    
    legacy calendar type name string

类 HebrewCalendar

嵌套类概要

从类继承的嵌套类/接口 ohos.global.icu.util.Calendar

字段概要

从类继承的字段 ohos.global.icu.util.Calendar

构造器概要

方法概要

从类继承的方法 ohos.global.icu.util.Calendar

从类继承的方法 java.lang.Object

字段详细资料

ADAR

ADAR_1

AV

ELUL

HESHVAN

IYAR

KISLEV

NISAN

SHEVAT

SIVAN

TAMUZ

TEVET

TISHRI

构造器详细资料

HebrewCalendar

HebrewCalendar

HebrewCalendar

HebrewCalendar

HebrewCalendar

HebrewCalendar

HebrewCalendar

HebrewCalendar

HebrewCalendar

方法详细资料

add

roll

handleGetLimit

handleGetMonthLength

handleGetYearLength

validateField

handleComputeFields

handleGetExtendedYear

handleComputeMonthStart

getType