International Components for Unicode for Java (icu4j) 74.2 · com.ibm.icu.util.HebrewCalendar

Field Summary

Modifier and Type	Field and Description
public static final int	ADAR Constant for the Adar, the 7th month of the Hebrew year.
public static final int	ADAR_1 Constant for Adar I, the 6th month of the Hebrew year (present in leap years only).
public static final int	AV Constant for Av, the 12th month of the Hebrew year.
private static final long	BAHARAD
private static CalendarCache	cache
private static final long	DAY_PARTS
public static final int	ELUL Constant for Elul, the 13th month of the Hebrew year.
private static String[]	gTemporalMonthCodesForHebrew
public static final int	HESHVAN Constant for Heshvan, the 2nd month of the Hebrew year.
private static final long	HOUR_PARTS
public static final int	IYAR Constant for Iyar, the 9th month of the Hebrew year.
public static final int	KISLEV Constant for Kislev, the 3rd month of the Hebrew year.
private static final int[][]	LEAP_MONTH_START The cumulative # of days to the end of each month in a leap year
private static final int[][]	LIMITS Hides com.ibm.icu.util.Calendar.LIMITS. The absolute date, in milliseconds since 1/1/1970 AD, Gregorian, of the start of the Hebrew calendar.
private static final int	MONTH_DAYS
private static final long	MONTH_FRACT
private static final int[][]	MONTH_LENGTH The lengths of the Hebrew months.
private static final long	MONTH_PARTS
private static final int[][]	MONTH_START The cumulative # of days to the end of each month in a non-leap year Although this can be calculated from the MONTH_LENGTH table, keeping it around separately makes some calculations a lot faster
public static final int	NISAN Constant for Nisan, the 8th month of the Hebrew year.
private static final long	serialVersionUID Hides com.ibm.icu.util.Calendar.serialVersionUID.
public static final int	SHEVAT Constant for Shevat, the 5th month of the Hebrew year.
public static final int	SIVAN Constant for Sivan, the 10th month of the Hebrew year.
public static final int	TAMUZ Constant for Tammuz, the 11th month of the Hebrew year.
public static final int	TEVET Constant for Tevet, the 4th month of the Hebrew year.
public static final int	TISHRI Constant for Tishri, the 1st month of the Hebrew year.

Constructor Summary

