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.