Skip to content

Commit 3085b36

Browse files
authored
Add 3 variants of getSamuchLeMinchaKetana
- getSamuchLeMinchaKetanaGRA() - getSamuchLeMinchaKetana16Point1Degrees() - getSamuchLeMinchaKetana72Minutes()
1 parent 6076dc1 commit 3085b36

File tree

1 file changed

+58
-1
lines changed

1 file changed

+58
-1
lines changed

src/main/java/com/kosherjava/zmanim/ComplexZmanimCalendar.java

Lines changed: 58 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2390,7 +2390,7 @@ public Date getTzaisGeonim6Point45Degrees() {
23902390

23912391
/**
23922392
* This method returns the <em>tzais</em> (nightfall) based on the opinion of the <em>Geonim</em> calculated when the
2393-
* sun's position {@link #ZENITH_7_POINT_083 7.083&deg; (or 7&deg; 5\u2032} below the western horizon. This is often
2393+
* sun's position {@link #ZENITH_7_POINT_083 7.083&deg; (or 7&deg; 5\u2032}) below the western horizon. This is often
23942394
* referred to as 7&deg;5' or 7&deg; and 5 minutes. This calculation is based on the observation of 3 medium sized
23952395
* stars by Dr. Baruch (Berthold) Cohn in his <em>luach</em> <a href=
23962396
* "https://sammlungen.ub.uni-frankfurt.de/freimann/content/titleinfo/983088">Tabellen enthaltend die Zeitangaben für
@@ -3976,4 +3976,61 @@ public Date getPlagHaminchaGRAFixedLocalChatzosToSunset() {
39763976
public Date getTzais50() {
39773977
return getTimeOffset(getElevationAdjustedSunset(), 50 * MINUTE_MILLIS);
39783978
}
3979+
3980+
/**
3981+
* A method for calculating <em>samuch lemincha ketana</em>, / near <em>mincha ketana<em> time that is half an hour before
3982+
* {@link #getMinchaKetana()} or is 9 * {@link #getShaahZmanisGra() <em>shaos zmaniyos</em>} (solar hours) after {@link
3983+
* #getSunrise() sunrise} or {@link #getSeaLevelSunrise() sea level sunrise} (depending on the {@link #isUseElevation()}
3984+
* setting), calculated according to the <a href="https://en.wikipedia.org/wiki/Vilna_Gaon">GRA</a> using a day starting at
3985+
* sunrise and ending at sunset. This is the time that eating or other activity can't begin prior to praying <em>mincha</em>.
3986+
* The calculation used is 9 * {@link #getShaahZmanis16Point1Degrees()} after {@link #getAlos16Point1Degrees() <em>alos</em>
3987+
* 16.1&deg;}. See the <a href="https://hebrewbooks.org/pdfpager.aspx?req=60387&st=&pgnum=294">Mechaber and Mishna Berurah
3988+
* 232</a> for details.
3989+
*
3990+
* @see #getShaahZmanisGra()
3991+
* @see #getSamuchLeMinchaKetana16Point1Degrees()
3992+
* @return the <code>Date</code> of the time of <em>samuch lemincha ketana</em>. If the calculation can't be computed such
3993+
* as northern and southern locations even south of the Arctic Circle and north of the Antarctic Circle
3994+
* where the sun may not reach low enough below the horizon for this calculation, a null will be returned.
3995+
* See detailed explanation on top of the {@link AstronomicalCalendar} documentation.
3996+
*/
3997+
public Date getSamuchLeMinchaKetanaGRA() {
3998+
return getSamuchLeMinchaKetana(getElevationAdjustedSunrise(), getElevationAdjustedSunset());
3999+
}
4000+
4001+
/**
4002+
* A method for calculating <em>samuch lemincha ketana</em>, / near <em>mincha ketana<em> time that is half an hour before
4003+
* {@link #getMinchaGedola16Point1Degrees()} or 9 * <em>shaos zmaniyos</em> (temporal hours) after the start of the day,
4004+
* calculated using a day starting and ending 16.1&deg; below the horizon. This is the time that eating or other activity
4005+
* can't begin prior to praying <em>mincha</em>. The calculation used is 9 * {@link #getShaahZmanis16Point1Degrees()} after
4006+
* {@link #getAlos16Point1Degrees() <em>alos</em> 16.1&deg;}. See the <a href=
4007+
* "https://hebrewbooks.org/pdfpager.aspx?req=60387&st=&pgnum=294">Mechaber and Mishna Berurah 232</a>.
4008+
*
4009+
* @see #getShaahZmanis16Point1Degrees()
4010+
* @return the <code>Date</code> of the time of <em>samuch lemincha ketana</em>. If the calculation can't be computed such
4011+
* as northern and southern locations even south of the Arctic Circle and north of the Antarctic Circle
4012+
* where the sun may not reach low enough below the horizon for this calculation, a null will be returned.
4013+
* See detailed explanation on top of the {@link AstronomicalCalendar} documentation.
4014+
*/
4015+
public Date getSamuchLeMinchaKetana16Point1Degrees() {
4016+
return getSamuchLeMinchaKetana(getAlos16Point1Degrees(), getTzais16Point1Degrees());
4017+
}
4018+
4019+
/**
4020+
* A method for calculating <em>samuch lemincha ketana</em>, / near <em>mincha ketana<em> time that is half an hour before
4021+
* {@link #getMinchaKetana72Minutes()} or 9 * <em>shaos zmaniyos</em> (temporal hours) after the start of the day,
4022+
* calculated using a day starting 72 minutes before sunrise and ending 72 minutes after sunset. This is the time that eating
4023+
* or other activity can't begin prior to praying <em>mincha</em>. The calculation used is 9 * {@link
4024+
* #getShaahZmanis16Point1Degrees()} after {@link #getAlos16Point1Degrees() <em>alos</em> 16.1&deg;}. See the <a href=
4025+
* "https://hebrewbooks.org/pdfpager.aspx?req=60387&st=&pgnum=294">Mechaber and Mishna Berurah 232</a>.
4026+
*
4027+
* @see #getShaahZmanis16Point1Degrees()
4028+
* @return the <code>Date</code> of the time of <em>samuch lemincha ketana</em>. If the calculation can't be computed such
4029+
* as northern and southern locations even south of the Arctic Circle and north of the Antarctic Circle
4030+
* where the sun may not reach low enough below the horizon for this calculation, a null will be returned.
4031+
* See detailed explanation on top of the {@link AstronomicalCalendar} documentation.
4032+
*/
4033+
public Date getSamuchLeMinchaKetana72Minutes() {
4034+
return getSamuchLeMinchaKetana(getAlos72(), getTzais72());
4035+
}
39794036
}

0 commit comments

Comments
 (0)