Access	Constructor and Description
public	HebrewCalendar() Constructs a default `HebrewCalendar` using the current time in the default time zone with the default `FORMAT` locale.
public	HebrewCalendar(TimeZone The time zone for the new calendar. zone) Constructs a `HebrewCalendar` based on the current time in the given time zone with the default `FORMAT` locale.
public	HebrewCalendar(Locale The locale for the new calendar. aLocale) Constructs a `HebrewCalendar` based on the current time in the default time zone with the given locale.
public	HebrewCalendar(ULocale The locale for the new calendar. locale) Constructs a `HebrewCalendar` based on the current time in the default time zone with the given locale.
public	HebrewCalendar(TimeZone The time zone for the new calendar. zone, Locale The locale for the new calendar. aLocale) Constructs a `HebrewCalendar` based on the current time in the given time zone with the given locale.
public	HebrewCalendar(TimeZone The time zone for the new calendar. zone, ULocale The locale for the new calendar. locale) Constructs a `HebrewCalendar` based on the current time in the given time zone with the given locale.
public	HebrewCalendar(int The value used to set the calendar's `YEAR` time field. year, int The value used to set the calendar's `MONTH` time field. The value is 0-based. e.g., 0 for Tishri. month, int The value used to set the calendar's `DATE` time field. date) Constructs a `HebrewCalendar` with the given date set in the default time zone with the default `FORMAT` locale.
public	HebrewCalendar(Date The date to which the new calendar is set. date) Constructs a `HebrewCalendar` with the given date set in the default time zone with the default `FORMAT` locale.
public	HebrewCalendar(int The value used to set the calendar's `YEAR` time field. year, int The value used to set the calendar's `MONTH` time field. The value is 0-based. e.g., 0 for Tishri. month, int The value used to set the calendar's `DATE` time field. date, int The value used to set the calendar's `HOUR_OF_DAY` time field. hour, int The value used to set the calendar's `MINUTE` time field. minute, int The value used to set the calendar's `SECOND` time field. second) Constructs a `HebrewCalendar` with the given date and time set for the default time zone with the default `FORMAT` locale.

Method Summary

Modifier and Type	Method and Description
public void	add(int the time field. field, int the amount to add to the field. amount) Overrides com.ibm.icu.util.Calendar.add. Add a signed amount to a specified field, using this calendar's rules.
public String	Returns: One of 13 possible strings in {"M01".. "M05", "M05L", "M06" .. "M12"}. getTemporalMonthCode() Overrides com.ibm.icu.util.Calendar.getTemporalMonthCode. Gets The Temporal monthCode value corresponding to the month for the date.
public String	getType() Overrides com.ibm.icu.util.Calendar.getType. ICU
protected void	handleComputeFields(int julianDay) Overrides com.ibm.icu.util.Calendar.handleComputeFields. Subclasses may override this method to compute several fields specific to each calendar system.
protected int	handleComputeMonthStart(int the extended year eyear, int the zero-based month, or 0 if useMonth is false month, boolean 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 useMonth) Implements abstract com.ibm.icu.util.Calendar.handleComputeMonthStart. Return JD of start of given month/year.
protected int	handleGetExtendedYear() Implements abstract com.ibm.icu.util.Calendar.handleGetExtendedYear. Returns the extended year defined by the current fields.
protected int	handleGetLimit(int one of the above field numbers field, int one of `MINIMUM`, `GREATEST_MINIMUM`, `LEAST_MAXIMUM`, or `MAXIMUM` limitType) Implements abstract com.ibm.icu.util.Calendar.handleGetLimit. Subclass API for defining limits of different types.
protected int	handleGetMonthLength(int extendedYear, int month) Overrides com.ibm.icu.util.Calendar.handleGetMonthLength. Returns the length of the given month in the given year
protected int	handleGetYearLength(int eyear) Overrides com.ibm.icu.util.Calendar.handleGetYearLength. Returns the number of days in the given Hebrew year
public boolean	inTemporalLeapYear() Overrides com.ibm.icu.util.Calendar.inTemporalLeapYear. ICU
protected int	internalGetMonth() Overrides com.ibm.icu.util.Calendar.internalGetMonth. Deprecated This API is ICU internal only. Use this function instead of internalGet(MONTH).
public static boolean	isLeapYear(int year) Deprecated This API is ICU internal only. Determine whether a given Hebrew year is a leap year The rule here is that if (year % 19) == 0, 3, 6, 8, 11, 14, or 17.
private static int	monthsInYear(int year)
public void	roll(int the time field. field, int the amount by which the field should be rolled. amount) Overrides com.ibm.icu.util.Calendar.roll. Rolls (up/down) a specified amount time on the given field.
public void	setTemporalMonthCode(String The value to be set for temporal monthCode. temporalMonth) Overrides com.ibm.icu.util.Calendar.setTemporalMonthCode. Sets The Temporal monthCode which is a string identifier that starts with the literal grapheme "M" followed by two graphemes representing the zero-padded month number of the current month in a normal (non-leap) year and suffixed by an optional literal grapheme "L" if this is a leap month in a lunisolar calendar.
private static long	startOfYear(int year) Finds the day # of the first day in the given Hebrew year.
protected void	validateField(int field) Overrides com.ibm.icu.util.Calendar.validateField. Deprecated This API is ICU internal only. Validate a single field of this calendar.
private final int	yearType(int year) Returns the the type of a given year.

Inherited from com.ibm.icu.util.Calendar:: after before clear clear clone compareTo complete computeFields computeGregorianFields computeGregorianMonthStart computeJulianDay computeMillisInDay computeMillisInDayLong computeTime computeZoneOffset computeZoneOffset equals fieldDifference fieldName floorDivide floorDivide floorDivide floorDivide get getActualMaximum getActualMinimum getAvailableLocales getAvailableULocales getDateAtTimePattern getDateTimeFormat getDateTimeFormat getDateTimePattern getDayOfWeekType getDefaultDayInMonth getDefaultMonthInYear getDisplayName getDisplayName getFieldCount getFieldResolutionTable getFirstDayOfWeek getGreatestMinimum getGregorianDayOfMonth getGregorianDayOfYear getGregorianMonth getGregorianYear getInstance getInstance getInstance getInstance getInstance getInstance getKeywordValuesForLocale getLeastMaximum getLimit getLocale getMaximum getMinimalDaysInFirstWeek getMinimum getRelatedYear getRepeatedWallTimeOption getSkippedWallTimeOption getStamp getTime getTimeInMillis getTimeZone getWeekData getWeekDataForRegion getWeekendTransition gregorianMonthLength gregorianPreviousMonthLength handleComputeJulianDay handleCreateFields handleGetDateFormat handleGetDateFormat handleGetDateFormat handleGetDateFormat hashCode haveDefaultCentury internalGet internalGet internalGetMonth internalGetTimeInMillis internalSet isEquivalentTo isGregorianLeapYear isLenient isSet isWeekend isWeekend julianDayToDayOfWeek julianDayToMillis millisToJulianDay newerField newestStamp pinField prepareGetActual resolveFields roll set set set set setFirstDayOfWeek setLenient setLocale setMinimalDaysInFirstWeek setRelatedYear setRepeatedWallTimeOption setSkippedWallTimeOption setTime setTimeInMillis setTimeZone setWeekData toString validateField validateFields weekNumber weekNumber

Field Detail

ADAR	back to summary
public static final int ADAR Constant for the Adar, the 7th month of the Hebrew year. ICU Status Stable since ICU 2.8.

ADAR

back to summary

public static final int ADAR

Constant for the Adar, the 7th month of the Hebrew year.

ICU Status: Stable since ICU 2.8.

ADAR_1	back to summary
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). ICU Status Stable since ICU 2.8.

