Skip to main content

How to Resolve "ModuleNotFoundError: No module named 'dateutil'" in Python

The ModuleNotFoundError: No module named 'dateutil' is a common Python error indicating that the interpreter can not find the dateutil library when your script tries to import it (e.g., from dateutil.parser import parse). This usually means the necessary package, python-dateutil, isn't installed correctly in the Python environment you're using.

This guide provides clear steps to resolve this error.

Understanding the Error: Package Name vs. Import Name​

The key thing to remember is:

  • The package you install using pip is named python-dateutil.
  • The module you import in your Python code is named dateutil.

Trying to pip install dateutil will fail because that's not the correct package name on the Python Package Index (PyPI).

Solution 1: Install python-dateutil using pip (Most Common)​

The primary solution is to install the correct package using pip.

Open your terminal or command prompt and run:

pip install python-dateutil

Variations (Choose the one appropriate for your setup):

# If you primarily use Python 3 and 'pip' might point to Python 2
pip3 install python-dateutil

# If pip/pip3 are not in your system PATH
python -m pip install python-dateutil
python3 -m pip install python-dateutil

# On Windows, 'py' launcher might be available
py -m pip install python-dateutil

Troubleshooting Common Installation Problems:​

If pip install python-dateutil gives an error or the ModuleNotFoundError persists, check these common issues:

  • Using the Correct pip: Ensure you're using the pip associated with the Python version you intend to run your script with (usually pip3 or python3 -m pip for Python 3). Check versions with python --version and pip --version (or pip3 --version).
  • Working with Virtual Environments (Crucial!): This is the most common cause of import errors. You likely installed the package globally but are running your script inside a virtual environment (or vice versa).
    • Always activate your virtual environment before installing packages. 
      # Create (if needed)
      python3 -m venv venv
      # Activate (adjust for your OS)
      source venv/bin/activate    # Linux/macOS
      .\venv\Scripts\Activate.ps1 # Windows PowerShell
      .\venv\Scripts\activate.bat # Windows CMD
      # Install INSIDE the active environment
      pip install python-dateutil
    • Make sure your IDE (VS Code, PyCharm) is configured to use the Python interpreter from your activated virtual environment.
  • Permissions Issues (--user or sudo): If installing globally (outside a venv), you might need different permissions.
    • Recommended: Install for the current user: pip install python-dateutil --user
    • Use Cautiously: Use admin/root privileges: sudo pip install python-dateutil (Linux/macOS) or run terminal as Administrator (Windows). Virtual environments avoid this need.
  • Multiple Python Installations / IDE Configuration: Verify that the Python interpreter selected in your IDE matches the one you used pip with. Use the "Select Interpreter" command in your IDE.
  • Naming Conflicts (dateutil.py): Ensure you haven't named any of your project files dateutil.py. This would prevent Python from finding the installed package. Rename your file if needed. Also, avoid using dateutil as a variable name before the import.

Verifying Installation (pip show)​

Confirm the package is installed in the correct environment:

pip show python-dateutil
# Or: pip3 show python-dateutil
# Or: python3 -m pip show python-dateutil

This command should display details about the python-dateutil package if it's installed. If it shows "Package(s) not found," the installation wasn't successful in that specific environment.

Platform/Tool Specific Installation Notes:​

  • Windows: Use CMD or PowerShell. The py -m pip install python-dateutil command is often reliable. Run as Administrator for global installs if needed (but prefer venvs or --user).
  • macOS / Linux: Use the Terminal. Use pip3 or python3 -m pip. Use sudo cautiously for system-wide installs.
  • VS Code: Use the integrated terminal (Ctrl + `` ). Ensure the correct Python interpreter (often from a venv) is selected.
  • PyCharm: Use the integrated terminal (Alt+F12) or the Python Packages tool. Verify the correct project interpreter is set.
  • Anaconda: Use the Anaconda Prompt or terminal in an active conda environment. The recommended command is usually: 
    conda install -c anaconda python-dateutil
    # Or sometimes just:
    conda install python-dateutil
    # Pip can also be used within conda environments:
    pip install python-dateutil
  • Jupyter Notebook: Install from a notebook cell using !pip: 
    !pip install python-dateutil
    # Or for user install:
    # !pip install python-dateutil --user
    Restart the kernel after installing.

Using dateutil After Installation​

Once installed correctly, you import the module using dateutil (not python-dateutil) in your Python code:

from dateutil.parser import parse
from dateutil.relativedelta import relativedelta
from datetime import datetime

try:
    # Example using dateutil.parser
    date_obj = parse("2023-10-27 10:30:00")
    print(date_obj)

    # Example using dateutil.relativedelta
    new_date = date_obj + relativedelta(months=+1)
    print(new_date)

except ImportError:
    print("Error: 'dateutil' module not found. Please install 'python-dateutil'.")
except Exception as e:
    print(f"An error occurred: {e}")

Conclusion​

The ModuleNotFoundError: No module named 'dateutil' error typically means the python-dateutil package needs to be installed.

  • Remember the distinction: install python-dateutil, but import dateutil.
  • Ensure you're installing into the correct Python environment, preferably using a virtual environment, and that your pip command corresponds to the Python interpreter you're using for your project.

Table of Contents