|
1 | 1 | ## 3.0.0 (future) |
2 | 2 | ### Includes breaking changes |
3 | | -* Remove deprecated methods flagged for removal. |
4 | | -* Remove deprecated classes such as the redundant [GeoLocationUtils](https://github.com/KosherJava/zmanim/blob/master/src/main/java/com/kosherjava/zmanim/util/GeoLocationUtils.java). |
5 | | -* Possibly rename some classes such as the confusingly named [ComplexZmanimCalendar](https://github.com/KosherJava/zmanim/blob/master/src/main/java/com/kosherjava/zmanim/ComplexZmanimCalendar.java). |
| 3 | +* Remove deprecated methods flagged for removal, including |
| 4 | + * `ComprehensiveZmanimcalendar` class |
| 5 | + * `getSofZmanShmaKolEliyahu()` |
| 6 | + * `getTzaisGeonim3Point65Degrees()` - was prior to 13.5 minutes in Yerushalayim at the equinox/equilux. |
| 7 | + * `getTzaisGeonim3Point676Degrees()` - was prior to 13.5 minutes in Yerushalayim at the equinox/equilux. |
| 8 | + * `getSofZmanTfilahAteretTorah()` - use the `getSofZmanTfilaAteretTorah()` |
| 9 | + * `getSofZmanShmaFixedLocal()` |
| 10 | + * `getSofZmanTfilaFixedLocal()` |
| 11 | + * `getMinchaGedolaBaalHatanyaGreaterThan30()` should now be calculated via `ZmanimCalendar.getMinchaGedolaGreaterThan30(Instant minchaGedolaBaalHatanya)` |
| 12 | + * `getFixedLocalChatzosBasedZmanim(Date, Date, double)` |
| 13 | + * Move ErevPesach zmanim to generic methods in the parent `ZmanimCalendar` class. |
| 14 | + * Move `getSunriseBaalHatanya()` and `getSunsetBaalHatanya()` to the parent `ZmanimCalendar` class. |
| 15 | + * various mispelled getBainHasmashos based zmanim (use the properly spelled getBainHasmashos versions |
| 16 | + * `JewishCalendar` class |
| 17 | + * `isVeseinTalUmatarStartDate()` - use `TefilaRules.isVeseinTalUmatarStartDate()` |
| 18 | + * `isVeseinTalUmatarStartingTonight()` - use `TefilaRules.isVeseinTalUmatarStartingTonight()` |
| 19 | + * `isVeseinTalUmatarRecited()` - use `TefilaRiles.isVeseinTalUmatarRecited()` |
| 20 | + * `isVeseinBerachaRecited()` - use `TefilaRules.isVeseinBerachaRecited()` |
| 21 | + * `isMashivHaruachStartDate` - use `TefilaRules.isMashivHaruachStartDate()` |
| 22 | + * `isMashivHaruachEndDate()` - use `TefilaRules.isMashivHaruachEndDate()` |
| 23 | + * `isMashivHaruachRecited()` - use `TefilaRules.isMashivHaruachRecited()` |
| 24 | + * `isMoridHatalRecited()` - use `TefilaRules.isMoridHatalRecited()` |
| 25 | +* Remove deprecated redundant [GeoLocationUtils](https://github.com/KosherJava/zmanim/blob/master/src/main/java/com/kosherjava/zmanim/util/GeoLocationUtils.java). Use the GeoLocation class instead. |
| 26 | +* Move some methods from `ComprehensiveZmanimCalendar` to the parent `ZaminCalendar` classes. |
| 27 | + * `getShaahZmanis72Minutes()` |
| 28 | + * `getAlos16Point1Degrees()` |
| 29 | + * `getSofZmanShmaMGA72Minutes()` |
| 30 | + * `getSofZmanTfilaMGA72Minutes()` |
| 31 | + * `getTzaisGeonim8Point5Degrees()` |
| 32 | + * `getZmanisBasedOffset(double)` |
| 33 | +* `ZmanimCalendar` class rename some genericly named method names to be more specific. The actual zmanim were not chnaged. |
| 34 | + * rename `getTzais()` -> `getTzaisGeonim8Point5Degrees()` |
| 35 | + * `getAlosHashachar()` -> `getAlos16Point1Degrees()` |
| 36 | + * `getSofZmanShmaMGA()` -> `getSofZmanShmaMGA72Minutes()` |
| 37 | + * `getSofZmanTfilaMGA()` -> `getSofZmanTfilaMGA72Minutes()` |
| 38 | + * `getMinchaGedola()` -> `getMinchaGedolaGRA()` |
| 39 | + * `getMinchaKetana()` -> `getMinchaKetanaGRA()` |
| 40 | + * `getPlagHamincha()` -> `getPlagHaminchaGRA()` |
| 41 | + * `getShaahZmanisMGA() ` -> `getShaahZmanis72Minutes()` |
| 42 | + * `getAlos72()` -> `getAlos72Minutes()` |
| 43 | + * `getTzais72()` -> `getTzais72Minutes()` |
| 44 | + * `getShaahZmanisGra()` -> `getShaahZmanisGRA()` |
| 45 | + * `getAlos120()` -> `getAlos120Minutes()` |
| 46 | + * `getAlos96()` -> `getAlos96Minutes()` |
| 47 | + * `getAlos90()` -> `getAlos90Minutes()` |
| 48 | + * `getAlos72()` -> `getAlos72Minutes()` |
| 49 | + * `getAlos60()` -> `getAlos60Minutes()` |
| 50 | + * `getTzais50()` -> `getTzais50Minutes()` |
| 51 | + * `getTzais60()` -> `getTzais60Minutes()` |
| 52 | + * `getTzais72()` -> `getTzais72Minutes()` |
| 53 | + * `getTzais90()` -> `getTzais90Minutes()` |
| 54 | + * `getTzais96()` -> `getTzais96Minutes()` |
| 55 | + * `getTzais120()` -> `getTzais120Minutes()` |
| 56 | +* Rename some classes the confusingly named `ComplexZmanimCalendar` to `ComrehensiveZmanimCalendar`. |
| 57 | +* Move "legacy" classes to `java.time` equivelants |
| 58 | + * All zmanim now return `Instant`s insead of `Date` objects. |
| 59 | + * Replace `SimpledateFormat` with `DateTimeFormatter` |
| 60 | + * `Calendar` and `GregorianCalendar` were replaced with `LocalDate` or `ZonedDateTime`. |
| 61 | + * `TimeZone` was replace with `ZoneId` |
| 62 | + * `GeoLocation.getLocalMeanTimeOffset()` and `getAntimeridianAdjustment()` now takes in `Instant` parameter. |
| 63 | + * Remove the no longer necessary `NOAACalculator.adjustHourForTimeZone(Calendar)` |
6 | 64 | * `getSofZman*Chametz*` times will retun null if it is not _Erev Pesach_. |
7 | | -* Possibly increase the minimum supported JRE version from version 8 (the code currently almost certainly works on 6 today). |
8 | | -* ... |
9 | | - |
10 | | -## [2.6.0](https://github.com/KosherJava/zmanim/compare/2.5.0...master) (future) |
11 | | - |
| 65 | +* Increase the minimum supported JRE version from version 8 (the code currently almost certainly works on 6 today) to Java 11 or higher. |
| 66 | +* `JewishCalendar` now has plus and minus methods (matching the `java.time.LocalDate` class) for years, months and days. |
| 67 | +* Tweaked logic in `AstronomicalCalendar.getInstantFromTime()` to address issues near the dateline. |
| 68 | +* Improve null handling in `ComprehensiveZmanimCalendar.getMoladBasedTime()` |
| 69 | +* Add `ComprehensiveZmanimCalendar.getMisheyakir12Point85Degrees()` |
| 70 | +* `ComprehensiveZmanimcalendar.getMinchaGedolaGreaterThan30()` was moved to the parent `ZmanimCalendar.getMinchaGedolaGreaterThan30(Instant)` that allows it to work with any mincha gedola claculation. |
| 71 | +* Change / remove `ComprehensiveZmanimcalendar` zmanim that were too early. |
| 72 | + * `getTzaisGeonim4Point37Degrees()` -> `getTzaisGeonim4Point42Degrees()`. |
| 73 | + * `getTzaisGeonim4Point61Degrees()` -> `getTzaisGeonim4Point66Degrees()` |
| 74 | + * Remove `getTzaisGeonim5Point88Degrees()` since it is a drop too early |
12 | 75 | * `ZmanimCalendar` [Astronomical Chatzos based changes](https://github.com/KosherJava/zmanim/commit/c523424b327f173d70f024bdf207ccae0413d487): |
13 | 76 | * Add setting `useAstronomicalChatzos` (defaulted to true) to keep the mistaken compat break introduced in the v2.5.0 release. |
14 | 77 | * Add setting `useAstronomicalChatzosForOtherZmanim` (defaulted to false). |
15 | 78 | * Add `getChatzosAsHalfDay()` to retain the old behavior of chatzos being halfway between sunrise and sunset. |
16 | 79 | * Use `useAstronomicalChatzos` to control if `getChatzos()` returns `getSunTransit()` (astronomical chatzos) or getChatzosAsHalfDay(). |
17 | 80 | * Add `getHalfDayBasedZman(Date startOfHalfDay, Date endOfHalfDay, double hours)` to allow other zmanim to be impacted by chatzos. |
18 | 81 | * Use `useAstronomicalChatzosForOtherZmanim`. |
19 | | - * `ZmanimCalendar` - add utility method [getPercentOfShaahZmanisFromDegrees(double degrees, boolean sunset)`](https://github.com/KosherJava/zmanim/commit/60d1f09322835835035afa507ac2dc852f1cb033) to simplify zmaniyos time calculations. This allows calculations of various percentage of the day zmanim calculations. |
| 82 | + * `ZmanimCalendar` - add utility method `[getPercentOfShaahZmanisFromDegrees(double degrees, boolean sunset)`](https://github.com/KosherJava/zmanim/commit/60d1f09322835835035afa507ac2dc852f1cb033) to simplify zmaniyos time calculations. This allows calculations of various percentage of the day zmanim calculations. |
20 | 83 | * Use Astronomical Chatzos Halayla (as opposed as halfway between sunset and sunrise or 12 hours after chatzos hayom) |
21 | 84 | * `AstronomicalCalculator` - [add `getSunLowerTransit()`](https://github.com/KosherJava/zmanim/commit/a76a3b65aeb45912bfdb02ce354f74bb97a9d9b2) |
22 | 85 | * `AstronomicalCalculator` - [add abstract method `getUTCMidnight()`](https://github.com/KosherJava/zmanim/commit/f1904b12393c48b069d1333a7397fce66804958d) |
23 | 86 | * `NOAACalculator` - [implement `getUTCMidnight()`](https://github.com/KosherJava/zmanim/commit/b93eea3388bfdcc2dd526bbcb1be37ddb88fee08) |
24 | 87 | * `AstronomicalCalculator` - [add abstract method `getUTCMidnight()`](https://github.com/KosherJava/zmanim/commit/1223dd0b6ad2b492818aacc5eb478747989e0ace) |
25 | | -* `ComplexZmanimCalendar` - [significant updates](https://github.com/KosherJava/zmanim/commit/46800aa750ac56c2da9bc55fbf976ea1a092221d) |
26 | | - * Deprecate `getTzaisGeonim3Point65Degrees()` and `getTzaisGeonim3Point676Degrees()`, very early tzais geonim time that are earlier than 13.5 minutes in Yerushalayim at the equinox / equilux. |
| 88 | +* `ComprehensiveZmanimCalendar` - [significant updates](https://github.com/KosherJava/zmanim/commit/46800aa750ac56c2da9bc55fbf976ea1a092221d) |
27 | 89 | * Started coding some zmanim to use the half-day zmanim config. |
28 | | - * Deprecate `getFixedLocalChatzosBasedZmanim()` in favor of `getHalfDayBasedZman()` in the parent ZmanimCalendar class. |
| 90 | + * Change `getFixedLocalChatzosBasedZmanim()` in favor of `getHalfDayBasedZman()` in the parent `ZmanimCalendar class. |
29 | 91 | * `getFixedLocalChatzos()` now just calls the new getLocalMeanTime(12.0) in the grandparent AstronomicalCalendar class. |
30 | 92 | * Remove `getSolarMidnight()` that was added to the AstronomicalCalendar grandparent class. |
31 | 93 | * Undeprecate `getPlagAlosToSunset()` since it is not a zman that can be too late. |
|
0 commit comments