ADAR_1

back to summary

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

ICU Status: Stable since ICU 2.8.

AV	back to summary
public static final int AV Constant for Av, the 12th month of the Hebrew year. ICU Status Stable since ICU 2.8.

back to summary

public static final int AV

Constant for Av, the 12th month of the Hebrew year.

ICU Status: Stable since ICU 2.8.

BAHARAD	back to summary
private static final long BAHARAD

cache	back to summary
private static CalendarCache cache

DAY_PARTS	back to summary
private static final long DAY_PARTS

ELUL	back to summary
public static final int ELUL Constant for Elul, the 13th month of the Hebrew year. ICU Status Stable since ICU 2.8.

ELUL

back to summary

public static final int ELUL

Constant for Elul, the 13th month of the Hebrew year.

ICU Status: Stable since ICU 2.8.

gTemporalMonthCodesForHebrew	back to summary
private static String[] gTemporalMonthCodesForHebrew

HESHVAN	back to summary
public static final int HESHVAN Constant for Heshvan, the 2nd month of the Hebrew year. ICU Status Stable since ICU 2.8.

HESHVAN

back to summary

public static final int HESHVAN

Constant for Heshvan, the 2nd month of the Hebrew year.

ICU Status: Stable since ICU 2.8.

HOUR_PARTS	back to summary
private static final long HOUR_PARTS

IYAR	back to summary
public static final int IYAR Constant for Iyar, the 9th month of the Hebrew year. ICU Status Stable since ICU 2.8.

IYAR

back to summary

public static final int IYAR

Constant for Iyar, the 9th month of the Hebrew year.

ICU Status: Stable since ICU 2.8.

KISLEV	back to summary
public static final int KISLEV Constant for Kislev, the 3rd month of the Hebrew year. ICU Status Stable since ICU 2.8.

KISLEV

back to summary

public static final int KISLEV

Constant for Kislev, the 3rd month of the Hebrew year.

ICU Status: Stable since ICU 2.8.

LEAP_MONTH_START	back to summary
private static final int[][] LEAP_MONTH_START The cumulative # of days to the end of each month in a leap year

LIMITS	back to summary
private static final int[][] LIMITS Hides com.ibm.icu.util.Calendar.LIMITS. The absolute date, in milliseconds since 1/1/1970 AD, Gregorian, of the start of the Hebrew calendar. In order to keep this calendar's time of day in sync with that of the Gregorian calendar, we use midnight, rather than sunset the day before.

LIMITS

back to summary

private static final int[][] LIMITS

Hides com.ibm.icu.util.Calendar.LIMITS.

The absolute date, in milliseconds since 1/1/1970 AD, Gregorian, of the start of the Hebrew calendar. In order to keep this calendar's time of day in sync with that of the Gregorian calendar, we use midnight, rather than sunset the day before.

MONTH_DAYS	back to summary
private static final int MONTH_DAYS

