romme

Convert to/from French Republican calendar


Keywords
calendar, dates, french
License
Other
Install
pip install romme==0.1.0

Documentation

Romme

Romme is a Python 3 library to convert dates between the French Republican and the Gregorian calendars. It’s named after Gilbert Romme, who developed the former.

The French Republican calendar was briefly used in France between 1792 and 1806. The population didn’t widely use it, but official documents did; we can see it used in some open datasets. Dealing with two different calendars is a pain, so this library allows you to translate from one to another.

Build Status

Features

  • Convert from French Republican to Gregorian calendar
  • Convert from Gregorian to French Republican calendar
  • Parse dates from strings (e.g. "3 Prairial, an VIII")

Install

pip install romme

Usage

from romme import RepublicanDate

rd = RepublicanDate(5, 1, 1)  # first day of the year V

rd.to_date()  # gives you a datetime.date object for the 1796/09/22

rd2 = RepublicanDate.from_gregorian(1796, 9, 22)
print(rd == rd2)  # True

# You can also parse from a string
RepublicanDate.from_string("1 Vendémiaire, an I")