https://github.com/pity7736/workingless

Holidays and working days calculations.
https://github.com/pity7736/workingless

holidays working-days

Last synced: 7 months ago
JSON representation

Holidays and working days calculations.

• Host: GitHub
• URL: https://github.com/pity7736/workingless
• Owner: pity7736
• License: lgpl-3.0
• Created: 2020-01-30T00:15:42.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2021-02-09T03:02:50.000Z (over 4 years ago)
• Last Synced: 2025-02-03T18:11:42.370Z (8 months ago)
• Topics: holidays, working-days
• Language: Python
• Homepage: https://workingless.readthedocs.io/en/latest/?badge=latest
• Size: 77.1 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

          
===========

Workingless

===========

.. image:: https://readthedocs.org/projects/workingless/badge/?version=latest

    :target: https://workingless.readthedocs.io/en/latest/?badge=latest

    :alt: Documentation Status

.. image:: https://circleci.com/gh/pity7736/workingless.svg?style=shield

    :target: https://circleci.com/gh/pity7736/workingless

Workingless is a lib for holidays calculations. Currently it supports Colombia

and Mexico (beta) holidays.

`See full documentation `_.

Usage

-----

Workingless has four methods for the countries supported, they are:

``get_holidays_from_year``, ``is_holiday``, ``is_working_day`` and ``get_next_working_day``.

Example usage:

.. code-block:: python

    import datetime

    from workingless import countries

    colombia = countries.COL()

    holidays = colombia.get_holidays_from_year(year=2020)

    print(type(holidays))  # 

    print(list(holidays))

    # result:

    # [

    #     datetime.date(2020, 1, 1),

    #     datetime.date(2020, 1, 6),

    #     datetime.date(2020, 3, 23),

    #     datetime.date(2020, 4, 5),

    #     datetime.date(2020, 4, 9),

    #     datetime.date(2020, 4, 10),

    #     datetime.date(2020, 4, 12),

    #     datetime.date(2020, 5, 1),

    #     datetime.date(2020, 5, 25),

    #     datetime.date(2020, 6, 15),

    #     datetime.date(2020, 6, 22),

    #     datetime.date(2020, 6, 29),

    #     datetime.date(2020, 7, 20),

    #     datetime.date(2020, 8, 7),

    #     datetime.date(2020, 8, 17),

    #     datetime.date(2020, 10, 12),

    #     datetime.date(2020, 11, 2),

    #     datetime.date(2020, 11, 16),

    #     datetime.date(2020, 12, 8),

    #     datetime.date(2020, 12, 25)

    # ]

    colombia.is_holiday(date=datetime.date(2020, 1, 1))  # True

    colombia.is_working_day(datetime.date(2020, 1, 1)  # False

    colombia.get_next_working_day(datetime.date(2020, 1, 1)  # datetime.date(2020, 1, 2)

License

-------

Distributed under the terms of the LGPLv3 license.

See `license `_.