MONTH_FRACT	back to summary
private static final long MONTH_FRACT

MONTH_LENGTH	back to summary
private static final int[][] MONTH_LENGTH The lengths of the Hebrew months. This is complicated, because there are three different types of years, or six if you count leap years. Due to the rules for postponing the start of the year to avoid having certain holidays fall on the sabbath, the year can end up being three different lengths, called "deficient", "normal", and "complete".

MONTH_PARTS	back to summary
private static final long MONTH_PARTS

MONTH_START	back to summary
private static final int[][] MONTH_START The cumulative # of days to the end of each month in a non-leap year Although this can be calculated from the MONTH_LENGTH table, keeping it around separately makes some calculations a lot faster

NISAN	back to summary
public static final int NISAN Constant for Nisan, the 8th month of the Hebrew year. ICU Status Stable since ICU 2.8.

NISAN

back to summary

public static final int NISAN

Constant for Nisan, the 8th month of the Hebrew year.

ICU Status: Stable since ICU 2.8.

serialVersionUID	back to summary
private static final long serialVersionUID Hides com.ibm.icu.util.Calendar.serialVersionUID.

SHEVAT	back to summary
public static final int SHEVAT Constant for Shevat, the 5th month of the Hebrew year. ICU Status Stable since ICU 2.8.

SHEVAT

back to summary

public static final int SHEVAT

Constant for Shevat, the 5th month of the Hebrew year.

ICU Status: Stable since ICU 2.8.

SIVAN	back to summary
public static final int SIVAN Constant for Sivan, the 10th month of the Hebrew year. ICU Status Stable since ICU 2.8.

SIVAN

back to summary

public static final int SIVAN

Constant for Sivan, the 10th month of the Hebrew year.

ICU Status: Stable since ICU 2.8.

TAMUZ	back to summary
public static final int TAMUZ Constant for Tammuz, the 11th month of the Hebrew year. ICU Status Stable since ICU 2.8.

TAMUZ

back to summary

public static final int TAMUZ

Constant for Tammuz, the 11th month of the Hebrew year.

ICU Status: Stable since ICU 2.8.

TEVET	back to summary
public static final int TEVET Constant for Tevet, the 4th month of the Hebrew year. ICU Status Stable since ICU 2.8.

TEVET

back to summary

public static final int TEVET

Constant for Tevet, the 4th month of the Hebrew year.

ICU Status: Stable since ICU 2.8.

TISHRI	back to summary
public static final int TISHRI Constant for Tishri, the 1st month of the Hebrew year. ICU Status Stable since ICU 2.8.

TISHRI

back to summary

public static final int TISHRI

Constant for Tishri, the 1st month of the Hebrew year.

ICU Status: Stable since ICU 2.8.

Constructor Detail

HebrewCalendar back to summary

HebrewCalendar	back to summary
public HebrewCalendar() Constructs a default `HebrewCalendar` using the current time in the default time zone with the default `FORMAT` locale. ICU Status Stable since ICU 2.8. See Also `Category#FORMAT`

public HebrewCalendar()

Constructs a default HebrewCalendar using the current time in the default time zone with the default FORMAT locale.

ICU Status: Stable since ICU 2.8.
See Also: Category#FORMAT

HebrewCalendar back to summary

HebrewCalendar	back to summary
public HebrewCalendar(TimeZone zone) Constructs a `HebrewCalendar` based on the current time in the given time zone with the default `FORMAT` locale. Parameters zone:TimeZone The time zone for the new calendar. ICU Status Stable since ICU 2.8. See Also `Category#FORMAT`

public HebrewCalendar(TimeZone zone)

Constructs a HebrewCalendar based on the current time in the given time zone with the default FORMAT locale.

Parameters

zone:TimeZone: The time zone for the new calendar.

ICU Status

Stable since ICU 2.8.

See Also

Category#FORMAT

HebrewCalendar back to summary

HebrewCalendar	back to summary
public HebrewCalendar(Locale aLocale) Constructs a `HebrewCalendar` based on the current time in the default time zone with the given locale. Parameters aLocale:Locale The locale for the new calendar. ICU Status Stable since ICU 2.8.

public HebrewCalendar(Locale aLocale)

Constructs a HebrewCalendar based on the current time in the default time zone with the given locale.

Parameters

aLocale:Locale: The locale for the new calendar.

