@@ -158,7 +158,7 @@ public class ComplexZmanimCalendar extends ZmanimCalendar {
158
158
* @todo Hyperlink the proper sources.
159
159
*
160
160
* @see #getTzaisGeonim7Point083Degrees()
161
- * @see #getBainHasmashosRT13Point5MinutesBefore7Point083Degrees ()
161
+ * @see #getBainHashmashosRT13Point5MinutesBefore7Point083Degrees ()
162
162
*/
163
163
protected static final double ZENITH_7_POINT_083 = GEOMETRIC_ZENITH + 7 + (5.0 / 60 );
164
164
@@ -198,9 +198,9 @@ public class ComplexZmanimCalendar extends ZmanimCalendar {
198
198
/**
199
199
* The zenith of 13.24° below {@link #GEOMETRIC_ZENITH geometric zenith} (90°). This calculation is used for
200
200
* calculating Rabbeinu Tam's <em>bain hashmashos</em> according to some opinions.
201
- * NOTE: See comments on {@link #getBainHasmashosRT13Point24Degrees } for additional details about the degrees.
201
+ * NOTE: See comments on {@link #getBainHashmashosRT13Point24Degrees } for additional details about the degrees.
202
202
*
203
- * @see #getBainHasmashosRT13Point24Degrees
203
+ * @see #getBainHashmashosRT13Point24Degrees
204
204
*
205
205
*/
206
206
protected static final double ZENITH_13_POINT_24 = GEOMETRIC_ZENITH + 13.24 ;
@@ -396,7 +396,7 @@ public class ComplexZmanimCalendar extends ZmanimCalendar {
396
396
* according to the Yereim. As is traditional with degrees below the horizon, this is calculated without refraction
397
397
* and from the center of the sun. It would be 0.833° less without this.
398
398
*
399
- * @see #getBainHasmashosYereim2Point1Degrees ()
399
+ * @see #getBainHashmashosYereim2Point1Degrees ()
400
400
*/
401
401
protected static final double ZENITH_MINUS_2_POINT_1 = GEOMETRIC_ZENITH - 2.1 ;
402
402
@@ -406,7 +406,7 @@ public class ComplexZmanimCalendar extends ZmanimCalendar {
406
406
* according to the Yereim. As is traditional with degrees below the horizon, this is calculated without refraction
407
407
* and from the center of the sun. It would be 0.833° less without this.
408
408
*
409
- * @see #getBainHasmashosYereim2Point8Degrees ()
409
+ * @see #getBainHashmashosYereim2Point8Degrees ()
410
410
*/
411
411
protected static final double ZENITH_MINUS_2_POINT_8 = GEOMETRIC_ZENITH - 2.8 ;
412
412
@@ -416,7 +416,7 @@ public class ComplexZmanimCalendar extends ZmanimCalendar {
416
416
* according to the Yereim. As is traditional with degrees below the horizon, this is calculated without refraction
417
417
* and from the center of the sun. It would be 0.833° less without this.
418
418
*
419
- * @see #getBainHasmashosYereim3Point05Degrees ()
419
+ * @see #getBainHashmashosYereim3Point05Degrees ()
420
420
*/
421
421
protected static final double ZENITH_MINUS_3_POINT_05 = GEOMETRIC_ZENITH - 3.05 ;
422
422
@@ -1847,7 +1847,7 @@ public Date getMinchaGedolaAhavatShalom() {
1847
1847
* {@link #getMinchaGedola30Minutes()}. In the winter when 1/2 of a {@link #getShaahZmanisGra() <em>shaah zmanis</em>} is
1848
1848
* less than 30 minutes {@link #getMinchaGedola30Minutes()} will be returned, otherwise {@link #getMinchaGedola()}
1849
1849
* will be returned.
1850
- *
1850
+ *
1851
1851
* @return the <code>Date</code> of the later of {@link #getMinchaGedola()} and {@link #getMinchaGedola30Minutes()}.
1852
1852
* If the calculation can't be computed such as in the Arctic Circle where there is at least one day a year
1853
1853
* where the sun does not rise, and one where it does not set, a null will be returned. See detailed
@@ -2241,7 +2241,7 @@ public Date getPlagAhavatShalom() {
2241
2241
/**
2242
2242
* Method to return the beginning of <em>bain hashmashos</em> of Rabbeinu Tam calculated when the sun is
2243
2243
* {@link #ZENITH_13_POINT_24 13.24°} below the western {@link #GEOMETRIC_ZENITH geometric horizon} (90°)
2244
- * after sunset. This calculation is based on the same calculation of {@link #getBainHasmashosRT58Point5Minutes ()
2244
+ * after sunset. This calculation is based on the same calculation of {@link #getBainHashmashosRT58Point5Minutes ()
2245
2245
* <em>bain hashmashos</em> Rabbeinu Tam 58.5 minutes} but uses a degree-based calculation instead of 58.5 exact
2246
2246
* minutes. This calculation is based on the position of the sun 58.5 minutes after sunset in Jerusalem <a href=
2247
2247
* "https://kosherjava.com/2022/01/12/equinox-vs-equilux-zmanim-calculations/">around the equinox / equilux</a>,
@@ -2260,11 +2260,21 @@ public Date getPlagAhavatShalom() {
2260
2260
* {@link AstronomicalCalendar} documentation.
2261
2261
*
2262
2262
* @see #ZENITH_13_POINT_24
2263
- * @see #getBainHasmashosRT58Point5Minutes ()
2263
+ * @see #getBainHashmashosRT58Point5Minutes ()
2264
2264
*/
2265
- public Date getBainHasmashosRT13Point24Degrees () {
2265
+ public Date getBainHashmashosRT13Point24Degrees () {
2266
2266
return getSunsetOffsetByDegrees (ZENITH_13_POINT_24 );
2267
2267
}
2268
+
2269
+
2270
+ /**
2271
+ * Misspelled method name that should be {@link #getBainHashmashosRT13Point24Degrees()}.
2272
+ * @return the properly spelled version.
2273
+ */
2274
+ @ Deprecated // (forRemoval=true) // add back once Java 9 is the minimum supported version
2275
+ public Date getBainHasmashosRT13Point24Degrees () {
2276
+ return getBainHashmashosRT13Point24Degrees ();
2277
+ }
2268
2278
2269
2279
/**
2270
2280
* This method returns the beginning of <em>Bain hashmashos</em> of Rabbeinu Tam calculated as a 58.5
@@ -2277,9 +2287,18 @@ public Date getBainHasmashosRT13Point24Degrees() {
2277
2287
* documentation.
2278
2288
*
2279
2289
*/
2280
- public Date getBainHasmashosRT58Point5Minutes () {
2290
+ public Date getBainHashmashosRT58Point5Minutes () {
2281
2291
return getTimeOffset (getElevationAdjustedSunset (), 58.5 * MINUTE_MILLIS );
2282
2292
}
2293
+
2294
+ /**
2295
+ * Misspelled method name that should be {@link #getBainHashmashosRT58Point5Minutes()}.
2296
+ * @return the properly spelled version.
2297
+ */
2298
+ @ Deprecated // (forRemoval=true) // add back once Java 9 is the minimum supported version
2299
+ public Date getBainHasmashosRT58Point5Minutes () {
2300
+ return getBainHashmashosRT58Point5Minutes ();
2301
+ }
2283
2302
2284
2303
/**
2285
2304
* This method returns the beginning of <em>bain hashmashos</em> based on the calculation of 13.5 minutes (3/4 of an
@@ -2292,9 +2311,18 @@ public Date getBainHasmashosRT58Point5Minutes() {
2292
2311
* documentation.
2293
2312
* @see #getTzaisGeonim7Point083Degrees()
2294
2313
*/
2295
- public Date getBainHasmashosRT13Point5MinutesBefore7Point083Degrees () {
2314
+ public Date getBainHashmashosRT13Point5MinutesBefore7Point083Degrees () {
2296
2315
return getTimeOffset (getSunsetOffsetByDegrees (ZENITH_7_POINT_083 ), -13.5 * MINUTE_MILLIS );
2297
2316
}
2317
+
2318
+ /**
2319
+ * Misspelled method name that should be {@link #getBainHashmashosRT13Point5MinutesBefore7Point083Degrees()}.
2320
+ * @return the properly spelled version.
2321
+ */
2322
+ @ Deprecated // (forRemoval=true) // add back once Java 9 is the minimum supported version
2323
+ public Date getBainHasmashosRT13Point5MinutesBefore7Point083Degrees () {
2324
+ return getBainHashmashosRT13Point5MinutesBefore7Point083Degrees ();
2325
+ }
2298
2326
2299
2327
/**
2300
2328
* This method returns the beginning of <em>bain hashmashos</em> of Rabbeinu Tam calculated according to the
@@ -2308,16 +2336,24 @@ public Date getBainHasmashosRT13Point5MinutesBefore7Point083Degrees() {
2308
2336
* calculation, a null will be returned. See detailed explanation on top of the {@link AstronomicalCalendar}
2309
2337
* documentation.
2310
2338
*/
2311
- public Date getBainHasmashosRT2Stars () {
2339
+ public Date getBainHashmashosRT2Stars () {
2312
2340
Date alos19Point8 = getAlos19Point8Degrees ();
2313
2341
Date sunrise = getElevationAdjustedSunrise ();
2314
2342
if (alos19Point8 == null || sunrise == null ) {
2315
2343
return null ;
2316
2344
}
2317
-
2318
2345
return getTimeOffset (getElevationAdjustedSunset (), (sunrise .getTime () - alos19Point8 .getTime ()) * (5 / 18d ));
2319
2346
}
2320
2347
2348
+ /**
2349
+ * Misspelled method name that should be {@link #getBainHashmashosRT2Stars()}.
2350
+ * @return the properly spelled version.
2351
+ */
2352
+ @ Deprecated // (forRemoval=true) // add back once Java 9 is the minimum supported version
2353
+ public Date getBainHasmashosRT2Stars () {
2354
+ return getBainHashmashosRT2Stars ();
2355
+ }
2356
+
2321
2357
/**
2322
2358
* This method returns the beginning of <em>bain hashmashos</em> (twilight) according to the <a href=
2323
2359
* "https://en.wikipedia.org/wiki/Eliezer_ben_Samuel">Yereim (Rabbi Eliezer of Metz)</a> calculated as 18 minutes
@@ -2328,12 +2364,21 @@ public Date getBainHasmashosRT2Stars() {
2328
2364
* Arctic Circle where there is at least one day a year where the sun does not rise, and one where it does
2329
2365
* not set, a null will be returned. See detailed explanation on top of the {@link AstronomicalCalendar}
2330
2366
* documentation.
2331
- * @see #getBainHasmashosYereim3Point05Degrees ()
2367
+ * @see #getBainHashmashosYereim3Point05Degrees ()
2332
2368
*/
2333
- public Date getBainHasmashosYereim18Minutes () {
2369
+ public Date getBainHashmashosYereim18Minutes () {
2334
2370
return getTimeOffset (getElevationAdjustedSunset (), -18 * MINUTE_MILLIS );
2335
2371
}
2336
2372
2373
+ /**
2374
+ * Misspelled method name that should be {@link #getBainHashmashosYereim18Minutes()}.
2375
+ * @return the properly spelled version.
2376
+ */
2377
+ @ Deprecated // (forRemoval=true) // add back once Java 9 is the minimum supported version
2378
+ public Date getBainHasmashosYereim18Minutes () {
2379
+ return getBainHashmashosYereim18Minutes ();
2380
+ }
2381
+
2337
2382
/**
2338
2383
* This method returns the beginning of <em>bain hashmashos</em> (twilight) according to the <a href=
2339
2384
* "https://en.wikipedia.org/wiki/Eliezer_ben_Samuel">Yereim (Rabbi Eliezer of Metz)</a> calculated as the sun's
@@ -2359,14 +2404,24 @@ public Date getBainHasmashosYereim18Minutes() {
2359
2404
* {@link AstronomicalCalendar} documentation.
2360
2405
*
2361
2406
* @see #ZENITH_MINUS_3_POINT_05
2362
- * @see #getBainHasmashosYereim18Minutes ()
2363
- * @see #getBainHasmashosYereim2Point8Degrees ()
2364
- * @see #getBainHasmashosYereim2Point1Degrees ()
2407
+ * @see #getBainHashmashosYereim18Minutes ()
2408
+ * @see #getBainHashmashosYereim2Point8Degrees ()
2409
+ * @see #getBainHashmashosYereim2Point1Degrees ()
2365
2410
*/
2366
- public Date getBainHasmashosYereim3Point05Degrees () {
2411
+ public Date getBainHashmashosYereim3Point05Degrees () {
2367
2412
return getSunsetOffsetByDegrees (ZENITH_MINUS_3_POINT_05 );
2368
2413
}
2369
2414
2415
+ /**
2416
+ * Misspelled method name that should be {@link #getBainHashmashosYereim3Point05Degrees()}.
2417
+ * @return the properly spelled version.
2418
+ */
2419
+ @ Deprecated // (forRemoval=true) // add back once Java 9 is the minimum supported version
2420
+ public Date getBainHasmashosYereim3Point05Degrees () {
2421
+ return getBainHashmashosYereim3Point05Degrees ();
2422
+ }
2423
+
2424
+
2370
2425
/**
2371
2426
* This method returns the beginning of <em>bain hashmashos</em> (twilight) according to the <a href=
2372
2427
* "https://en.wikipedia.org/wiki/Eliezer_ben_Samuel">Yereim (Rabbi Eliezer of Metz)</a> calculated as 16.875
@@ -2378,12 +2433,21 @@ public Date getBainHasmashosYereim3Point05Degrees() {
2378
2433
* not set, a null will be returned. See detailed explanation on top of the {@link AstronomicalCalendar}
2379
2434
* documentation.
2380
2435
*
2381
- * @see #getBainHasmashosYereim2Point8Degrees ()
2436
+ * @see #getBainHashmashosYereim2Point8Degrees ()
2382
2437
*/
2383
- public Date getBainHasmashosYereim16Point875Minutes () {
2438
+ public Date getBainHashmashosYereim16Point875Minutes () {
2384
2439
return getTimeOffset (getElevationAdjustedSunset (), -16.875 * MINUTE_MILLIS );
2385
2440
}
2386
2441
2442
+ /**
2443
+ * Misspelled method name that should be {@link #getBainHashmashosYereim16Point875Minutes()}.
2444
+ * @return the properly spelled version.
2445
+ */
2446
+ @ Deprecated // (forRemoval=true) // add back once Java 9 is the minimum supported version
2447
+ public Date getBainHasmashosYereim16Point875Minutes () {
2448
+ return getBainHashmashosYereim16Point875Minutes ();
2449
+ }
2450
+
2387
2451
/**
2388
2452
* This method returns the beginning of <em>bain hashmashos</em> (twilight) according to the <a href=
2389
2453
* "https://en.wikipedia.org/wiki/Eliezer_ben_Samuel">Yereim (Rabbi Eliezer of Metz)</a> calculated as the sun's
@@ -2392,22 +2456,32 @@ public Date getBainHasmashosYereim16Point875Minutes() {
2392
2456
* its position 16.875 minutes or 3/4 of an 18-minute <em>Mil</em> before sunset. According to the Yereim, <em>bain
2393
2457
* hashmashos</em> starts 3/4 of a <em>Mil</em> before sunset and <em>tzais</em> or nightfall starts at sunset.
2394
2458
* Details, including how the degrees were calculated can be seen in the documentation of
2395
- * {@link #getBainHasmashosYereim3Point05Degrees ()}.
2459
+ * {@link #getBainHashmashosYereim3Point05Degrees ()}.
2396
2460
*
2397
2461
* @return the <code>Date</code> of the sun's position 2.8° minutes before sunset. If the calculation can't
2398
2462
* be computed such as in the Arctic Circle where there is at least one day a year where the sun does not
2399
2463
* rise, and one where it does not set, a null will be returned. See detailed explanation on top of the
2400
2464
* {@link AstronomicalCalendar} documentation.
2401
2465
*
2402
2466
* @see #ZENITH_MINUS_2_POINT_8
2403
- * @see #getBainHasmashosYereim16Point875Minutes ()
2404
- * @see #getBainHasmashosYereim3Point05Degrees ()
2405
- * @see #getBainHasmashosYereim2Point1Degrees ()
2467
+ * @see #getBainHashmashosYereim16Point875Minutes ()
2468
+ * @see #getBainHashmashosYereim3Point05Degrees ()
2469
+ * @see #getBainHashmashosYereim2Point1Degrees ()
2406
2470
*/
2407
- public Date getBainHasmashosYereim2Point8Degrees () {
2471
+ public Date getBainHashmashosYereim2Point8Degrees () {
2408
2472
return getSunsetOffsetByDegrees (ZENITH_MINUS_2_POINT_8 );
2409
2473
}
2410
2474
2475
+ /**
2476
+ * Misspelled method name that should be {@link #getBainHashmashosYereim2Point8Degrees()}.
2477
+ * @return the properly spelled version.
2478
+ */
2479
+ @ Deprecated // (forRemoval=true) // add back once Java 9 is the minimum supported version
2480
+ public Date getBainHasmashosYereim2Point8Degrees () {
2481
+ return getBainHashmashosYereim2Point8Degrees ();
2482
+ }
2483
+
2484
+
2411
2485
/**
2412
2486
* This method returns the beginning of <em>bain hashmashos</em> (twilight) according to the <a href=
2413
2487
* "https://en.wikipedia.org/wiki/Eliezer_ben_Samuel">Yereim (Rabbi Eliezer of Metz)</a> calculated as 13.5 minutes
@@ -2419,12 +2493,21 @@ public Date getBainHasmashosYereim2Point8Degrees() {
2419
2493
* not set, a null will be returned. See detailed explanation on top of the {@link AstronomicalCalendar}
2420
2494
* documentation.
2421
2495
*
2422
- * @see #getBainHasmashosYereim2Point1Degrees ()
2496
+ * @see #getBainHashmashosYereim2Point1Degrees ()
2423
2497
*/
2424
- public Date getBainHasmashosYereim13Point5Minutes () {
2498
+ public Date getBainHashmashosYereim13Point5Minutes () {
2425
2499
return getTimeOffset (getElevationAdjustedSunset (), -13.5 * MINUTE_MILLIS );
2426
2500
}
2427
2501
2502
+ /**
2503
+ * Misspelled method name that should be {@link #getBainHashmashosYereim13Point5Minutes()}.
2504
+ * @return the properly spelled version.
2505
+ */
2506
+ @ Deprecated // (forRemoval=true) // add back once Java 9 is the minimum supported version
2507
+ public Date getBainHasmashosYereim13Point5Minutes () {
2508
+ return getBainHashmashosYereim13Point5Minutes ();
2509
+ }
2510
+
2428
2511
/**
2429
2512
* This method returns the beginning of <em>bain hashmashos</em> according to the <a href=
2430
2513
* "https://en.wikipedia.org/wiki/Eliezer_ben_Samuel">Yereim (Rabbi Eliezer of Metz)</a> calculated as the sun's
@@ -2433,22 +2516,31 @@ public Date getBainHasmashosYereim13Point5Minutes() {
2433
2516
* Yerushalayim, its position 13.5 minutes or 3/4 of an 18-minute <em>Mil</em> before sunset. According to the Yereim,
2434
2517
* <em>bain hashmashos</em> starts 3/4 of a <em>mil</em> before sunset and <em>tzais</em> or nightfall starts at sunset.
2435
2518
* Details, including how the degrees were calculated can be seen in the documentation of
2436
- * {@link #getBainHasmashosYereim3Point05Degrees ()}.
2519
+ * {@link #getBainHashmashosYereim3Point05Degrees ()}.
2437
2520
*
2438
2521
* @return the <code>Date</code> of the sun's position 2.1° minutes before sunset. If the calculation can't
2439
2522
* be computed such as in the Arctic Circle where there is at least one day a year where the sun does not
2440
2523
* rise, and one where it does not set, a null will be returned. See detailed explanation on top of the
2441
2524
* {@link AstronomicalCalendar} documentation.
2442
2525
*
2443
2526
* @see #ZENITH_MINUS_2_POINT_1
2444
- * @see #getBainHasmashosYereim13Point5Minutes ()
2445
- * @see #getBainHasmashosYereim2Point8Degrees ()
2446
- * @see #getBainHasmashosYereim3Point05Degrees ()
2527
+ * @see #getBainHashmashosYereim13Point5Minutes ()
2528
+ * @see #getBainHashmashosYereim2Point8Degrees ()
2529
+ * @see #getBainHashmashosYereim3Point05Degrees ()
2447
2530
*/
2448
- public Date getBainHasmashosYereim2Point1Degrees () {
2531
+ public Date getBainHashmashosYereim2Point1Degrees () {
2449
2532
return getSunsetOffsetByDegrees (ZENITH_MINUS_2_POINT_1 );
2450
2533
}
2451
2534
2535
+ /**
2536
+ * Misspelled method name that should be {@link #getBainHashmashosYereim2Point1Degrees()}.
2537
+ * @return the properly spelled version.
2538
+ */
2539
+ @ Deprecated // (forRemoval=true) // add back once Java 9 is the minimum supported version
2540
+ public Date getBainHasmashosYereim2Point1Degrees () {
2541
+ return getBainHashmashosYereim2Point1Degrees ();
2542
+ }
2543
+
2452
2544
/**
2453
2545
* This method returns the <em>tzais</em> (nightfall) based on the opinion of the <em>Geonim</em> calculated at the
2454
2546
* sun's position at {@link #ZENITH_3_POINT_7 3.7°} below the western horizon.
@@ -3904,7 +3996,6 @@ public Date getSofZmanBiurChametzBaalHatanya() {
3904
3996
* sea level solar hours} after {@link #getSunriseBaalHatanya() <em>netz amiti</em> (sunrise)}. This calculation is based
3905
3997
* on the opinion of the Baal Hatanya that the day is calculated from sunrise to sunset. This returns the time 6.5
3906
3998
* * {@link #getShaahZmanisBaalHatanya()} after {@link #getSunriseBaalHatanya() <em>netz amiti</em> ("real" sunrise)}.
3907
- *
3908
3999
* @see #getMinchaGedola(Date, Date)
3909
4000
* @see #getShaahZmanisBaalHatanya()
3910
4001
* @see #getMinchaKetanaBaalHatanya()
@@ -4153,7 +4244,7 @@ public Date getSofZmanTfilaGRASunriseToFixedLocalChatzos() {
4153
4244
* in the Arctic Circle where there is at least one day a year where the sun does not rise, and one where it
4154
4245
* does not set, a null will be returned. See detailed explanation on top of the {@link AstronomicalCalendar}
4155
4246
* documentation.
4156
- *
4247
+ *
4157
4248
* @see #getMinchaGedola()
4158
4249
* @see #getFixedLocalChatzos()
4159
4250
* @see #getMinchaKetanaGRAFixedLocalChatzosToSunset
0 commit comments