types-python-dateutil
Typing stubs for python-dateutil
Decision gist · record as of 2026-08-14
Yes, if you use python-dateutil and run a type checker (mypy, pyright, or similar). It adds no runtime overhead and is a standard part of the typeshed ecosystem. Install it alongside python-dateutil to catch type errors during development. No reason not to if type checking is part of your workflow.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- The package is a stub-only type annotation provider and does not function as a standalone library—python-dateutil itself must be installed separately.
- Low friction installation with no runtime dependencies.
License · maintenance · safety
Apache-2.0 (permissive) — Licensed under Apache-2.0 (permissive), allowing use in commercial and open-source projects with minimal restrictions.
last release 2026-08-07 (7 days) · last repo commit 2026-08-13 · 37 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 59,270,441 downloads/mo, #509 on PyPI
Alternatives
Verify before relying
pip install types-python-dateutil
# Then use with your type checker (e.g., mypy or pyright)
# in your code that imports python-dateutil
from dateutil import parser
date = parser.parse('2026-08-14')- Whether stub coverage is complete for all python-dateutil 2.9.* APIs or if gaps remain.
- Compatibility with type checkers beyond mypy 2.3.0, pyright 1.1.411, and ty 0.0.59.
What it is and what it does
types-python-dateutil is a type stub package that provides type annotations for the python-dateutil library. It is part of the typeshed project and allows static type checkers like mypy and pyright to understand and validate code that uses python-dateutil's date parsing, manipulation, and recurrence rule functionality. The stubs are synchronized with python-dateutil 2.9.* releases.
This package contains no runtime code—it is purely for type checking. It must be installed alongside python-dateutil itself, and it enables developers to catch type-related bugs during development rather than at runtime. The package is actively maintained through typeshed's contribution process.
Use it for
- Enable mypy or pyright to type-check code that parses dates with python-dateutil.parser.
- Validate timezone-aware datetime operations in codebases using python-dateutil.tz.
- Catch type mismatches when working with recurrence rules (rrule) in scheduling applications.
- Enforce type safety in data processing pipelines that rely on dateutil for date arithmetic.
- Integrate type checking into CI/CD workflows for projects using python-dateutil.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you use python-dateutil and run a type checker (mypy, pyright, or similar).
It adds no runtime overhead and is a standard part of the typeshed ecosystem. Install it alongside python-dateutil to catch type errors during development. No reason not to if type checking is part of your workflow.
Install
types-python-dateutil on PyPI
Before you install
Low friction installation with no runtime dependencies. Actively maintained as part of typeshed, with a release 7 days old and recent repository activity.
Requires Python 3.10 or later. The package is a stub-only type annotation provider and does not function as a standalone library—python-dateutil itself must be installed separately.
License in practice
Licensed under Apache-2.0 (permissive), allowing use in commercial and open-source projects with minimal restrictions.
Quickstart
pip install types-python-dateutil
# Then use with your type checker (e.g., mypy or pyright)
# in your code that imports python-dateutil
from dateutil import parser
date = parser.parse('2026-08-14')Verify before relying
- Whether stub coverage is complete for all python-dateutil 2.9.* APIs or if gaps remain.
- Compatibility with type checkers beyond mypy 2.3.0, pyright 1.1.411, and ty 0.0.59.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 7 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 59,270,441 / month, #509 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Programming Language :: Python :: 3Typing :: Stubs Only |
Evidence: types_python_dateutil-2.9.0.20260807-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “type stubs python-dateutil”
- types-python-dateutilProvides type annotations for the python-dateutil library, enabling…
- types-assertpyProvides type stubs enabling static type checkers like mypy and…
- types-appdirsProvides type stubs for the appdirs package to enable static type…
Give your agent the search over MCP, or paste the wish link into any chat.
Similar packages
Provides type stubs for the dateparser package, enabling static type checkers like mypy, pyright, and others to validate code that uses dateparser for date parsing.
Provides type annotations for the geopandas library, enabling static type checkers like mypy and pyright to validate code that uses geopandas.
Provides type hints for the docutils library, enabling static type checkers like mypy and pyright to validate code that uses docutils for document processing and parsing.
Provides date and time arithmetic operations, including range generation and business day calculations, built on top of python-dateutil's relativedelta.
However, verify compatibility with your Python version and dependency stack, and consider whether you can rely on python-dateutil directly if maintenance becomes a…
Provides type stubs for the pytz timezone library, enabling static type checkers like mypy and pyright to validate code that uses pytz.
Provides type annotations for the setuptools package, enabling type checkers like mypy, pyright, and others to validate code that uses setuptools.
See also types-yt-dlp · python-dateutil · types-pyinstaller · types-mypy-extensions