The KosherJava site now has a new vasikin calendar generator tool. This allows vasikin minyanim to generate customized vasikin charts. Offsets for various pre-sunrise davening points can be set. There are separate weekday, Shabbos, Yom Tov and Rosh Hashana / Yom Kippur offsets for each davening point. The format of the charts is Excel, but it is optimized for printing eye pleasing charts.
I would like to thank Howard Reichman who requested a vasikin calendar for the Los Angeles LINK Kollel vasikin minyan that ended up with the development of this zmanim tool. Howard graciously funded the next 7 months of hosting for KosherJava.com.
The new TefilaRules class has been added to the KosherJava Zmanim Library. This will be included in the upcoming v2.4.0 release. The TefilaRules class was added in an effort to help zmanim calendar authors who sometimes require knowing if תחנון tachanun is recited on a specific day in order to set tefila times (such as mincha starting X minutes before shkiah, and a few minutes later if tachanun is not recited). It is also useful for siddur app creators. With many different minhagim (mostly chasidishe) about when tachanun is recited, the class currently supports 12 different options that can allow setting the rules for a majority of minhagim.
Yahrzeits such as 7 Adar, (Moshe Rabbeinu’s yahrzeit) or holidays celebrated by specific communities such as Purim Mezhbizh (Medzhybizh) celebrated on 11 Teves or Purim Saragossa celebrated on the 17th of Shevat (the Wikipedia date seems to be in error), are not (and likely never will be) supported by this class.
Other tefila related rules such as the existing Mashiv Haruach etc. rules were moved over from the JewishCalendar class to this new class where they have a more natural fit. The methods that were migrated over, were deprecated in the JewishCalendar class and will be removed in v3.0.0.
Key Methods in the TefilaRules Class
The following are the key methods in the new TefilaRules class.
- Shemoneh Esreh Rules
- Tachanun Rules
- Hallel Rules
- Possible Future Additions
- Mizmor Lesoda
Yom Kippur Kattanadded to JewishCalendar Hallel Shalem / Chatzi Halleladded BeHaBadded to JewishCalendar
- Vihi Noam on Motzai Shabbos
TefilaRules tr = new TefilaRules(); JewishCalendar jCal = new JewishCalendar(); HebrewDateFormatter hdf = new HebrewDateFormatter(); hdf.setHebrewFormat(true); // Hebrew formatting jCal.setJewishDate(5783, JewishDate.TISHREI, 1); // Rosh Hashana System.out.println(hdf.format(jCal) + " - Is tachanun recited: " + tr.isTachanunRecitedShacharis(jCal)); jCal.setJewishDate(5729, JewishDate.SHEVAT, 21); System.out.println(hdf.format(jCal) + " - is mashiv haruch recited: " + tr.isMashivHaruachRecited(jCal)); jCal.setJewishDate(5783, JewishDate.ADAR, 17); System.out.println(hdf.format(jCal) + " - Is tachanun recited: " + tr.isTachanunRecitedShacharis(jCal)); tr.setTachanunRecitedWeekOfPurim(false); //default is true System.out.println(hdf.format(jCal) + " - Is tachanun recited: " + tr.isTachanunRecitedShacharis(jCal));
א׳ תשרי תשפ״ג - Is tachanun recited: false כ״א שבט תשכ״ט - is mashiv haruch recited: true י״ז אדר תשפ״ג - Is tachanun recited: true י״ז אדר תשפ״ג - Is tachanun recited: false
Degree based Zmanim
Degree-based zmanim are considered most accurate by many poskim since zmanim calculated using degrees for alos and tzais have a consistent level of light at all dates and locations. The alternatives of using fixed minutes (for example 72 minutes) or percentage of the day-based calculations (1/10th of the day) result in alos and tzais zmanim having different levels of light at different dates and locations. The number of degrees for a given zman is calculated based on how many degrees the sun is below the horizon on an equal day in Yerushalayim. For example, the sun is 16.1° below the horizon 72 minutes before sunrise (or after sunset) on an equal day (defined below) in Yerushalayim. The subject of degree-based zmanim is extensive and deserves its own detailed article, עוד חזון למועד.
Equinox VS Equilux in Halacha
A question explored by poskim and luach authors is; how we define an equal day to use for degree-based zmanim calculations. Should it be calculated at the astronomically equal day of the equinox or the halachic equal day of the equilux. At the equinox, the 12-hour duration of the day is calculated astronomically without accounting for refraction or solar radius. At the equilux there are exactly 12 hours of daylight from sunrise to sunset. Due to these two factors, the halachic length of the day from sunrise to sunset at the equinox is longer than 12 hours. In Yerushalayim on March 20, 2021, the day of the March equinox, sea level sunrise is at 5:42:51 AM and sunset is at 5:50:33 PM, or a day length of 12 hours, 7 minutes and 42 seconds. You would have to go back four days to March 16, the equilux, for a 12-hour day. There are halachic opinions supporting both the equinox and the equilux as the equal day for zmanim calculations.
Practical Differences Between Equinox and Equilux Calculations
Many calendars and seforim list the 72-minute alos / tzais as 16.1° and 90 minutes as 19.8° (using the global refraction average + solar radius of 0.8333). Calculations using the KosherJava Zmanim API (utilizing the Jean Meeus / NOAA algorithms) show that the actual figures are 16.08° and 19.848° at the equilux, and 16.04° and 19.784° at the equinox. The table below shows the difference between these numbers at the summer solstice when twilight is the longest (the most extreme expected gap between two different degree-based times).
|Difference Between the Equilux and Equinox Calculations at the Summer Solstice|
|Location||7.199° VS 7.205° (30 Min)||11.424° VS 11.442° (50 Min)||16.04° VS 16.08° (72 Min)||19.784° VS 19.848° (90 Min)|
|2 sec||7 sec||15 sec||26 sec|
|2 sec||7 sec||20 sec||38 sec|
|3 sec||10 sec||30 sec||90 sec|
|3 sec||13 sec||93 sec||N/A|
|4 sec||16 sec||N/A||N/A|
|13 sec||47 sec||N/A||N/A|
|N/A indicates that the sun does not get this far below the horizon at this time of the year due to the high latitude of the location. See Why Some Zmanim Never Occur for more details.|
While the above question is interesting from an academic perspective, the measurements above show a negligible difference between calculating at the equinox VS the equilux for most locations and zmanim. The difference in calculating zmanim up to 16.1° alos / tzais on the equinox vs the equilux isn’t significant until the 30 second difference at the 72-minute zman. Since this is typically calculated as 16.1° lechumra, there is no difference at all for this zman. The less commonly used 19.8°, has an up to 90 second difference (at the latitude of Montreal). The ~11.5° misheyakir times start showing a difference at high latitudes. This is not significant even as far north as London but becomes significant at the 58.68° latitude of Vilna (Vilnius) since it reaches 47 seconds.
Observations on Degree Based Calculations
- The commonly used 16.1° time is a slightly rounded chumra for both the equinox and equilux. The actual numbers are 16.04° and 16.08°.
- The 19.8° zman mentioned by many calendars and seforim is calculated at the equinox where it is 19.784° and not equilux where it is 19.848°. It should possibly be rounded up to 19.9° lechumra to account for the equilux calculation.
- The misheyakir 11.5° times are a slight kula since both the equilux (11.442°) and the equinox (11.424°) calculations show a sightly later time.
- As noted above, the degree-based calculations were done using the more accurate Jean Meeus / NOAA algorithms. Seforim printed in the past did not have access to the newer algorithms and typically used the USNO algorithm, but as seen below, there is only a trivial difference between the algorithms.
Zman Equinox Equilux USNO NOAA USNO NOAA 30 Min 7.203° 7.199° 7.208° 7.205° 50 Min 11.432° 11.424° 11.449° 11.442° 72 Min 16.055° 16.04° 16.092° 16.08° 90 Min 19.804° 19.784° 19.865° 19.848°
1. ^ The assumed location for these calculations in most calendars (and the KosherJava zmanim library) is Yerushalayim, something that is debatable. See Hazmanim Bahalacha 19:2, pages 169-170.
2. ^ As an example, alos hashachar according to some opinions is 72 minutes before sunrise (the time it takes to walk 4 mil at a speed of 18 minutes per mil). The time of twilight from alos / dawn to sunrise and sunset to tzais / night is known as neshef נשף in Hebrew. The time of twilight differs by location and time of year with the longest duration during the summer solstice, shortest by the equinoxes and somewhere in between in the winter. According to many opinions this zman should be calculated by measuring the sun’s degrees below the horizon at the equal day and applying the same number of degrees to any location and date.
4. ^ It is calculated as if the world had no atmosphere and the radius of the sun is above the horizon.
5. ^ Rabbi Yedidya Manet mentions that there are 5 to 6 days separating the equinox and equilux, while Rabbi Yonah Merzbach in a letter to Rabbi Manat mentioned a week or two. Calculations show the difference between the equinox and equilux to be 4 days in Yerushalayim, moving the calculation date from March 20th back to March 16th (or from September 22nd to the 26th).
6. ^ In March 2021 it is 8 seconds off from a true 12-hour day due to the location where the equinox occurs for that season (it is at a single point and time globally), but it is more than close enough for our purposes. The figure varies from year to year. Calculations on the September equinox show similar results.
7. ^ Rabbi Meir Pozen in his Kuntres Haneshef and Or Hameir, is of the opinion that the equilux should be used. Opinions that the equinox should be used are brought down by Rabbi Yedidya Manet in his Zmanei Halacha Lema’aseh (4th edition part 2, pages 22 and 24), Rabbi Yonah Merzbach (in a letter published by Rabbi Manat) and Rabbi David Yehuda Burstein in his Zmanim Kehilchasam, 1:8 (pages 56 – 61). This is also the opinion of Rabbi Chaim Pinchas Banish in Hazmanim Bahalacha vol 1, 19:3, page 270, and Rabbi Aryeh Leib Lipkin in his Ohr Hayom, summary section, no. 9 (page 76).
8. ^ This is close to the 7.083° tzais zman and used for comparison. The 7.083° zman was first brought down by Dr. Baruch (Berthold) Cohn in his luach Tabellen enthaltend die Zeitangaben für den Beginn der Nacht und des Tages für die Breitengrade + 66 bis -38, published in Strasbourg, France in 1899. It was based on actual observation of star visibility. Some list the 7.083° zman as based on the 30-minute calculation, but as seen in the chart, it is not an exact match. In Yerushalayim at the equinox (when there is the smallest difference), 7.083° is 33 seconds earlier than the 30-minute time of 7.199° and in Vilna it is 49 seconds earlier. At the solstice in Yerushalayim 7.083° is 39 seconds earlier than 7.199°, and in Vilna it is 97 seconds earlier.
9. ^ At this point the KosherJava Zmanim API will continue using the 16.1° (a minor chumra), and 19.8° (a minor kulah at the equilux) used by the Yisrael Vehazmanim and many others.
The KosherJava Zmanim API version 2.3.0 was released on Dec 7th, 2021 ג׳ טבת תשפ״ב in Maven and GitHub. While there have been numerous releases over the years, this is the first release-related post since the v1.3.0 release in 2013. If you have not updated since that time, you can expect some changes. The most significant changes (besides a lot of new functionality) are the simple to fix breaking changes listed below.
New in Version 2.3.0
- Added seasonal davening based zmanim including Vesein Tal Umatar/ Vesein Berachah / Mashiv Haruach.
- Added Rav Moshe Feinstein’s fixed local chatzos based zmanim. These are used in MTJ and Yeshiva (and Camp) of Staten Island.
- Refactored code for alos and tzeis zmaniyos based time (ports of the library to other languages can simplify their code by doing the same).
- Fixed an issue with kiddush levana being off by an hour when the molad and kiddush levana zmanim are on different sides of the DST change. This impacted the JewishCalendar but not the ComplexZmanimCalendar.
- Corrected the Hebrew spelling of Parshas Nitzavim.
The list of significant changes in this and previous releases can be seen in the KosherJava Zmanim API changelog.
Breaking Changes since v1.3
- The Zmanim API no longer supports Java versions prior to Java 8 (released in March 2014). It likely still compiles against Java 6 released in December 2006.
- The package structure changed from net.sourceforge.zmanim to com.kosherjava.zmanim.
- There were two mathematically identical calculators using the USNO algorithm, so the less clean (code-wise) ZmanimCalculator was removed, while the SunTimesCalculator was retained.