This software provides a DateTime Extension for the traditional Japanese calendar, allowing users to display dates in both the Gregorian and Japanese calendars. It includes support for Japanese eras and leap years, as well as the ability to convert dates between the two calendars.
The DateTime::Calendar::Japanese module goes above and beyond the basics of the traditional Japanese Calendar. It includes a simple time system used in the Edo period. The time system is based on the sunrise and sunset, making it unique and appropriate for those studying the history of Japan.
To begin implementing the DateTime::Calendar::Japanese module, use the SYNOPSIS code as a guide. The code includes examples of how to construct and create DT::C::Japanese object instances either using the Chinese hexagecimal cycle system or the era system.
Once you’ve created your object using either of these two methods, you can retrieve specific information about the time and date. Extract cycle, cycle year, era-year, month, leap month, and day from the object. You can also retrieve information about the era itself from the era object.
Finally, two additional attributes that you can access are the hour and hour quarter. The canonical hour represents the total number of hours since midnight, whereas the hour quarter records how many quarter-hours have elapsed since the most recent sunrise.
Overall, the DateTime::Calendar::Japanese module is a comprehensive tool for handling the traditional Japanese Calendar. Its support for the Edo period's time system is a bonus, making it an even more valuable resource for those interested in Japanese history.
Version 0.06001: N/A