Description:

annual 0.1.3

annual








Synopsis
The Python package annual provides date calculations
with human-readable expressions.
Prerequisites
Before you begin, ensure you have met the following requirements:

You have installed Python 3.11 or later.
annual is compatible with Python 3.11+.
You have a basic understanding of Python programming.
(Optional) For development: You have git installed for version control.

Installation
annual can be installed using pip.
To install annual, follow these steps:

Open your terminal (Command Prompt on Windows).
Run the following command:

pip install annual

Usage
The simplest way of using this package is invoking the rule parser
directly. The following example shows how to compute the second
monday in October for the year 2024.
>>> from annual.ruleparser import rule_parser
>>> rule_parser(2024).parse('2nd monday of october')
datetime.date(2024, 10, 14)

For a full overview of the syntax supported by the rule parser
consult the Syntax Guide.
Additional Documentation
For more detailed information about DateCalc, please refer to our comprehensive documentation:


User Guide: For in-depth explanations of annual's features and how to use them effectively, visit our User Guide.


API Reference: For detailed information about annual's classes, methods, and functions, check out our API Reference.


Tutorials: To get started quickly with practical examples, see our Tutorials.


FAQ: For answers to commonly asked questions, visit our FAQ page.


Contributing: If you're interested in contributing to annual,
please read our Contribution Guidelines.


Our documentation is hosted on Read the Docs and is kept up-to-date
with each release. You can find the full documentation at:
https://annual.readthedocs.io
If you can't find the information you're looking for, please open an issue on our GitHub repository. We're always looking to improve our documentation and appreciate your feedback!
License
This package is released under the terms of the MIT License.
Related Libraries

dateutil: extensions to the standard Python datetime module
Delorean: library for manipulating datetimes with ease and clarity
dateparser: date parsing library designed to parse dates from HTML pages
workalendar: worldwide holidays and working days helper and toolkit
convertdate: converts between Gregorian dates and other calendar systems

License

For personal and professional use. You cannot resell or redistribute these repositories in their original state.

Share

• Share on Facebook
• Share on Twitter