5 Pythonic Ways to Check if a Date is a Weekend Using datetime

by

💡 Problem Formulation: When working with dates in Python, it’s common to need to check whether a given date falls on a weekend. This is crucial for applications that require different logic for weekdays versus weekends, such as scheduling software or automated reports that only run on business days. For example, given a date input, we want to determine whether it’s a Saturday or Sunday (the typical weekend in many regions).

Method 1: Using weekday() Function

The weekday() function of Python’s datetime module returns an integer corresponding to the day of the week, where Monday is 0 and Sunday is 6. By checking if this integer is 5 or 6, we can determine if the date is a weekend.

Here’s an example:

from datetime import datetime

def is_weekend(date):
    return date.weekday() > 4  # 5 for Saturday, 6 for Sunday

# Example usage
date_to_check = datetime(2023, 3, 18)  # A Saturday
print(is_weekend(date_to_check))

Output: True

This method is straightforward and readable. It utilizes the convenience of Python’s built-in functions to perform the check with minimal code.

Method 2: Using the strftime() Function

The strftime() function formats a date into a string based on a directive given to it. By formatting the date to return the day of the week as a string and comparing it to “Saturday” or “Sunday”, we can determine if it is a weekend day.

Here’s an example:

from datetime import datetime

def is_weekend(date):
    return date.strftime("%A") in ["Saturday", "Sunday"]

# Example usage
date_to_check = datetime(2023, 3, 19)  # A Sunday
print(is_weekend(date_to_check))

Output: True

This method is particularly useful when you need the day of the week as a string for other purposes as well, although it can be less efficient than numerical comparison due to string operations.

Method 3: Using isoweekday() Function

Similar to weekday(), the isoweekday() function returns an integer representing the day of the week, but according to the ISO standard where Monday is 1 and Sunday is 7. Checking for 6 and 7 will tell us if it’s a weekend.

Here’s an example:

from datetime import datetime

def is_weekend(date):
    return date.isoweekday() > 5  # 6 for Saturday, 7 for Sunday

# Example usage
date_to_check = datetime(2023, 3, 19)  # A Sunday
print(is_weekend(date_to_check))

Output: True

This approach operates almost identically to the first method but adheres to the ISO standard for the days of the week, which may be preferable in some international contexts.

Method 4: Using timedelta and weekday

This method involves determining if the given date is within the range between the last Friday and the next Monday. It’s a bit more complex but useful if your weekend definition might vary (e.g., Friday evening to Monday morning).

Here’s an example:

from datetime import datetime, timedelta

def is_weekend(date):
    last_friday = date - timedelta(days=date.weekday()) + timedelta(days=4, weeks=-1)
    next_monday = date + timedelta(days=-date.weekday()) + timedelta(days=7)
    return last_friday <= date < next_monday

# Example usage
date_to_check = datetime(2023, 3, 17)  # A Friday
print(is_weekend(date_to_check))

Output: True

This method might be an overkill for basic weekend checking but allows flexibility if different definitions of the weekend are needed.

Bonus One-Liner Method 5: Lambda Function

For a quick, in-place way to check if a date is a weekend, a lambda function can be employed. This is best when you need a simple check done once without needing a full function definition elsewhere in your code.

Here’s an example:

from datetime import datetime

# Example usage
date_to_check = datetime(2023, 3, 18)  # A Saturday
is_weekend = lambda date: date.weekday() > 4
print(is_weekend(date_to_check))

Output: True

The lambda function here is a concise and direct way to check for a weekend, great for one-off checks within other expressions or functions.

Summary/Discussion

  • Method 1: weekday() Function. Straightforward and efficient. Best for those who prefer numerical comparisons over string comparisons. Might be less clear to readers who don’t remember which number corresponds to which day.
  • Method 2: strftime() Function. Clear and human-readable. Offers string-based comparison, which may be less efficient and could potentially lead to errors with different locale settings.
  • Method 3: isoweekday() Function. Similar benefits to Method 1 but uses the ISO standard for the days of the week. It is suitable for international contexts.
  • Method 4: Using timedelta and weekday. Flexible and powerful, allowing for a customizable definition of the weekend. However, it is more complex and hence may be less clear at a glance.
  • Bonus Method 5: Lambda Function. Quick and elegant for one-off checks. However, due to the lack of explicit function definition, it may not be as clear to maintain for those unfamiliar with lambda functions or pythonic shortcuts.