diff --git a/Doc/library/datetime.rst b/Doc/library/datetime.rst index f3c4ef9199075c..622d18427096a8 100644 --- a/Doc/library/datetime.rst +++ b/Doc/library/datetime.rst @@ -950,6 +950,11 @@ Constructor: .. versionchanged:: 3.6 Added the *fold* parameter. + .. versionchanged:: 3.16 + :class:`!datetime` now supports the subscript (``[]``) operator for creating + :class:`generic aliases `, e.g., ``datetime[tzinfo]``. + See :pep:`585` and :ref:`types-genericalias`. + Other constructors, all class methods: diff --git a/Lib/_pydatetime.py b/Lib/_pydatetime.py index 50126d039e830a..4e7c692f3b3292 100644 --- a/Lib/_pydatetime.py +++ b/Lib/_pydatetime.py @@ -9,6 +9,7 @@ import time as _time import math as _math import sys +import types as _types from operator import index as _index def _cmp(x, y): @@ -2432,6 +2433,8 @@ def __reduce_ex__(self, protocol): def __reduce__(self): return self.__reduce_ex__(2) + __class_getitem__ = classmethod(_types.GenericAlias) + datetime.min = datetime(1, 1, 1) datetime.max = datetime(9999, 12, 31, 23, 59, 59, 999999) diff --git a/Lib/test/datetimetester.py b/Lib/test/datetimetester.py index 716c662ad453f4..3db2598c39b182 100644 --- a/Lib/test/datetimetester.py +++ b/Lib/test/datetimetester.py @@ -130,6 +130,23 @@ def test_divide_and_round(self): self.assertEqual(dar(6, -4), -2) self.assertEqual(dar(-6, -4), 2) + def test_datetime_class_getitem(self): + """Test that datetime class supports subscripting via __class_getitem__.""" + from types import GenericAlias + datetime = datetime_module + + # Test datetime class can be subscripted + alias = datetime.datetime[tzinfo] + self.assertIsInstance(alias, GenericAlias) + self.assertIs(alias.__origin__, datetime.datetime) + self.assertEqual(alias.__args__, (tzinfo,)) + + # Test multiple type arguments + alias_multi = datetime.datetime[tzinfo, str] + self.assertIsInstance(alias_multi, GenericAlias) + self.assertIs(alias_multi.__origin__, datetime.datetime) + self.assertEqual(alias_multi.__args__, (tzinfo, str)) + ############################################################################# # tzinfo tests diff --git a/Misc/NEWS.d/next/Library/2026-11-04-15-29-48.gh-issue-161304.S6LyC9.rst b/Misc/NEWS.d/next/Library/2026-11-04-15-29-48.gh-issue-161304.S6LyC9.rst new file mode 100644 index 00000000000000..28f03a1ce8e8f7 --- /dev/null +++ b/Misc/NEWS.d/next/Library/2026-11-04-15-29-48.gh-issue-161304.S6LyC9.rst @@ -0,0 +1,2 @@ +Allow :class:`datetime.datetime` to accept type parameters at runtime, for +example ``datetime[tzinfo]``. diff --git a/Modules/_datetimemodule.c b/Modules/_datetimemodule.c index dbd14f1d707077..08b1ffe7860688 100644 --- a/Modules/_datetimemodule.c +++ b/Modules/_datetimemodule.c @@ -7305,6 +7305,9 @@ static PyMethodDef datetime_methods[] = { DATETIME_DATETIME___REDUCE_EX___METHODDEF DATETIME_DATETIME___REDUCE___METHODDEF + {"__class_getitem__", Py_GenericAlias, METH_O|METH_CLASS, + PyDoc_STR("See PEP 585")}, + {NULL, NULL} };