ICU Status

Stable since ICU 2.8.

HebrewCalendar back to summary

HebrewCalendar	back to summary
public HebrewCalendar(ULocale locale) Constructs a `HebrewCalendar` based on the current time in the default time zone with the given locale. Parameters locale:ULocale The locale for the new calendar. ICU Status Stable since ICU 3.2.

public HebrewCalendar(ULocale locale)

Constructs a HebrewCalendar based on the current time in the default time zone with the given locale.

Parameters

locale:ULocale: The locale for the new calendar.

ICU Status

Stable since ICU 3.2.

HebrewCalendar back to summary

HebrewCalendar	back to summary
public HebrewCalendar(TimeZone zone, Locale aLocale) Constructs a `HebrewCalendar` based on the current time in the given time zone with the given locale. Parameters zone:TimeZone The time zone for the new calendar. aLocale:Locale The locale for the new calendar. ICU Status Stable since ICU 2.8.

public HebrewCalendar(TimeZone zone, Locale aLocale)

Constructs a HebrewCalendar based on the current time in the given time zone with the given locale.

Parameters

zone:TimeZone: The time zone for the new calendar.
aLocale:Locale: The locale for the new calendar.

ICU Status

Stable since ICU 2.8.

HebrewCalendar back to summary

HebrewCalendar	back to summary
public HebrewCalendar(TimeZone zone, ULocale locale) Constructs a `HebrewCalendar` based on the current time in the given time zone with the given locale. Parameters zone:TimeZone The time zone for the new calendar. locale:ULocale The locale for the new calendar. ICU Status Stable since ICU 3.2.

public HebrewCalendar(TimeZone zone, ULocale locale)

Constructs a HebrewCalendar based on the current time in the given time zone with the given locale.

Parameters

zone:TimeZone: The time zone for the new calendar.
locale:ULocale: The locale for the new calendar.

ICU Status

Stable since ICU 3.2.

HebrewCalendar back to summary

HebrewCalendar	back to summary
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. Parameters year:int The value used to set the calendar's `YEAR` time field. month:int The value used to set the calendar's `MONTH` time field. The value is 0-based. e.g., 0 for Tishri. date:int The value used to set the calendar's `DATE` time field. ICU Status Stable since ICU 2.8. See Also `Category#FORMAT`

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.

Parameters

year:int: The value used to set the calendar's YEAR time field.
month:int: The value used to set the calendar's MONTH time field. The value is 0-based. e.g., 0 for Tishri.
date:int: The value used to set the calendar's DATE time field.

ICU Status

Stable since ICU 2.8.

See Also

Category#FORMAT

HebrewCalendar back to summary

HebrewCalendar	back to summary
public HebrewCalendar(Date date) Constructs a `HebrewCalendar` with the given date set in the default time zone with the default `FORMAT` locale. Parameters date:Date The date to which the new calendar is set. ICU Status Stable since ICU 2.8. See Also `Category#FORMAT`

public HebrewCalendar(Date date)

Constructs a HebrewCalendar with the given date set in the default time zone with the default FORMAT locale.

Parameters

date:Date: The date to which the new calendar is set.

ICU Status

Stable since ICU 2.8.

See Also

Category#FORMAT

HebrewCalendar back to summary

HebrewCalendar	back to summary
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. Parameters year:int The value used to set the calendar's `YEAR` time field. month:int The value used to set the calendar's `MONTH` time field. The value is 0-based. e.g., 0 for Tishri. date:int The value used to set the calendar's `DATE` time field. hour:int The value used to set the calendar's `HOUR_OF_DAY` time field. minute:int The value used to set the calendar's `MINUTE` time field. second:int The value used to set the calendar's `SECOND` time field. ICU Status Stable since ICU 2.8. See Also `Category#FORMAT`

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.

Parameters

year:int: The value used to set the calendar's YEAR time field.
month:int: The value used to set the calendar's MONTH time field. The value is 0-based. e.g., 0 for Tishri.
date:int: The value used to set the calendar's DATE time field.
hour:int: The value used to set the calendar's HOUR_OF_DAY time field.
minute:int: The value used to set the calendar's MINUTE time field.
second:int: The value used to set the calendar's SECOND time field.

ICU Status

Stable since ICU 2.8.

See Also

Category#FORMAT

Method Detail

add back to summary

