https://github.com/KosherJava/zmanim
KosherJava Zmanim API / Library
https://github.com/KosherJava/zmanim
calendars daf-yomi dawn dusk hebrew-calendar hebrew-date java jewish jewish-holidays judaism parsha sunrise sunset yahrzeit zman zmanim
Last synced: 9 months ago
JSON representation
KosherJava Zmanim API / Library
- Host: GitHub
- URL: https://github.com/KosherJava/zmanim
- Owner: KosherJava
- License: lgpl-2.1
- Created: 2015-08-30T16:29:27.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2025-01-01T17:12:08.000Z (12 months ago)
- Last Synced: 2025-01-01T17:21:53.046Z (12 months ago)
- Topics: calendars, daf-yomi, dawn, dusk, hebrew-calendar, hebrew-date, java, jewish, jewish-holidays, judaism, parsha, sunrise, sunset, yahrzeit, zman, zmanim
- Language: Java
- Homepage: https://kosherjava.com
- Size: 1.2 MB
- Stars: 108
- Watchers: 14
- Forks: 51
- Open Issues: 25
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-jewish-github - KosherJava/zmanim - KosherJava Zmanim API / Library (Projects / Zmanim)
README
KosherJava Zmanim API
=====================
The Zmanim library is an API for a specialized calendar that can calculate different astronomical
times including sunrise and sunset and Jewish _zmanim_ or religious times for prayers and other
Jewish religious duties.
These classes extend GregorianCalendar and can therefore
use the standard Calendar functionality to change dates etc. For non religious astronomical / solar
calculations use the [AstronomicalCalendar](./src/main/java/com/kosherjava/zmanim/AstronomicalCalendar.java).
The ZmanimCalendar contains the most common zmanim or religious time calculations. For a much more
extensive list of _zmanim_ use the ComplexZmanimCalendar.
This class contains the main functionality of the Zmanim library.
For a basic set of instructions on the use of the API, see [How to Use the Zmanim API](https://kosherjava.com/zmanim-project/how-to-use-the-zmanim-api/), [zmanim code samples](https://kosherjava.com/tag/code-sample/) and the [KosherJava FAQ](https://kosherjava.com/tag/faq/). See the KosherJava Zmanim site for additional information.
# Get Started
To add KosherJava as a dependency to your project, add the following dependency:
#### Maven
Add the following to your `pom.xml` file:
```xml
com.kosherjava
zmanim
2.5.0
```
#### Gradle
Add the following to your `build.gradle` file:
```groovy
implementation group: 'com.kosherjava', name: 'zmanim', version: '2.5.0'
```
Or if you have `build.gradle.kts` file:
```kotlin
implementation("com.kosherjava:zmanim:2.5.0")
```
License
-------
The library is released under the [LGPL 2.1 license](https://kosherjava.com/2011/05/09/kosherjava-zmanim-api-released-under-the-lgpl-license/).
Ports to Other Languages
------------------------
The KosherJava Zmanim API has been ported to:
* Swift - https://github.com/Elyahu41/KosherSwift & https://github.com/DanielSmith1239/KosherSwift
* Objective-C - https://github.com/MosheBerman/KosherCocoa
* .NET - https://github.com/Yitzchok/Zmanim
* TypeScript - https://github.com/BehindTheMath/KosherZmanim
* JavaScript - https://github.com/yparitcher/zmanJS
* Kotlin - https://github.com/Sternbach-Software/KosherKotlin
* Ruby - https://github.com/pinnymz/ruby-zmanim
* Scala - https://github.com/nafg/jewish-date
* C - https://github.com/yparitcher/libzmanim
* Python - https://github.com/pinnymz/python-zmanim & https://pypi.org/project/zmanim/
* PHP - https://github.com/zachweix/PhpZmanim/
* Dart / Flutter - https://github.com/yakir8/kosher_dart
* Go - https://github.com/vlipovetskii/go-zmanim
* SQL - https://github.com/BehindTheMath/zmanim-sql (alpha quality).
* VB6/VBA (Visual Basic) - https://github.com/diaphone1/vbzmanim
ZmanCode Desktop App
------------------------
The .NET port was used to create a desktop app that is available at https://github.com/NykUser/MyZman.
Disclaimer:
-----------
__While I did my best to get accurate results, please double check before relying on these zmanim for halacha lemaaseh__.
------------------------
[](https://search.maven.org/artifact/com.kosherjava/zmanim)
[](https://github.com/KosherJava/zmanim/blob/master/LICENSE)
[](https://github.com/KosherJava/zmanim/commits/master)
[](https://github.com/KosherJava/zmanim/actions/workflows/codeql-analysis.yml)
[](https://github.com/KosherJava/zmanim/actions/workflows/pull_request_worklow.yml)