Public Member Functions | |
ZmanimCalendar () | |
ZmanimCalendar (IGeoLocation location) | |
ZmanimCalendar (DateTime date, IGeoLocation location) | |
A constructor that takes a
| |
virtual DateTime | GetTzais () |
Returns tzais (nightfall) when the sun is 8.5° below the western geometric horizon (90°) after
sunset. For information on the source of this calculation see
| |
virtual DateTime | GetAlosHashachar () |
virtual DateTime | GetAlos72 () |
virtual DateTime | GetChatzos () |
virtual DateTime | GetSolarMidnight () |
virtual DateTime | GetSofZmanShmaGRA () |
This method returns the latest zman krias shema (time to say Shema in the morning). This time is 3 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. /summary> seealso cref = "GetShaahZmanisGra" /> returns> the DateTime of the latest zman shema. 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. | |
virtual DateTime | GetSofZmanShmaMGA () |
virtual DateTime | GetTzais72 () |
virtual DateTime | GetCandelLighting () |
A method to return candle lighting time. This is calculated as
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. | |
virtual DateTime | GetSofZmanTfilaGRA () |
This method returns the latest zman tefilah (time to pray morning prayers). This time is 4 hours into the day 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 4 * | |
virtual DateTime | GetSofZmanTfilaMGA () |
This method returns the latest zman tfila (time to say the morning prayers) in the opinion of the MG"A</em> based on
<em>alos</em> being <seealso cref="GetAlos72">72</seealso> minutes before
<seealso cref="AstronomicalCalendar.GetSunrise">sunrise</seealso>. This time is 4
<em><seealso cref="GetShaahZmanisMGA">shaos zmaniyos</seealso></em> (temporal hours)
after <seealso cref="GetAlos72">dawn</seealso> based on the opinion of the <em>MG"A that the day is calculated from a
dawnof 72 minutes before sunrise to
nightfallof 72 minutes after sunset. This returns the time of 4 *
| |
virtual DateTime | GetMinchaGedola () |
This method returns the time of mincha gedola. Mincha gedola is the earliest time one can pray mincha. The Ramba"m is of the opinion that it is better to delay <em>mincha</em>
until <em><seealso cref="GetMinchaKetana">mincha ketana</seealso></em> while the
<em>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 hoursafter 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 | |
virtual DateTime | GetMinchaKetana () |
This method returns the time of mincha ketana. This is the perfered earliest time to pray mincha in the opinion of the Ramba"m and others. For more information on this see the documentation on <em><seealso cref="GetMinchaGedola">mincha gedola</seealso></em>. This is calculated as 9.5 <seealso cref="GetShaahZmanisGra">sea level solar hours</seealso> after <seealso cref="AstronomicalCalendar.GetSeaLevelSunrise">sea level sunrise</seealso>. This calculation is calculated based on the opinion of the <em>GR"A and the Baal Hatanya that the day is calculated from sunrise to sunset. This returns the time 9.5 * | |
virtual DateTime | GetPlagHamincha () |
This method returns he time of plag hamincha. This is calculated as 10.75 hours after 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 10.75 * GetShaahZmanisGra after sea level sunrise. | |
virtual long | GetShaahZmanisGra () |
Method to return a shaah zmanis ( temporal hour) according to the opinion of the GR"A</em> and the <em>Baal Hatanya</em>. This
calculation divides the day based on the opinion of the <em>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. | |
virtual long | GetShaahZmanisMGA () |
Method to return a shaah zmanis (temporal hour) according to the opinion of the MGA. This calculation divides the day based on the opinion of the MGA that the day runs from dawn to dusk (for sof zman krias shema and tfila). Dawn for this calculation is 72 minutes before sunrise and dusk is 72 minutes after sunset. This day is split into 12 equal parts with each part being a shaah zmanis. Alternate mothods of calculating a shaah zmanis are available in the subclass ComplexZmanimCalendar. | |
override bool | Equals (object obj) |
Determines whether the specified System.Object is equal to this instance. | |
override int | GetHashCode () |
Returns a hash code for this instance. | |
Protected Attributes | |
internal const double | ZENITH_16_POINT_1 = GEOMETRIC_ZENITH + 16.1 |
The zenith of 16.1° below geometric zenith (90°). This calculation is used for calculating alos (dawn) and tzais (nightfall) in some opinions. This calculation is based on the calculation that the time between dawn and sunrise (and sunset to nightfall) is the time that is takes to walk 4 mil at 18 minutes a mil (Ramba"m</em> and others). The sun's position at 72 minutes
before <see cref="AstronomicalCalendar.GetSunrise">sunrise</see> in Jerusalem on the equinox is
16.1° below <see cref="AstronomicalCalendar.GEOMETRIC_ZENITH">geometric zenith. /summary> seealso cref="GetAlosHashachar" /> seealso cref="ComplexZmanimCalendar.GetAlos16Point1Degrees()" /> seealso cref="ComplexZmanimCalendar.GetTzais16Point1Degrees()" /> seealso cref="ComplexZmanimCalendar.GetSofZmanShmaMGA16Point1Degrees()" /> seealso cref="ComplexZmanimCalendar.GetSofZmanTfilaMGA16Point1Degrees()" /> seealso cref="ComplexZmanimCalendar.GetMinchaGedola16Point1Degrees()" /> seealso cref="ComplexZmanimCalendar.GetMinchaKetana16Point1Degrees()" /> seealso cref="ComplexZmanimCalendar.GetPlagHamincha16Point1Degrees()" /> seealso cref="ComplexZmanimCalendar.GetPlagAlos16Point1ToTzaisGeonim7Point083Degrees()" /> seealso cref="ComplexZmanimCalendar.GetSofZmanShmaAlos16Point1ToSunset()" /> | |
internal const double | ZENITH_8_POINT_5 = GEOMETRIC_ZENITH + 8.5 |
Properties | |
virtual double | CandleLightingOffset [get, set] |
Description: A .NET 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 the
that extends this class. This class contains the main functionality of the Zmanim library. See documentation for the and for simple examples on using the API.
Note: It is important to read the technical notes on top of the AstronomicalCalculator documentation.
While I did my best to get accurate results please do not rely on these zmanim for halacha lemaaseh.
<author>Eliyahu Hershfeld</author>
Zmanim.ZmanimCalendar.ZmanimCalendar | ( | ) |
summary> A constructor that takes a
as a parameter. /summary> param name = "location"> the location
Zmanim.ZmanimCalendar.ZmanimCalendar | ( | DateTime | date, | |
IGeoLocation | location | |||
) |
A constructor that takes a
as a parameter.
date | The date. | |
location | the location |
override bool Zmanim.ZmanimCalendar.Equals | ( | object | obj | ) |
Determines whether the specified System.Object is equal to this instance.
obj | The System.Object to compare with this instance. |
true
if the specified System.Object is equal to this instance; otherwise, false
. T:System.NullReferenceException | The obj parameter is null. |
Reimplemented from Zmanim.AstronomicalCalendar.
virtual DateTime Zmanim.ZmanimCalendar.GetAlos72 | ( | ) | [virtual] |
summary> 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. The returned value is identical to AstronomicalCalendar.GetSunTransit /summary> seealso cref = "AstronomicalCalendar.GetSunTransit" /> returns> the DateTime
of chatzos. 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.
virtual DateTime Zmanim.ZmanimCalendar.GetAlosHashachar | ( | ) | [virtual] |
summary> 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. 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. /summary> returns> the DateTime
representing the time. 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.
virtual DateTime Zmanim.ZmanimCalendar.GetCandelLighting | ( | ) | [virtual] |
A method to return candle lighting time. This is calculated as
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.
virtual DateTime Zmanim.ZmanimCalendar.GetChatzos | ( | ) | [virtual] |
summary> A method that returns "solar" midnight, or the time when the sun is at it's nadir.
Note: this method is experimental and might be removed (or moved) /summary> returns> the DateTime
of Solar Midnight (chatzos layla). 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.
override int Zmanim.ZmanimCalendar.GetHashCode | ( | ) |
Returns a hash code for this instance.
summary> A method to get the offset in minutes before 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. /summary> value> Returns the candle lighting offset to set in minutes..
seealso cref = "GetCandelLighting" />
Reimplemented from Zmanim.AstronomicalCalendar.
Reimplemented in Zmanim.ComplexZmanimCalendar.
virtual DateTime Zmanim.ZmanimCalendar.GetMinchaGedola | ( | ) | [virtual] |
This method returns the time of mincha gedola. Mincha gedola is the earliest time one can pray mincha. The Ramba"m is of the opinion that it is better to delay <em>mincha</em> until <em><seealso cref="GetMinchaKetana">mincha ketana</seealso></em> while the <em>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 hoursafter
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
after sea level sunrise.
DateTime
of the time of mincha gedola. 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. virtual DateTime Zmanim.ZmanimCalendar.GetMinchaKetana | ( | ) | [virtual] |
This method returns the time of mincha ketana. This is the perfered earliest time to pray mincha in the opinion of the Ramba"m and others. For more information on this see the documentation on <em><seealso cref="GetMinchaGedola">mincha gedola</seealso></em>. This is calculated as 9.5 <seealso cref="GetShaahZmanisGra">sea level solar hours</seealso> after <seealso cref="AstronomicalCalendar.GetSeaLevelSunrise">sea level sunrise</seealso>. This calculation is calculated based on the opinion of the <em>GR"A and the Baal Hatanya that the day is calculated from sunrise to sunset. This returns the time 9.5 *
after sea level sunrise.
DateTime
of the time of mincha gedola. 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. virtual DateTime Zmanim.ZmanimCalendar.GetPlagHamincha | ( | ) | [virtual] |
This method returns he time of plag hamincha. This is calculated as 10.75 hours after 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 10.75 * GetShaahZmanisGra after sea level sunrise.
DateTime
of the time of plag hamincha. 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. virtual long Zmanim.ZmanimCalendar.GetShaahZmanisGra | ( | ) | [virtual] |
Method to return a shaah zmanis ( temporal hour) according to the opinion of the GR"A</em> and the <em>Baal Hatanya</em>. This calculation divides the day based on the opinion of the <em>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
virtual long Zmanim.ZmanimCalendar.GetShaahZmanisMGA | ( | ) | [virtual] |
Method to return a shaah zmanis (temporal hour) according to the opinion of the MGA. This calculation divides the day based on the opinion of the MGA that the day runs from dawn to dusk (for sof zman krias shema and tfila). Dawn for this calculation is 72 minutes before sunrise and dusk is 72 minutes after sunset. This day is split into 12 equal parts with each part being a shaah zmanis. Alternate mothods of calculating a shaah zmanis are available in the subclass ComplexZmanimCalendar.
long
virtual DateTime Zmanim.ZmanimCalendar.GetSofZmanShmaGRA | ( | ) | [virtual] |
This method returns the latest zman krias shema (time to say Shema in the morning). This time is 3 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. /summary> seealso cref = "GetShaahZmanisGra" /> returns> the DateTime
of the latest zman shema. 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.
summary> This method returns the latest zman krias shema (time to say Shema in the morning) in the opinion of the MG"A</em> based on
<em>alos</em> being 72 minutes before <see cref = "AstronomicalCalendar.GetSunrise">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. /summary> returns> the DateTime
of the latest zman shema. 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.
seealso cref = "ComplexZmanimCalendar.GetShaahZmanis72Minutes()" /> seealso cref = "GetAlos72" /> seealso cref = "ComplexZmanimCalendar.GetSofZmanShmaMGA72Minutes()" />
virtual DateTime Zmanim.ZmanimCalendar.GetSofZmanShmaMGA | ( | ) | [virtual] |
summary> 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. Even for locations above sea level, this is calculated at sea level, since the darkness level is not affected by elevation. /summary> returns> the DateTime
representing 72 minutes after sea level sunset. 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.
virtual DateTime Zmanim.ZmanimCalendar.GetSofZmanTfilaGRA | ( | ) | [virtual] |
This method returns the latest zman tefilah (time to pray morning prayers). This time is 4 hours into the day 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 4 *
after sea level sunrise.
DateTime
of the latest zman tefilah. 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. virtual DateTime Zmanim.ZmanimCalendar.GetSofZmanTfilaMGA | ( | ) | [virtual] |
This method returns the latest zman tfila (time to say the morning prayers) in the opinion of the MG"A</em> based on <em>alos</em> being <seealso cref="GetAlos72">72</seealso> minutes before <seealso cref="AstronomicalCalendar.GetSunrise">sunrise</seealso>. This time is 4 <em><seealso cref="GetShaahZmanisMGA">shaos zmaniyos</seealso></em> (temporal hours) after <seealso cref="GetAlos72">dawn</seealso> based on the opinion of the <em>MG"A that the day is calculated from a
dawnof 72 minutes before sunrise to
nightfallof 72 minutes after sunset. This returns the time of 4 *
after dawn.
DateTime
of the latest zman tfila. 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. virtual DateTime Zmanim.ZmanimCalendar.GetTzais | ( | ) | [virtual] |
Returns tzais (nightfall) when the sun is 8.5° below the western geometric horizon (90°) after
sunset. For information on the source of this calculation see
.
DateTime
summary> Returns alos (dawn) based on the time when the sun is 16.1° below the eastern geometric horizon before sunrise. For more information the source of 16.1° see ZENITH_16_POINT_1. /summary> seealso cref = "ZENITH_16_POINT_1" /> returns> The DateTime
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.
internal const double Zmanim.ZmanimCalendar.ZENITH_16_POINT_1 = GEOMETRIC_ZENITH + 16.1 [protected] |
The zenith of 16.1° below geometric zenith (90°). This calculation is used for calculating alos (dawn) and tzais (nightfall) in some opinions. This calculation is based on the calculation that the time between dawn and sunrise (and sunset to nightfall) is the time that is takes to walk 4 mil at 18 minutes a mil (Ramba"m</em> and others). The sun's position at 72 minutes before <see cref="AstronomicalCalendar.GetSunrise">sunrise</see> in Jerusalem on the equinox is 16.1° below <see cref="AstronomicalCalendar.GEOMETRIC_ZENITH">geometric zenith. /summary> seealso cref="GetAlosHashachar" /> seealso cref="ComplexZmanimCalendar.GetAlos16Point1Degrees()" /> seealso cref="ComplexZmanimCalendar.GetTzais16Point1Degrees()" /> seealso cref="ComplexZmanimCalendar.GetSofZmanShmaMGA16Point1Degrees()" /> seealso cref="ComplexZmanimCalendar.GetSofZmanTfilaMGA16Point1Degrees()" /> seealso cref="ComplexZmanimCalendar.GetMinchaGedola16Point1Degrees()" /> seealso cref="ComplexZmanimCalendar.GetMinchaKetana16Point1Degrees()" /> seealso cref="ComplexZmanimCalendar.GetPlagHamincha16Point1Degrees()" /> seealso cref="ComplexZmanimCalendar.GetPlagAlos16Point1ToTzaisGeonim7Point083Degrees()" /> seealso cref="ComplexZmanimCalendar.GetSofZmanShmaAlos16Point1ToSunset()" />
summary> The zenith of 8.5° below geometric zenith (90°). This calculation is used for calculating alos (dawn) and tzais (nightfall) in some opinions. This calculation is based on the position of the sun 36 minutes after 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. /summary> seealso cref = "GetTzais" /> seealso cref = "ComplexZmanimCalendar.GetTzaisGeonim8Point5Degrees" />
internal const double Zmanim.ZmanimCalendar.ZENITH_8_POINT_5 = GEOMETRIC_ZENITH + 8.5 [protected] |
summary> Default constructor will set a default GeoLocation, a default AstronomicalCalculator and default the calendar to the current date. /summary> seealso cref = "AstronomicalCalendar" />