Month and weekday names

hebrewcal.names provides name tables for months and weekdays in several systems.

Month numbering

hebrewcal uses the standard month numbering throughout:

#

Name

#

Name

1

Nisan

7

Tishri (civil new year)

2

Iyyar

8

Marheshvan

3

Sivan

9

Kislev

4

Tammuz

10

Tevet

5

Av

11

Shevat

6

Elul

12

Adar (Adar I in a leap year)

13

Adar II (leap years only)

Month names

hebrew_month_name(year, month, system=...) returns the name. Three systems are available: "transliteration" (default), "babylonian" and "biblical".

>>> from hebrewcal.names import hebrew_month_name
>>> hebrew_month_name(5785, 7)
'Tishri'
>>> hebrew_month_name(5785, 7, system="babylonian")
'Tashritu'
>>> hebrew_month_name(5785, 1, system="biblical")
'Aviv'

Native Hebrew script is available too (system="hebrew"):

>>> hebrew_month_name(5785, 7, system="hebrew")
'תשרי'
>>> hebrew_month_name(5784, 13, system="hebrew")   # Adar II in a leap year
'אדר ב׳'

The year matters because leap years rename month 12:

>>> hebrew_month_name(5784, 12)   # 5784 is a leap year
'Adar I'
>>> hebrew_month_name(5784, 13)
'Adar II'
>>> hebrew_month_name(5785, 12)   # 5785 is a common year
'Adar'

Naming systems at a glance

  • Transliteration — the everyday Modern-Hebrew transliterations (Tishri, Kislev, …).

  • Babylonian — the Akkadian month names the post-exilic calendar adopted (Tashritu, Kislimu, …), useful for ancient Near-Eastern context.

  • Biblical — the handful of names attested in the Hebrew Bible (Aviv, Ziv, Ethanim, Bul); other months fall back to the transliteration.

Weekday names

weekday_name(weekday) takes the Sunday = 0 … Saturday = 6 index used everywhere in the library (see Rata Die — the conversion pivot).

>>> from hebrewcal.names import weekday_name
>>> weekday_name(0)
'Yom Rishon'
>>> weekday_name(6)
'Shabbat'

Pass hebrew=True for native Hebrew script (weekday_name(6, hebrew=True)שבת).

Combine it with weekday() to label any date:

>>> from hebrewcal import GregorianDate, weekday
>>> from hebrewcal.names import weekday_name
>>> weekday_name(weekday(GregorianDate(1867, 10, 31)))
'Yom Chamishi'

An out-of-range value or unknown system raises ValueError.