weekdays-enum 0.2.0

A super lightweight thoroughly tested package to make dealing with the days of a week a little easier.

weekdays-enum

A super lightweight thoroughly tested package to make dealing with the days of a week a little easier.

Far too often I see hard coded lists of strings representing the days of the week days = ['Monday', 'Tuesday', ...], or imports of unnecessarily large and often out of date packages just to deal with days of the week coming from something like json or user input. weekdays-enum aims to solve these issues and more.

Note weekdays-enum depends on one, even smaller, dependency by the same auther: ordered-string-enum

See the sourcecode here.

Installation

pip install weekdays-enum

Usage

The weekdays-enum package provides two enum class definitions called WeekDay one for weeks starting on Monday, the other for starting on Sunday. Import the WeekDay needed or create your own implementation by extending WeekDayBase (or WeekDayBaseEnglish a base where the english days of the week are abstract and required).

from weekdays_enum.monday_start import WeekDay
# Or if weeks start on Sunday
from weekdays_enum.sunday_start import WeekDay

# Or implement your own
from weekdays_enum.weekday_base import WeekDayBase, WeekDayBaseEnglish


class MyWeekDay(WeekDayBaseEnglish):
    Wednesday = 0
    Thursday = 1
    ...

class MyWeeksdag(WeekDayBase):
    Maandag = 0
    Dinsdag = 1
    ...

You can also import specific days

from weekdays_enum.monday_start import Monday, Tuesday

or just all the days to use without WeekDay.

from weekdays_enum.monday_start import *

print(Monday)

Comparisons and Ordering

WeekDay enums are powerful in that they can be retrieved in a number of convenient ways and can be seamlessly compared with each-other, their int values, or even strings:

import datetime
from weekdays_enum.monday_start import *

print('Compare Monday to Tuesday in 4 equivalent ways')
print(Monday < Tuesday)  # - True
print(Monday < 1)  # - True
print(Monday < 'Tuesday')  # - True
print(Monday < 'tuesday')  # - True

print('Get the WeekDay easily and intuitively')
first_Monday_2026 = datetime.datetime(2026, 1, 5)
print(WeekDay(0))  # - <WeekDay.Monday: 0>
print(WeekDay('Monday'))  # - <WeekDay.Monday: 0>
print(WeekDay('monday'))  # - <WeekDay.Monday: 0>
print(WeekDay.get_week_day(first_Monday_2026))  # - <WeekDay.Monday: 0>
print(WeekDay.from_iso_day(1))  # - <WeekDay.Monday: 0>

No more hard coding a list of the days of the week. We can get an ordered list from WeekDay and a desired string representing each day:

from weekdays_enum.monday_start import *

days = WeekDay.list()  # gets an ordered list containing each day

for day in days:
    print(f'{day.name} or "{day.short()}" for short or "{day.short(2)}" for even shorter')

Outputs:

Monday or "Mon" for short or "Mo" for even shorter
Tuesday or "Tue" for short or "Tu" for even shorter
Wednesday or "Wed" for short or "We" for even shorter
Thursday or "Thu" for short or "Th" for even shorter
Friday or "Fri" for short or "Fr" for even shorter
Saturday or "Sat" for short or "Sa" for even shorter
Sunday or "Sun" for short or "Su" for even shorter