add	back to summary
public void add(int field, int amount) Overrides com.ibm.icu.util.Calendar.add. 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. Parameters field:int the time field. amount:int the amount to add to the field. Annotations @Override Exceptions IllegalArgumentException: if the field is invalid or refers to a field that cannot be handled by this method. ICU Status Stable since ICU 2.8.

public void add(int field, int amount)

Overrides com.ibm.icu.util.Calendar.add.

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.

Parameters

field:int: the time field.
amount:int: the amount to add to the field.

Annotations

@Override

Exceptions

IllegalArgumentException:: if the field is invalid or refers to a field that cannot be handled by this method.

ICU Status

Stable since ICU 2.8.

getTemporalMonthCode	back to summary
public String getTemporalMonthCode() Overrides com.ibm.icu.util.Calendar.getTemporalMonthCode. Gets The Temporal monthCode value corresponding to the month for the date. The value is a string identifier that starts with the literal grapheme "M" followed by two graphemes representing the zero-padded month number of the current month in a normal (non-leap) year and suffixed by an optional literal grapheme "L" if this is a leap month in a lunisolar calendar. For the Hebrew calendar, the values are "M01" .. "M12" for non-leap year, and "M01" .. "M05", "M05L", "M06" .. "M12" for leap year. Returns:String One of 13 possible strings in {"M01".. "M05", "M05L", "M06" .. "M12"}. ICU Status Draft since ICU 74.

getTemporalMonthCode

back to summary

public String getTemporalMonthCode()

Overrides com.ibm.icu.util.Calendar.getTemporalMonthCode.

Gets The Temporal monthCode value corresponding to the month for the date. The value is a string identifier that starts with the literal grapheme "M" followed by two graphemes representing the zero-padded month number of the current month in a normal (non-leap) year and suffixed by an optional literal grapheme "L" if this is a leap month in a lunisolar calendar. For the Hebrew calendar, the values are "M01" .. "M12" for non-leap year, and "M01" .. "M05", "M05L", "M06" .. "M12" for leap year.

Returns:String: One of 13 possible strings in {"M01".. "M05", "M05L", "M06" .. "M12"}.
ICU Status: Draft since ICU 74.

getType	back to summary
public String getType() Overrides com.ibm.icu.util.Calendar.getType. Doc from com.ibm.icu.util.Calendar.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 Returns:String legacy calendar type name string Annotations @Override ICU Status Stable since ICU 3.8.

getType

back to summary

public String getType()

Overrides com.ibm.icu.util.Calendar.getType.

Doc from com.ibm.icu.util.Calendar.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

Returns:String

legacy calendar type name string

Annotations

@Override

ICU Status

Stable since ICU 3.8.

handleComputeFields	back to summary
protected void handleComputeFields(int julianDay) Overrides com.ibm.icu.util.Calendar.handleComputeFields. 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. Annotations @Override ICU Status Stable since ICU 2.8.

handleComputeFields

back to summary

protected void handleComputeFields(int julianDay)

Overrides com.ibm.icu.util.Calendar.handleComputeFields.

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.

Annotations

@Override

ICU Status

Stable since ICU 2.8.

handleComputeMonthStart	back to summary
protected int handleComputeMonthStart(int eyear, int month, boolean useMonth) Implements abstract com.ibm.icu.util.Calendar.handleComputeMonthStart. Return JD of start of given month/year. Parameters eyear:int Doc from com.ibm.icu.util.Calendar.handleComputeMonthStart. the extended year month:int Doc from com.ibm.icu.util.Calendar.handleComputeMonthStart. the zero-based month, or 0 if useMonth is false useMonth:boolean Doc from com.ibm.icu.util.Calendar.handleComputeMonthStart. 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 Returns:int Doc from com.ibm.icu.util.Calendar.handleComputeMonthStart. the Julian day number of the day before the first day of the given month and year Annotations @Override ICU Status Stable since ICU 2.8.

handleComputeMonthStart

back to summary

protected int handleComputeMonthStart(int eyear, int month, boolean useMonth)

Implements abstract com.ibm.icu.util.Calendar.handleComputeMonthStart.

Return JD of start of given month/year.

Parameters

eyear:int

Doc from com.ibm.icu.util.Calendar.handleComputeMonthStart.

the extended year

month:int

Doc from com.ibm.icu.util.Calendar.handleComputeMonthStart.

