Jollyday
A Java library for calculating holidays and public holidays across different countries and regions.
What is Jollyday?
Jollyday is a Java library designed to calculate holidays and public holidays for various countries and regions. It provides accurate date calculations based on configurable rules that account for different calendar systems, religious observances, and local regulations. The library helps developers integrate holiday logic into applications without manually managing complex date rules.
Java developers building applications that require holiday-aware scheduling, such as financial systems, payroll software, event planning tools, or international business applications.
Developers choose Jollyday for its comprehensive country coverage, flexible configuration via XML, and support for complex holiday rules. It eliminates the need to manually implement and maintain holiday logic, saving development time and ensuring accuracy across different regions.
Overview
Jollyday - A holiday API
Use Cases
Best For
- Calculating payroll dates in multinational companies
- Scheduling business operations around public holidays
- Building financial applications with holiday-aware interest calculations
- Creating event management systems that avoid holiday conflicts
- Developing travel or hospitality platforms that consider local holidays
- Implementing compliance features for regional business regulations
Not Ideal For
- Projects requiring real-time, dynamic holiday updates without application redeployment, as configurations are static XML files.
- Teams prioritizing minimal dependencies or programmatic APIs over XML-based configuration for holiday management.
- Non-Java ecosystems, since it is a Java-specific library with no cross-language support.
Pros & Cons
Pros
Supports holidays for numerous countries and subdivisions via XML configurations, ideal for global applications like payroll or scheduling systems.
Handles complex holiday rules including movable dates and lunar-based observances, ensuring accuracy for diverse cultural and regional requirements.
Offers versions compatible with both Joda-Time and Java Time API, providing flexibility for different Java project setups and future-proofing.
Uses XML files to separate holiday definitions from logic, allowing easy customization and addition of new regions without modifying core code.
Cons
The planned 0.6 branch will replace JAXB with JiBX/XStream, necessitating migration efforts and potential disruptions for existing users.
Customizing holidays requires editing XML files, which can be error-prone and less intuitive than a programmatic API, especially for developers unfamiliar with the schema.
With separate branches for Joda-Time and Java Time API, developers must carefully choose and maintain the correct version, adding complexity to dependency management.
Frequently Asked Questions
Related Projects
iCal4jA Java library for parsing and building iCalendar data models
Time4JAdvanced date, time and interval library for Java with sun/moon-astronomy and calendars like Chinese, Coptic, Ethiopian, French Republican, Hebrew, Hijri, Historic Christian, Indian National, Japanese, Julian, Korean, Minguo, Persian, Thai, Vietnamese
ThreeTen-ExtraProvides additional date-time classes that complement those in JDK 8
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.