workalendar

v16.3.0 was released on 2022-02-22 (hey! a palindromic date!)

New calendars

• New calendar: Added Georgia (country) calendar by @atj01 (#687).
• New calendar: Added Kazakhstan calendar by @atj01 (#688).
• New calendar: Added USA Federal Reserve System calendar by @ludsoft (#695)

Bugfixes and other changes

• Removed duplicate Proclamation Day for Latvia, by @Daglina (#686).
• Documentation: Fix the keep_datetime usage example in the "basic" doc (#690).
• Added conditional holidays on 26th December and 2nd January in Neuchatel (Switzerland) (#697).
• Added Federal Thanksgiving Monday and two conditional holidays on 26th December and 2nd January in Neuchatel (Switzerland) (#697).

v16.2.0 was released on 2021-12-10.

Change

• Update China's public holidays for 2022, thx to @iamsk (#693).

The v16.1.0 was released on 2021-10-01

• Fixed United Kingdom's 2022 holidays ; Spring Bank Holiday has been moved to the 3rd of June and Queen's Platinum Jubilee added to 2nd of June, by @mountinash789 (#677).
• New calendar: Added Guernsey calendar by @ludsoft (#681)

v16.0.0 was released on 2021-09-16

New calendar

• New calendar: Added Philippines calendar by @micodls (#396)

Internal changes

See the README for more details about requirements, you may have to make changes to your installed packages in your environment.

• Remove skyfield dependency, added [astronomy] as extra dependency, thanks a millions times to @jrd (#660).
• Replace pyCalverter with convertdate (#536).
• Remove unused JalaliMixin
• Replace pkg_resources with importlib_metadata to fetch the version number in __init__.py (#657)
• Added new badges (pypi, conda, license) and installation instructions (pip, conda) to readme file @sugatoray (#673).
• Added the "Workalendar maintainers" in the LICENSE file.
• Changed the maintainer email.

The v15.4.0 was released on 2021-07-12

Changes

• New calendar: Added Nigeria calendar by @taiyeoguns (#656)
• Fix: Chilean calendar floating dates, add Indigenous Peoples Day using solar term, thx @ajcobo.

HOTFIX RELEASE Because of Tokyo's Summer Olympic games, some July/August holidays were changed in Japan.

Bugfixes

• Updated Japan calendar because of the Olympics, thx @lxlgarnett. (#662)
• Fixed Japan "Sports Day" label depending on the year.

Documentation

• The Workalendar project has been moved from Peopledoc's organization to its own (#651, #653, thx to @ewjoachim).

v15.3.0 was released on 2021-07-05

Changes

• Fix Barbados calendar to add 2 non computable public holiday and fix boxing day computation, thx to @ludsoft (#647).

v15.2.0 bugfix release was published on 2021-04-23

Changes

• Fixed Cuiaba City calendar (Brazil), adding Easter Sunday, Corpus Christi and Good Friday, thx @leogregianin (#642).
• Fix Catalonian calendar: add missing St John the Baptist public holiday, thx @lozlow (#643).

v15.1.0 was released on 2021-03-12

Changes

• Bugfix: Bulgaria holidays are now computed using the Orthodox calendar, include shifting rules for holidays that fall on a week-end (#596).
• Bugfix: get_working_days_delta method to integrate the extra_holidays and extra_working_days args (#631).

v15.0.2 was released on 2021-03-05

Changes

• Bugfix: USA calendar would take the shift_exceptions into account, even if the exceptions are set in the next or previous year (#610).
• Requirements: Unpin pyupgrade library (#634).

For some reasons, this release is dedicated to @rodo - take care of yourself and have fun!

v15.0.1 was released on 2021-02-26

Two extra working days were assigned for the year 2021 in Taiwan.

• Hotfix: Taiwan exceptional working day on February, 20th 2021 (#628).
• Hotfix: September 11th is a working day in Taiwan (#628).

v15.0.0 was released on 2021-02-19

Notes on Windows and timezone libraries: If you're using Windows and Python 3.6, 3.7, 3.8, the package tzdata becomes a requirement (with the backports.zoneinfo).

Major changes

• API: New method available in core module: Calendar.get_iso_week_date() to find the weekday X of the week number Y (#619).
• Requirements: Replace pytz with (backports.)zoneinfo, thx to @eumiro (#614)
• Doc: Documented the different (in)compatibilities due to the use of zoneinfo (#614).

Minor changes

Bugfixes

• Small fixes in Netherlands School calendars (#619).
• Temporary downgrade of pyupgrade to fix the pyup_dirs.

Improving test coverage

• Improve Netherlands coverage (#546, #619).
• Improve Russia coverage (#546).
• Improve USA calendar coverage by removing a method that wasn't used anyways (get_washington_birthday_december()). The method is implemented in both Indiana and Georgia State calendars, and is specific for each state, even if they look very similar (#546).
• Improve the astronomy.py module coverage (#546).
• Improve coverage for the tests/__init__.py module (#546). Note: system-dependant test branch (if Windows) won't be counted for coverage.

v14.3.0 was released on 2021-01-15

Calendar change

• Update Malaysia 2022-2024 (Deepavali + Thaipusam) by @jack-pace

v14.2.0 was released on 2021-01-08

Calendar changes

• Update Singapore for range from 2022 to 2030 (Deepavali), by @hprobotic

Internal changes

• Replace os.path.* calls with pathlib.Path, thx to @eumiro (#603)
• Use f-string for string formatting, thx to @eumiro (#605)
• Simplify collections handling, thx to @eumiro (#606)
• Use integers for time units divisions, thx to @eumiro
• Adding Mac OS & Windows tests to the test matrix (related to #607).
• Fix tests when running them on Windows (#607).

v14.1.0 was released in 2020-12-10

It hopefully fixes Russia holidays list, which is partly computed, and partly chosen arbitrarily.

Changes

• Fix Russia 2021 holidays, thx @MichalChromcak for the bug report (#578).

This version 14.0.0 has been released on 2020-11-27

Fixes

• Fix Russia calendar: non-working days are shifted to the next MON when they happen on the week-end (#589).
• Fix Russia New year holidays. It has become a week off since 2005 (related to #578).
• Added Russia COVID-19 non-working days for the year 2020 ; these days are not shifted to next MON (#578).
• Fixed Russia Christmas day ; December 25th is not a public holiday. Fixed several other Orthodox calendars (#530).
• Update China's public holidays for 2021, thanks @iamsk.

Minor changes

• Added a daterange function in workalendar.core module to iterate between two dates.

v13.0.0 was released on 2020-11-13

Calendars

• Add optional school holidays to Netherlands calendar, by @Flix6x (#556).
• Add optional carnival to Netherlands calendar.

Documentation

• Moving the contributing.md file to the docs/ directory (#573).
• Changed from setup.py to a nice setup.cfg file, thanks @ewjoachim (#576).
• Added documentation about class options (#572).
• Converted README.rst file into README.md (#575).
• Fixed Pull Request template to reference setup.cfg (#587).

Other changes

• Switched from Travis CI to Github Actions for CI jobs, thanks to @mgu.
• Added support of Python 3.9 (#557).
• Changed from setup.py to a nice setup.cfg file, thanks @ewjoachim (#576).
• Use the setup.cfg file in the key to cache in ci.yml file (#587).
• [OBSOLETE] Switched from bionic to focal on Travis CI (we've switched to GH actions after that).

v12.1.0 was released on 2020-10-16

New calendars

• Added Spain regions: Andalusia, Aragon, Castile and León, Castilla-La Mancha, Canary Islands, Extremadura, Galicia, Balearic Islands, La Rioja, Community of Madrid, Murcia, Navarre, Asturias, Basque Country, Cantabria, Valencian Community (#531).
• Added all ISO codes for Spain regions - thx @ainarela for your help on this (#531).

Other changes

• Refactored Spain test modules (#531).
• Fix Catalonia calendar by removing Sant Juan day, which does not appear to be an official holiday (#531).
• Improve coverage of workalendar/core.py module (#546).
• Improve coverage for the Netherlands calendar - Queen's Day (#546).
• Improve coverage for the Romania calendar - Liberation day (#546).
• Improve coverage for the New Zealand calendar (#546).
• Added a tox entrypoint to ensure code is Python 3.6+, using pyupgrade (#566).
• Added the pyupgrade tox job to the test suite, amended contributing documentation (#566).

v12.0.0 was released on 2020-10-02

• Deprecation: Dropped support for Python 3.5. As of this version, workalendar now requires Python 3.6+ (#330).
• Improve coverage of Singapore calendar (#546).

v11.0.1 was released and published on 2020-09-11

Changes

• Add ISO code decorator to Catalonia calendar, thanks to @jbagot (#551).
• Improve coverage of South Africa calendar (#546).
• Improve coverage of Brazil calendar (#546).
• Improve coverage of Canada (Nunavut) calendar (#546).
• Improve coverage of Israel calendar (#546).

v11.0.0 was released on 2020-09-04.

New calendar

• Added Mozambique calendar by @mr-shovel (#542).

New feature

• Added iCal export feature, initiated by @joooeey (#197).
• Fix PRODID pattern for iCal exports: "PRODID:-//workalendar//ical {__version__}//EN", using current workalendar version (#543).

Release v10.4.0 has been published on 2020-08-28

New calendar

• Added Monaco calendar by @joaopbnogueira (#538).

Major changes and bugfixes

• Migrating Labour Day as a worldwide holiday, disabled by default, but activated (to date) for about 50 countries (including label change when necessary), contributing.md documentation amended (#467).
• Bugfix: Avoid Cesar Chavez Day duplicated shifts by refactoring the California shift rules (#528).

Other changes

• Small refactoring for the Colombia / added docstrings & comments to explain why we're not using stock options. Added tests for year 2020 and handling shift exceptions (#509).
• Tech: Replace occurrences of assertEquals with assertEqual to clear warnings (#533).
• Use include_immaculate_conception flag for Portugal, Brazil, Argentina, Paraguay calendars (#529).

v10.3.0 was released on 2020-07-10

Bugfixes

• Belarus: removing day after Radonitsa, which is apparently not a holiday.
• Algeria: assigning the week-end days as FRI+SAT, as it's following a Islamic calendar.

Other changes

• Refactoring the core Calendar classes / mixins for better understanding. Only one Calendar subclass should be imported / used in calendar classes, the rest (when possible) should be Mixins (related to #511).
• Declaring the New year's Day as a worldwide holiday, with only two exceptions (to date): Israel & Qatar (#511).
• Fixed contributing.md documentation with the new class/mixin organization (#511).

v10.2.0 was released on 2020-06-26 - it's a bugfix release.

Bugfixes

• Setting Consciência Negra day as a non-holiday by default for Brazilian calendars, thx to @edniemeyer (#516).
• Introducing the changes in Croatia holidays as of 2020 - Remembrance Day, Independence Day, Statehood Day... thx to @davidpodrebarac for the bug report (#515).

Version v10.1.0 was released on 2020-06-18

Calendar fix

• Adding All Souls' Day to Lithuania calendar, starting of 2020, thx to @norkunas (#512).

Minor changes

• Small fixes (docstrings, use of extends, etc) on Cayman Islands calendar (#507).
• Moving Carnaval / Mardi Gras / Fat Tuesday calculation into the workalendar.core module, because it's used in at least 3 countries and some States / Counties in the USA.

v10.0.0 was released on 2020-06-05.

Major API change

• BREAKING CHANGE: the IsoRegistry.get_calendar_class() method has been removed from the code and should no longer be used (#375, #495).

v9.2.0 was released on 2020-06-02

New Calendars

• Added rules for all Switzerland Cantons (Aargau, Appenzell Innerrhoden, Appenzell Ausserrhoden, Bern, Basel-Landschaft, Basel-Stadt, Fribourg, Geneva, Glarus, Graubünden, Jura, Luzern, Neuchâtel, Nidwalden, Obwalden, St. Gallen, Schaffhausen, Solothurn, Schwyz, Thurgau, Ticino, Uri, Vaud, Valais, Zug & Zurich), branching off the initial work by @brutasse (#497).

v9.0.1 was released on 2020-05-22

Bugfixes

• Making the Israel calendar more efficient (#498).
• Fixing duplicated holidays in Hong-Kong and Hong-Kong Bank holiday calendars (#496).
• Integrating Hong-Kong holidays for 2021 (#496).

v9.0.0 was released on 2020-04-24

• BREAKING CHANGE: the IsoRegistry.items() method has been removed from the API. You must use the get_calendars() to perform the same registry queries (#375, #491).
• Deprecation notice: The usage of IsoRegistry.get_calendar_class() is strongly discouraged, in favor of get(). The get_calendar_class method will be dropped in a further release. In the meantime, they'll be both equivalent (#375, #418).

New Calendar

• Added Kenyan calendar, by @KidkArolis (#484)

Minor fixes

• Fixed Lithuania calendar to use the core flags for Assumption and All Saints (#468).
• Fixed Malta calendar ; January 1st was already included, no need to add it to the FIXED_HOLIDAYS property (#469).
• Small refactor in Netherlands calendar to use core constants (#470).

v8.3.0 was released on 2020-04-14

It appeared that HK calendar was wrong all the way down (SAT was a working day, and holidays are only shifted if they happen on SUN). Thanks to @greatfung bug report, it became possible to fix the whole Hong-Kong calendars, and add a Bank-specific calendar, in which SAT are non-working days.

Bugfixes

• Fixing Hong-Kong calendar, where SAT are common working days (#477).
• Introducing Hong-Kong Bank calendar. For banks, Saturdays are non-working days (#477).

This v8.2.2 was released on 2020-04-10.

Bugfixes

• Fixed Argentina's "Malvinas Day" date for 2020, shifted to March 31st because of the coronavirus crisis (#476).
• Fixed Argentina's label for "Malvinas Day" and "Día de la Memoria" (#476).

Stay safe, everyone!

v8.2.1 was released on 2020-04-03

Bugfix

• Added BrazilBankCalendar to support include_ flags and make it possible to extend and change these flags to support custom bank calendars (#474).

version 8.2.0 has been released on 2020-03-13

New calendar

• The Belarus calendar has been added by @alexdoesstuff.

version 8.1.0 was released on 2020-02-07

Two bugfixes, and especially one about Israël's holidays

Bugfixes

• Added Israel holidays eves and removed holidays which are not affecting the working days in Israel (#461).
• Fix warning in China's holidays to dynamically read supported years, thx @fredrike (#459).

v8.0.2 was released in 2020-01-24

It's a hotfix release.

Bugfix

• Fix several miscalculations in Georgia (USA) calendar (#451).

v8.0.1 was released on 2020-01-24

It mainly fix a miscalculation on Family Day for British Columbia.

Bugfix

• Fix Family Day for British Columbia (Canada) which was switched from 2nd to 3rd Monday of February in 2019 - thx @jbroudou for the bug report (#454).

v8.0.0 was released on 2020-01-10

• BREAKING CHANGE Drop Support for Python 2 - EOL January 1st 2020 (#442).
• Added Ukraine calendar, by @apelloni.
• Small cleanup in the .travis.yml file, thx to @Natim.

ISO Registry API Change

• Changes in the registry.items() method API.
  • This method is aliased to get_calendars(). In a near release, the items() method will change its purpose.
  • The get_calendars() method accepts an empty/missing region_codes argument to retrieve the full registry. Please see the ISO Registry documentation for extensive usage docs (#403, #375).

The v7.2.0 was released on 2019-12-06

New calendars

• Added Serbia calendar, by @apelloni (#435).
• Added Argentina calendar, by @ftatarli (#419).

Other changes

• Update China's public holidays for 2020, thx @nut-free (#429).
• Update Malaysia and Singapore for 2021 (Deepavali + Thaipusam) by @jack-pace (#432).
• Small refactorings on the Gevena (Switzerland) holiday class, thx to @cw-intellineers (#420).

The v7.1.1 has been released on 2019-11-22.

It embeds a very important hotfix for USA Thanksgiving day, which was wrongfully calculated for the year 2019. We're advising Workalendar users using USA calendars to upgrade as soon as possible.

Changes

• Bugfix for USA: Fixed incorrect implementation for Thanksgiving Friday, thx @deveshvar (#422).
• Fix Advanced usage documentation about Thanksgiving Day (#426).

New calendar

• Added Geneva calendar by @cw-intellineers (#420).

The 7.1.0 version was released on 2019-11-15

New calendars

• Added 27 Brazil calendars -- thanks a lot to @luismalta & @mileo, (#409 & #415)

Enhancements

• Added compatibility with Python 3.8 (#406).
• Added an IBGE_REGISTER to reference IBGE (brazilian) calendars with related tests (#415).
• Improve ISO registry interface by raising an error when trying to register a non-Calendar class (#412).

Other changes

• Fixes and additions to some Brazil calendars ; again, thanks to @luismalta & @mileo, (#409 & #415)
• Fix Denmark, re-add Christmas Eve, which is widely treated as public holiday ; thx to @KidkArolis, (#414).
• Increase Malaysia coverage by adding tests for missing Deepavali & Thaipusam.
• Increase China coverage by adding tests for special extra-holidays & extra-working days cases.

version 7.0.0 has been released on 2019-09-20

Only one changelog entry, and not a small one:

• Drop ephem astronomical calculation library, in favor of skyfield and skyfield-data for providing minimal data files to enable computation (#302, #348). Many thanks to @GammaSagittarii for the tremendous help on finding the right way to compute Chinese Solar Terms. Also thanks to @antvig and @DainDwarf for testing the beta version (#398).

A new era for workalendar.

v6.0.1 has been released on 2019-09-17

Fixes

• Fix Turkey Republic Day (#399, thx to @mhmtozc & @Natim).

v6.0.0 was released on 2019-08-02

Deprecation Notice: The global ISO registry now returns plain dict objects from its various methods.

• Global registry now returns plain built-in dicts (#375).
• Removed EphemMixin in favor of astronomical functions (#302).
• Added first day counting when computing working_days delta (#393), thx @Querdos.

v5.2.3 was released on 2019-07-11

Deprecation Warning: Currently the registry returns OrderedDict objects when you're querying for regions or subregions. Expect that the next major release will preferrably return plain'ol' dict objects. If your scripts rely on the order of the objects returned, you'll have to sort them yourself.

• Fix Romania, make sure Easter and related holidays are calculated using the Orthodox calendar, thx to @KidkArolis (#389).

v5.2.2 was released on 2019-07-07

• Fix Denmark, remove observances (remove Palm Sunday, Constitution Day, Christmas Eve and New Year's Eve) (#387, #386)

Deprecation Warning: Currently the registry returns OrderedDict objects when you're querying for regions or subregions. Expect that the next major release will preferrably return plain'ol' dict objects. If your scripts rely on the order of the objects returned, you'll have to sort them yourself.

v5.2.1 was released on 2019-07-05

• Refactored the package building procedure, now linked to make package ; added a note about this target in the PR template (#366).
• Fixed United Kingom's 2020 holidays ; The Early May Bank Holiday has been moved to May 8th to commemorate the 75th anniversary of the end of WWII (#381).

Deprecation Warning: Currently the registry returns OrderedDict objects when you're querying for regions or subregions. Expect that the next major release will preferrably return plain'ol' dict objects. If your scripts rely on the order of the objects returned, you'll have to sort them yourself.

v5.2.0 was released on 2019-07-04

New Calendar

• Added JapanBank by @raybuhr (#379, #369).

Other changes

• Added adjustments to 2019-2020 Japan calendar due to the coronation of a new emperor (#379).
• Add a note about the fact that contributors should not change the version number in the changelog and/or the setup.py file (#380).

Deprecation Warning: Currently the registry returns OrderedDict objects when you're querying for regions or subregions. Expect that the next major release will preferrably return plain'ol' dict objects. If your scripts rely on the order of the objects returned, you'll have to sort them yourself.

v5.1.1 was released on 2019-06-27

Changes

• Display missing lines in coverage report (#376).
• Add "Europe Day" for Luxembourg (#377).

Deprecation Warning: Currently the registry returns OrderedDict objects when you're querying for regions or subregions. Expect that the next major release will preferrably return plain'ol' dict objects. If your scripts rely on the order of the objects returned, you'll have to sort them yourself.

v5.1.0 was released in 2019-06-24

Deprecation Warning: Currently the registry returns OrderedDict objects when you're querying for regions or subregions. Expect that the next release will preferrably return plain'ol' dict objects. If your scripts rely on the order of the objects returned, you'll have to sort them yourself.

New Calendar

• Added Turkey by @tayyipgoren (#371).

Other changes

• Change registry mechanism to avoid circular imports (#288).
• Internal: Added a "Release" section to the Pull Request template.
• Internal: Added advices on the Changelog entry in the Contributing document.
• Bugfix: Fixing North Carolina shift rules when Christmas Day happens on Saturday (#232).
• Documentation: rearrange country list in README.rst (sorting and fixing nested lists).
• Documentation: Renamed and changed format of the "Contributing guidelines" document, now in Markdown (GFM variant), with a few fixes (#368).
• Internal: remove coverage targets ; now coverage reports are displayed for each tox job, but they won't output classes with 100% coverage.

The v5.0.3 was released on 2019-06-07

Bugfix

• Panama - Fixed incorrect independence from Spain date, thanks to @chopanpma (#361).

This version cancels the v5.0.1, released on the same day (2019-06-03)

Changes

• Bugfix: Israel - Fixed incorrect Purim/Shushan Purim dates in jewish leap years, thx @orzarchi. This fix cancels the last (5.0.1) version, that will be deleted from PyPI.

WARNING!!! THIS HOTFIX RELEASE CONTAINS AN ERRONEOUS PATCH, DON'T UPGRADE IF YOU WANT TO USE ISRAEL CALENDAR

This hotfix release was published on 2019-06-03

Bugfix

• Israel - Fixed incorrect Purim/Shushan Purim dates in jewish leap years, thx @orzarchi.

This v5.0.0 was released on 2019-05-24

Major Changes & fixes

• Dropped Python 3.4 support (#352).
• Added Malaysia Thaipusam days for the year 2019 & 2020 - thx @burlak for the bug report (#354).
• Fixed Deepavali dates for the year 2018 ; confirmed fixed dates that were set in the past.

Added calendars

• Added Florida specific calendars: Florida Legal, Florida Circuit Courts, Miami-Dade (#216).

v4.4.0 has been released on 2019-05-17

Warnings

This release will be the last one to support Python 3.4, which has reached its End of Life and has been retired. Please upgrade.

This release is also a hotfix for all workalendar users that are relying on Australia and South Africa calendars. It brings important fixes, especially for South Africa this year (2019).

Added calendar

• Added California specific calendars: California Education, Berkeley, San Francisco, West Hollywood (#215).

Fixes

• Added a few refactors and tests for Australia Capital Territory holiday named "Family & Community Day", that lasted from 2007 to 2017 (#25).
• Added South African 2019 National Elections as holiday (#350), by @RichardOB.

v4.3.1 was released on 2019-05-03

This is a hotfix release, please upgrade if you're using the China calendars as soon as possible.

• Bugfix: Update 2019 Labour Day Holidays for China as changed by government recently (2019-03-22), by @iamsk, and thanks to @ltyely for their patch (#345 & #347).