the zero-based month, or 0 if useMonth is false

useMonth:boolean

Doc from com.ibm.icu.util.Calendar.handleComputeMonthStart.

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

Returns:int

Doc from com.ibm.icu.util.Calendar.handleComputeMonthStart.

the Julian day number of the day before the first day of the given month and year

Annotations

@Override

ICU Status

Stable since ICU 2.8.

handleGetExtendedYear	back to summary
protected int handleGetExtendedYear() Implements abstract com.ibm.icu.util.Calendar.handleGetExtendedYear. Doc from com.ibm.icu.util.Calendar.handleGetExtendedYear. 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. Returns:int the extended year Annotations @Override ICU Status Stable since ICU 2.8.

handleGetExtendedYear

back to summary

protected int handleGetExtendedYear()

Implements abstract com.ibm.icu.util.Calendar.handleGetExtendedYear.

Doc from com.ibm.icu.util.Calendar.handleGetExtendedYear.

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.

Returns:int

the extended year

Annotations

@Override

ICU Status

Stable since ICU 2.8.

handleGetLimit back to summary

handleGetLimit	back to summary
protected int handleGetLimit(int field, int limitType) Implements abstract com.ibm.icu.util.Calendar.handleGetLimit. Doc from com.ibm.icu.util.Calendar.handleGetLimit. 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 Parameters field:int one of the above field numbers limitType:int one of `MINIMUM`, `GREATEST_MINIMUM`, `LEAST_MAXIMUM`, or `MAXIMUM` Annotations @Override ICU Status Stable since ICU 2.8.

protected int handleGetLimit(int field, int limitType)

Implements abstract com.ibm.icu.util.Calendar.handleGetLimit.

Doc from com.ibm.icu.util.Calendar.handleGetLimit.

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

Parameters

field:int: one of the above field numbers
limitType:int: one of MINIMUM, GREATEST_MINIMUM, LEAST_MAXIMUM, or MAXIMUM

Annotations

@Override

ICU Status

Stable since ICU 2.8.

handleGetMonthLength	back to summary
protected int handleGetMonthLength(int extendedYear, int month) Overrides com.ibm.icu.util.Calendar.handleGetMonthLength. Returns the length of the given month in the given year Annotations @Override ICU Status Stable since ICU 2.8.

handleGetMonthLength

back to summary

protected int handleGetMonthLength(int extendedYear, int month)

Overrides com.ibm.icu.util.Calendar.handleGetMonthLength.

Returns the length of the given month in the given year

Annotations

@Override

ICU Status

Stable since ICU 2.8.

handleGetYearLength	back to summary
protected int handleGetYearLength(int eyear) Overrides com.ibm.icu.util.Calendar.handleGetYearLength. Returns the number of days in the given Hebrew year Annotations @Override ICU Status Stable since ICU 2.8.

handleGetYearLength

back to summary

protected int handleGetYearLength(int eyear)

Overrides com.ibm.icu.util.Calendar.handleGetYearLength.

Returns the number of days in the given Hebrew year

Annotations

@Override

ICU Status

Stable since ICU 2.8.

inTemporalLeapYear	back to summary
public boolean inTemporalLeapYear() Overrides com.ibm.icu.util.Calendar.inTemporalLeapYear. Doc from com.ibm.icu.util.Calendar.inTemporalLeapYear. ICU Returns true if the date is in a leap year. Recalculate the current time field values if the time value has been changed by a call to * setTime(). This method is semantically const, but may alter the object in memory. A "leap year" is a year that contains more days than other years (for solar or lunar calendars) or more months than other years (for lunisolar calendars like Hebrew or Chinese), as defined in the ECMAScript Temporal proposal. Returns:boolean true if the date in the fields is in a Temporal proposal defined leap year. False otherwise. ICU Status Draft since ICU 74.

inTemporalLeapYear

back to summary

public boolean inTemporalLeapYear()

Overrides com.ibm.icu.util.Calendar.inTemporalLeapYear.

Doc from com.ibm.icu.util.Calendar.inTemporalLeapYear.

ICU

Returns true if the date is in a leap year. Recalculate the current time field values if the time value has been changed by a call to * setTime(). This method is semantically const, but may alter the object in memory. A "leap year" is a year that contains more days than other years (for solar or lunar calendars) or more months than other years (for lunisolar calendars like Hebrew or Chinese), as defined in the ECMAScript Temporal proposal.

