Open rosennej opened 5 years ago
about 2: See the other new issue for better documentation. I agree that the documentation should avoid the term "civil day". It is not related to banking days in Israel.
about 1: Thank you very much for your offer. I know at least following sources for holiday handling:
Here the general question arises if we might choose a new module for holidays which depends on Time4J-base. Main reason is that it might require more frequent updating - not so much for Jewish holidays but for holidays in any countries. The new module would be like a database which is open for frequent additions and changes. It would manage different types and validities of holidays in countries or regions. We also have the interface net.time4j.range.HolidayModel
which should be implemented by Jewish holidays.
However, contributors for such an updatable holiday module are very welcome. I am not sure if there will be enough contributors willing to contribute changes.
What was the intended meaning of "civil day"?
From: Meno Hochschild [mailto:notifications@github.com] Sent: Monday, May 27, 2019 12:54 PM To: MenoData/Time4J Cc: Jonathan Rosenne; Author Subject: Re: [MenoData/Time4J] Hebrew calendar and Jewish holidays, (#872)
about 2: See the other new issue for better documentation. I agree that the documentation should avoid the term "civil day". It is not related to banking days in Israel.
about 1: Thank you very much for your offer. I know at least following sources for holiday handling:
Here the general question arises if we might choose a new module for holidays which depends on Time4J-base. Main reason is that it might require more frequent updating - not so much for Jewish holidays but for holidays in any countries. The new module would be like a database which is open for frequent additions and changes. It would manage different types and validities of holidays in countries or regions. We also have the interface net.time4j.range.HolidayModel which should be implemented by Jewish holidays.
However, contributors for such an updatable holiday module are very welcome. I am not sure if there will be enough contributors willing to contribute changes.
— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHubhttps://github.com/MenoData/Time4J/issues/872?email_source=notifications&email_token=ACFKVDMVU4KOWYAXHUF5MZLPXOVVBA5CNFSM4HPXKEE2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGODWJLTQI#issuecomment-496155073, or mute the threadhttps://github.com/notifications/unsubscribe-auth/ACFKVDIOZ25U44PVYAKECOTPXOVVBANCNFSM4HPXKEEQ.
It was just my faulty oversimplification. "civil" = "non religious" with the consequence that the exact time of evening is not important. Anyway, if a user does not pass any start-of-day-parameter then Time4J can only guess, and 18:00 is a (rough) approximation which works best near the equator. The documentation should explain this behaviour explicitly using the word "approximation".
By the way, if we go down to minutes or even seconds (a little bit questionable in context of possible accuracy of astronomic calculations) then some religious Jews even seem to make strict differences betwen various sunset- and nightfall-definitions, see for example: https://www.yeshiva.co/ask/?id=7469
The same applies to Hijri, AFAIK. For example, what to do you when you are in Iceland in the summer or the winter?
From: Meno Hochschild [mailto:notifications@github.com] Sent: Tuesday, May 28, 2019 1:59 PM To: MenoData/Time4J Cc: Jonathan Rosenne; Author Subject: Re: [MenoData/Time4J] Hebrew calendar and Jewish holidays, (#872)
It was just my faulty oversimplification. "civil" = "non religious" with the consequence that the exact time of evening is not important. Anyway, if a user does not pass any start-of-day-parameter then Time4J can only guess, and 18:00 is a (rough) approximation which works best near the equator. The documentation should explain this behaviour explicitly using the word "approximation".
By the way, if we go down to minutes or even seconds (a little bit questionable in context of possible accuracy of astronomic calculations) then some religious Jews even seem to make strict differences betwen various sunset- and nightfall-definitions, see for example: https://www.yeshiva.co/ask/?id=7469
— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHubhttps://github.com/MenoData/Time4J/issues/872?email_source=notifications&email_token=ACFKVDMDO44XZCS574C3M63PXUF7ZA5CNFSM4HPXKEE2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGODWLYEJI#issuecomment-496468517, or mute the threadhttps://github.com/notifications/unsubscribe-auth/ACFKVDI6E5TY6QHED6IX4QTPXUF7ZANCNFSM4HPXKEEQ.
Users should pass a StartOfDay
-Parameter with the appropriate geographic location for achieving best results, equal if Hijri or Hebrew calendar. Such methods and related API already exist, but maybe the documentation should be more expressive about it.
Oh, and when applied to polar regions which don't observe sunset at all in summer then only conventions like setting the geographic latitude to 60° N might help (as some religous authorities have suggested as compromise). This can be done, too, by passing an appropriate StartOfDay
-definition. The user has all freedom.