Skip to content

Utilities

nflreadpy.get_current_season 

get_current_season(roster: bool = False) -> int

Get the current NFL season year.

Parameters:

Name Type Description Default
roster bool
  • If True, uses roster year logic (current year after March 15).
  • If False, uses season logic (current year after Thursday following Labor Day).
 False

Returns:

Type Description
int

The current season/roster year.
See Also

https://nflreadr.nflverse.com/reference/get_current_season.html

Source code in src/nflreadpy/utils_date.py 
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
def get_current_season(roster: bool = False) -> int:
    """
    Get the current NFL season year.

    Args:
        roster:
            - If True, uses roster year logic (current year after March 15).
            - If False, uses season logic (current year after Thursday following Labor Day).

    Returns:
        The current season/roster year.

    See Also:
        <https://nflreadr.nflverse.com/reference/get_current_season.html>
    """
    today = date.today()
    current_year = today.year

    if roster:
        # Roster logic: current year after March 15, otherwise previous year
        march_15 = date(current_year, 3, 15)
        return current_year if today >= march_15 else current_year - 1
    else:
        # Season logic: current year after Thursday following Labor Day
        # Labor Day is first Monday in September
        # Find first Monday in September
        for day in range(1, 8):
            if date(current_year, 9, day).weekday() == 0:  # Monday
                labor_day = date(current_year, 9, day)
                break

        # Thursday following Labor Day
        season_start = date(labor_day.year, labor_day.month, labor_day.day + 3)
        return current_year if today >= season_start else current_year - 1

nflreadpy.get_current_week 

get_current_week() -> int

Get the current NFL week (rough approximation).

Returns:

Type Description
int

The current NFL week (1-22).
See Also

https://nflreadr.nflverse.com/reference/get_current_week.html

Source code in src/nflreadpy/utils_date.py 
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
def get_current_week() -> int:
    """
    Get the current NFL week (rough approximation).

    Returns:
        The current NFL week (1-22).

    See Also:
        <https://nflreadr.nflverse.com/reference/get_current_week.html>
    """
    today = date.today()
    season_year = get_current_season()

    # NFL season typically starts around first Thursday of September
    # Find first Thursday in September
    for day in range(1, 8):
        if date(season_year, 9, day).weekday() == 3:  # Thursday
            season_start = date(season_year, 9, day)
            break

    if today < season_start:
        return 1

    # Calculate weeks since season start
    days_since_start = (today - season_start).days
    week = min(days_since_start // 7 + 1, 22)  # Cap at week 22

    return int(week)