Returns:boolean: true if the date in the fields is in a Temporal proposal defined leap year. False otherwise.
ICU Status: Draft since ICU 74.

internalGetMonth	back to summary
protected int internalGetMonth() Overrides com.ibm.icu.util.Calendar.internalGetMonth. Doc from com.ibm.icu.util.Calendar.internalGetMonth. Deprecated This API is ICU internal only. Use this function instead of internalGet(MONTH). The implementation check the timestamp of MONTH and ORDINAL_MONTH and use the one set later. The subclass should override it to conver the value of ORDINAL_MONTH to MONTH correctly if ORDINAL_MONTH has higher priority. Returns:int the value for the given time field. Annotations @Deprecated ICU Status Internal ICU component.

internalGetMonth

back to summary

protected int internalGetMonth()

Overrides com.ibm.icu.util.Calendar.internalGetMonth.

Doc from com.ibm.icu.util.Calendar.internalGetMonth.

Deprecated

This API is ICU internal only.

Use this function instead of internalGet(MONTH). The implementation check the timestamp of MONTH and ORDINAL_MONTH and use the one set later. The subclass should override it to conver the value of ORDINAL_MONTH to MONTH correctly if ORDINAL_MONTH has higher priority.

Returns:int

the value for the given time field.

Annotations

@Deprecated

ICU Status

Internal ICU component.

isLeapYear	back to summary
public static boolean isLeapYear(int year) Deprecated This API is ICU internal only. Determine whether a given Hebrew year is a leap year The rule here is that if (year % 19) == 0, 3, 6, 8, 11, 14, or 17. The formula below performs the same test, believe it or not. Annotations @Deprecated ICU Status Internal ICU component.

isLeapYear

back to summary

public static boolean isLeapYear(int year)

Deprecated

This API is ICU internal only.

Determine whether a given Hebrew year is a leap year The rule here is that if (year % 19) == 0, 3, 6, 8, 11, 14, or 17. The formula below performs the same test, believe it or not.

Annotations

@Deprecated

ICU Status

Internal ICU component.

monthsInYear	back to summary
private static int monthsInYear(int year)

roll back to summary

public void roll(int field, int amount)

Overrides com.ibm.icu.util.Calendar.roll.

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.

Parameters

field:int: the time field.
amount:int: the amount by which the field should be rolled.

Annotations

@Override

Exceptions

IllegalArgumentException:: if the field is invalid or refers to a field that cannot be handled by this method.

ICU Status

Stable since ICU 2.8.

setTemporalMonthCode

back to summary

public void setTemporalMonthCode(String temporalMonth)

Overrides com.ibm.icu.util.Calendar.setTemporalMonthCode.

Sets The Temporal monthCode which is a string identifier that starts with the literal grapheme "M" followed by two graphemes representing the zero-padded month number of the current month in a normal (non-leap) year and suffixed by an optional literal grapheme "L" if this is a leap month in a lunisolar calendar. For Hebrew calendar, the values are "M01" .. "M12" for non-leap years, and "M01" .. "M05", "M05L", "M06" .. "M12" for leap year.

Parameters

temporalMonth:String: The value to be set for temporal monthCode.

ICU Status

Draft since ICU 74.

startOfYear

back to summary

private static long startOfYear(int year)

Finds the day # of the first day in the given Hebrew year. To do this, we want to calculate the time of the Tishri 1 new moon in that year.

The algorithm here is similar to ones described in a number of references, including:

"Calendrical Calculations", by Nachum Dershowitz & Edward Reingold, Cambridge University Press, 1997, pages 85-91.
Hebrew Calendar Science and Myths, http://www.geocities.com/Athens/1584/
The Calendar FAQ, http://www.faqs.org/faqs/calendars/faq/

validateField back to summary

protected void validateField(int field)

Overrides com.ibm.icu.util.Calendar.validateField.

Doc from com.ibm.icu.util.Calendar.validateField.

Deprecated

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.

Annotations

@Override
@Deprecated

ICU Status

Internal ICU component.

yearType	back to summary
private final int yearType(int year) Returns the the type of a given year. 0 "Deficient" year with 353 or 383 days 1 "Normal" year with 354 or 384 days 2 "Complete" year with 355 or 385 days

public Class HebrewCalendar

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail