|
KosherJava Zmanim Homepage | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectnet.sourceforge.zmanim.AstronomicalCalendar
net.sourceforge.zmanim.ZmanimCalendar
public class ZmanimCalendar
Description: A Java library for calculating zmanim.
The zmanim library is an API is a specialized calendar that can calculate sunrise and sunset and Jewish zmanim (religious times) for prayers and other Jewish religious duties. For a much more extensive list of zmanim use theComplexZmanimCalendar
that extends this class. This class
contains the main functionality of the Zmanim library. See documentation for
the ComplexZmanimCalendar
and AstronomicalCalendar
for simple
examples on using the API. AstronomicalCalculator
documentation.
Field Summary | |
---|---|
protected static double |
ZENITH_16_POINT_1
The zenith of 16.1° below geometric zenith (90°). |
protected static double |
ZENITH_8_POINT_5
The zenith of 8.5° below geometric zenith (90°). |
Fields inherited from class net.sourceforge.zmanim.AstronomicalCalendar |
---|
ASTRONOMICAL_ZENITH, CIVIL_ZENITH, GEOMETRIC_ZENITH, HOUR_MILLIS, MINUTE_MILLIS, NAUTICAL_ZENITH |
Constructor Summary | |
---|---|
ZmanimCalendar()
Default constructor will set a default GeoLocation.GeoLocation() ,
a default AstronomicalCalculator and default the calendar to the current date. |
|
ZmanimCalendar(GeoLocation location)
A constructor that takes a GeoLocation as a parameter. |
Method Summary | |
---|---|
boolean |
equals(Object object)
|
Date |
getAlos72()
Method to return alos (dawn) calculated using 72 minutes before sea level sunrise (no adjustment for
elevation) based on the time to walk the distance of 4 Mil at 18
minutes a Mil. |
Date |
getAlosHashachar()
Returns alos (dawn) based on the time when the sun is 16.1° below the eastern geometric horizon before
sunrise . |
Date |
getCandelLighting()
A method to return candle lighting time. |
double |
getCandleLightingOffset()
A method to get the offset in minutes before sunset that is used in
calculating candle lighting time. |
Date |
getChatzos()
This method returns chatzos (midday) following the opinion of the GRA that the day for Jewish halachic times start at sunrise and ends at sunset . |
Date |
getMinchaGedola()
This method returns the time of mincha gedola. |
Date |
getMinchaKetana()
This method returns the time of mincha ketana. |
Date |
getPlagHamincha()
This method returns he time of plag hamincha. |
long |
getShaahZmanisGra()
Method to return a shaah zmanis ( temporal hour ) according to the
opinion of the GR"A and the Baal Hatanya. |
long |
getShaahZmanisMGA()
Method to return a shaah zmanis (temporal hour) according to the opinion of the MGA. |
Date |
getSofZmanShmaGRA()
This method returns the latest zman krias shema (time to say Shema in the morning). |
Date |
getSofZmanShmaMGA()
This method returns the latest zman krias shema (time to say Shema in the morning) in the opinion of the MG"A based on alos being 72 minutes before sunrise . |
Date |
getSofZmanTfilaGRA()
This method returns the latest zman tefilah (time to pray morning prayers). |
Date |
getSofZmanTfilaMGA()
This method returns the latest zman tfila (time to say the morning prayers) in the opinion of the MG"A based on alos being 72 minutes before
sunrise . |
Date |
getSolarMidnight()
A method that returns "solar" midnight, or the time when the sun is at it's nadir. |
Date |
getTzais()
Returns tzais (nightfall) when the sun is 8.5° below the western geometric horizon (90°) after sunset . |
Date |
getTzais72()
This method returns the tzais (nightfall) based on the opinion of the Ramba"m and Rabainu Tam that tzais is calculated as the time it takes to walk 4 Mil at 18 minutes a Mil for a total of 72 minutes. |
int |
hashCode()
|
void |
setCandleLightingOffset(double candleLightingOffset)
A method to set the offset in minutes before sunset that is used in
calculating candle lighting time. |
Methods inherited from class java.lang.Object |
---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
protected static final double ZENITH_16_POINT_1
sunrise
in Jerusalem on the equinox is
16.1° below geometric zenith
.
getAlosHashachar()
,
ComplexZmanimCalendar.getAlos16Point1Degrees()
,
ComplexZmanimCalendar.getTzais16Point1Degrees()
,
ComplexZmanimCalendar.getSofZmanShmaMGA16Point1Degrees()
,
ComplexZmanimCalendar.getSofZmanTfilaMGA16Point1Degrees()
,
ComplexZmanimCalendar.getMinchaGedola16Point1Degrees()
,
ComplexZmanimCalendar.getMinchaKetana16Point1Degrees()
,
ComplexZmanimCalendar.getPlagHamincha16Point1Degrees()
,
ComplexZmanimCalendar.getPlagAlos16Point1ToTzaisGeonim7Point083Degrees()
,
ComplexZmanimCalendar.getSofZmanShmaAlos16Point1ToSunset()
,
Constant Field Valuesprotected static final double ZENITH_8_POINT_5
sunset
in Jerusalem on
March 16, about 4 days before the equinox, the day that a solar hour is
one hour, which is 8.5° below geometric
zenith
. The Ohr Meir considers this the time that 3 small starts are
visible, later than the required 3 medium stars.
getTzais()
,
ComplexZmanimCalendar.getTzaisGeonim8Point5Degrees()
,
Constant Field ValuesConstructor Detail |
---|
public ZmanimCalendar()
GeoLocation.GeoLocation()
,
a default AstronomicalCalculator
and default the calendar to the current date.
AstronomicalCalendar.AstronomicalCalendar()
public ZmanimCalendar(GeoLocation location)
GeoLocation
as a parameter.
location
- the locationMethod Detail |
---|
public Date getTzais()
sunset
. For
information on the source of this calculation see
ZENITH_8_POINT_5
.
Date
of nightfall. If the calculation can't be
computed such as northern and southern locations even south of
the Arctic Circle and north of the Antarctic Circle where the sun
may not reach low enough below the horizon for this calculation,
a null will be returned. See detailed explanation on top of the
AstronomicalCalendar
documentation.ZENITH_8_POINT_5
public Date getAlosHashachar()
geometric horizon
before
sunrise
. For more information the source of 16.1°
see ZENITH_16_POINT_1
.
Date
of dawn. If the calculation can't be
computed such as northern and southern locations even south of
the Arctic Circle and north of the Antarctic Circle where the sun
may not reach low enough below the horizon for this calculation,
a null will be returned. See detailed explanation on top of the
AstronomicalCalendar
documentation.ZENITH_16_POINT_1
public Date getAlos72()
sea level sunrise
(no adjustment for
elevation) based on the time to walk the distance of 4 Mil at 18
minutes a Mil. This is based on the opinion of most
Rishonim who stated that the time of the Neshef (time
between dawn and sunrise) does not vary by the time of year or location
but purely depends on the time it takes to walk the distance of 4
Mil.
Date
representing the time. If the calculation
can't be computed such as in the Arctic Circle where there is at
least one day a year where the sun does not rise, and one where
it does not set, a null will be returned. See detailed
explanation on top of the AstronomicalCalendar
documentation.public Date getChatzos()
sunrise
and ends at sunset
. The
returned value is identical to AstronomicalCalendar.getSunTransit()
Date
of chatzos. If the calculation can't be
computed such as in the Arctic Circle where there is at least one
day where the sun does not rise, and one where it does not set, a
null will be returned. See detailed explanation on top of the
AstronomicalCalendar
documentation.AstronomicalCalendar.getSunTransit()
public Date getSolarMidnight()
Date
of Solar Midnight (chatzos layla). If the
calculation can't be computed such as in the Arctic Circle where
there is at least one day a year where the sun does not rise, and
one where it does not set, a null will be returned. See detailed
explanation on top of the AstronomicalCalendar
documentation.public Date getSofZmanShmaGRA()
shaos zmaniyos
(solar hours) after
sea level sunrise
based on the opinion of
the GR"A and the Baal Hatanya that the day is
calculated from sunrise to sunset. This returns the time 3 *
getShaahZmanisGra()
after sea level
sunrise
.
Date
of the latest zman shema. If the
calculation can't be computed such as in the Arctic Circle where
there is at least one day a year where the sun does not rise, and
one where it does not set, a null will be returned. See detailed
explanation on top of the AstronomicalCalendar
documentation.getShaahZmanisGra()
public Date getSofZmanShmaMGA()
sunrise
. This
time is 3 shaos zmaniyos (solar hours) after dawn based on the
opinion of the MG"A that the day is calculated from a dawn of 72
minutes before sunrise to nightfall of 72 minutes after sunset. This
returns the time of 3 * shaos zmaniyos after dawn.
Date
of the latest zman shema. If the
calculation can't be computed such as in the Arctic Circle where
there is at least one day a year where the sun does not rise, and
one where it does not set, a null will be returned. See detailed
explanation on top of the AstronomicalCalendar
documentation.ComplexZmanimCalendar.getShaahZmanis72Minutes()
,
getAlos72()
,
ComplexZmanimCalendar.getSofZmanShmaMGA72Minutes()
public Date getTzais72()
Date
representing 72 minutes after sea level
sunset. If the calculation can't be computed such as in the
Arctic Circle where there is at least one day a year where the
sun does not rise, and one where it does not set, a null will be
returned See detailed explanation on top of the
AstronomicalCalendar
documentation.public Date getCandelLighting()
getCandleLightingOffset()
minutes before sunset. This will
return the time for any day of the week, since it can be used to
calculate candle lighting time for yom tov (holidays) as well.
AstronomicalCalendar
documentation.getCandleLightingOffset()
,
setCandleLightingOffset(double)
public Date getSofZmanTfilaGRA()
getShaahZmanisGra()
after
sea level sunrise
.
Date
of the latest zman tefilah. If the
calculation can't be computed such as in the Arctic Circle where
there is at least one day a year where the sun does not rise, and
one where it does not set, a null will be returned. See detailed
explanation on top of the AstronomicalCalendar
documentation.getShaahZmanisGra()
public Date getSofZmanTfilaMGA()
72
minutes before
sunrise
. This time is 4
shaos zmaniyos
(temporal hours)
after dawn
based on the opinion of the MG"A
that the day is calculated from a dawn
of 72 minutes
before sunrise to nightfall
of 72 minutes after
sunset. This returns the time of 4 * getShaahZmanisMGA()
after
dawn
.
Date
of the latest zman tfila. If the
calculation can't be computed such as in the Arctic Circle where
there is at least one day a year where the sun does not rise, and
one where it does not set), a null will be returned. See detailed
explanation on top of the AstronomicalCalendar
documentation.getShaahZmanisMGA()
,
getAlos72()
public Date getMinchaGedola()
mincha ketana
while the
Ra"sh,
Tur, GR"A and others are of the opinion that mincha can be
prayed lechatchila starting at mincha gedola. This is
calculated as 6.5 sea level solar hours
after sea level sunrise
. This calculation
is calculated based on the opinion of the GR"A and the
Baal Hatanya that the day is calculated from sunrise to sunset.
This returns the time 6.5 getShaahZmanisGra()
after
sea level sunrise
.
Date
of the time of mincha gedola. If the
calculation can't be computed such as in the Arctic Circle where
there is at least one day a year where the sun does not rise, and
one where it does not set, a null will be returned. See detailed
explanation on top of the AstronomicalCalendar
documentation.getShaahZmanisGra()
,
getMinchaKetana()
public Date getMinchaKetana()
mincha gedola
. This is calculated as
9.5 sea level solar hours
after
sea level sunrise
. This calculation is
calculated based on the opinion of the GR"A and the
Baal Hatanya that the day is calculated from sunrise to sunset.
This returns the time 9.5 * getShaahZmanisGra()
after
sea level sunrise
.
Date
of the time of mincha gedola. If the
calculation can't be computed such as in the Arctic Circle where
there is at least one day a year where the sun does not rise, and
one where it does not set, a null will be returned. See detailed
explanation on top of the AstronomicalCalendar
documentation.getShaahZmanisGra()
,
getMinchaGedola()
public Date getPlagHamincha()
getShaahZmanisGra()
after sea level
sunrise
.
Date
of the time of plag hamincha. If
the calculation can't be computed such as in the Arctic Circle
where there is at least one day a year where the sun does not
rise, and one where it does not set, a null will be returned. See
detailed explanation on top of the AstronomicalCalendar
documentation.public long getShaahZmanisGra()
temporal hour
) according to the
opinion of the GR"A and the Baal Hatanya. This
calculation divides the day based on the opinion of the GR"A and
the Baal Hatanya that the day runs from sunrise
to sunset
. The calculations are based on a
day from sea level sunrise
to
sea level sunset
. The day is split into 12
equal parts each part with each one being a shaah zmanis. This
method is similar to AstronomicalCalendar.getTemporalHour()
, but all calculations are
based on a sealevel sunrise and sunset. For additional information, see
Zmanim Kehilchasam, 2nd Edition by Rabbi Dovid Yehuda Burstein,
Jerusalem, 2007.
long
millisecond length of a
shaah zmanis. If the calculation can't be computed such
as in the Arctic Circle where there is at least one day a year
where the sun does not rise, and one where it does not set,
Long.MIN_VALUE
will be returned. See detailed explanation on
top of the AstronomicalCalendar
documentation.AstronomicalCalendar.getTemporalHour(Date, Date)
public long getShaahZmanisMGA()
ComplexZmanimCalendar
.
long
millisecond length of a
shaah zmanis. If the calculation can't be computed such
as in the Arctic Circle where there is at least one day a year
where the sun does not rise, and one where it does not set,
Long.MIN_VALUE
will be returned. See detailed explanation
on top of the AstronomicalCalendar
documentation.public boolean equals(Object object)
equals
in class AstronomicalCalendar
Object.equals(Object)
public int hashCode()
hashCode
in class AstronomicalCalendar
Object.hashCode()
public double getCandleLightingOffset()
sunset
that is used in
calculating candle lighting time. The default time used is 18 minutes
before sunset. Some calendars use 15 minutes, while the custom in
Jerusalem is to use a 40 minute offset. Please check the local custom for
candel lighting time.
getCandelLighting()
public void setCandleLightingOffset(double candleLightingOffset)
sunset
that is used in
calculating candle lighting time. The default time used is 18 minutes
before sunset. Some calendars use 15 minutes, while the custom in
Jerusalem is to use a 40 minute offset.
candleLightingOffset
- The candle lighting offset to set in minutes.getCandelLighting()
|
KosherJava Zmanim Homepage | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |