Our great sponsors
-
calendar
📅 PHP Date & Time library that solves common problems in object oriented, immutable way. (by aeon-php)
-
WorkOS
The modern identity platform for B2B SaaS. The APIs are flexible and easy-to-use, supporting authentication, user identity, and complex enterprise features like SSO and SCIM provisioning.
Hey, We are planning to release version 1.0 with long term support of https://github.com/aeon-php/calendar library and we thought it's a good time to ask for some feedback. How this library is different from other great libraries available in the wild? The main difference is that it does not extend \DateTime or \DateTimeImmutable, but instead it provides own fully immutable DateTime replacement. Why? There are few reasons but the most important one is to provide better and safer, Object Oriented API to work with DateTime/Date/Time/TimeZone/TimeUnit and TimePeriods. Safer means that the whole library API is designed to expose commonly misunderstood concepts and make them explicit, like for example adding month to given date expects to precisely define number of days DateTime::add(TimeUnit::days(30)); as a TimeUnit instance or use relative time unit DateTime::add(RelativeTimeUnit::month()); Calendar is the core library and it comes with few extra things like support for LeapSeconds, different Time Epoch (TAI, GPS), TimePeriods (iterating, overlapping, merging, finding gaps, sorting etc) or precise time measurement. There are few more libraries built on top of calendar, like for example Business Hours, Holidays (which is just an abstraction and bridge for other libraries), Rate Limiter, Retry but they all waits for the the calendar to be stabilized. You can find them here https://github.com/aeon-php