#1519 #1524

Author: cmp0xff

pandas-stubs/core/indexes/accessors.pyi

@@ -444,7 +444,9 @@ class TimedeltaIndexProperties(
 @type_check_only
 class DtDescriptor:
     @overload
-    def __get__(self, instance: Series[Never], owner: type[Series]) -> Properties: ...
+    def __get__(
+        self, instance: Series[Never], owner: type[Series]
+    ) -> TimestampProperties | TimedeltaProperties | PeriodProperties: ...
     @overload
     def __get__(
         self, instance: Series[Timestamp], owner: type[Series]

tests/series/test_properties.py

@@ -10,7 +10,6 @@
 from pandas.core.indexes.accessors import (
     DatetimeProperties,
     PeriodProperties,
-    Properties,
     TimedeltaProperties,
 )
 from pandas.core.indexes.interval import interval_range
@@ -49,12 +48,24 @@ def test_property_dt() -> None:
         PeriodProperties,
     )
 
+    df = DataFrame({"ts": [Timestamp(2025, 12, 6)], "td": [Timedelta(1, "s")]})
+    # python/mypy#19952: mypy gives Any
+    check(
+        assert_type(  # type: ignore[assert-type]
+            df["ts"].dt, "TimestampProperties | TimedeltaProperties | PeriodProperties"
+        ),
+        DatetimeProperties,
+    )
+    check(
+        assert_type(  # type: ignore[assert-type]
+            df["td"].dt, "TimestampProperties | TimedeltaProperties | PeriodProperties"
+        ),
+        TimedeltaProperties,
+    )
+
     if TYPE_CHECKING_INVALID_USAGE:
-        s = DataFrame({"a": [1]})["a"]
-        # python/mypy#19952: mypy believes Properties and its subclasses have a
-        # conflict and gives Any for s.dt
-        assert_type(s.dt, Properties)  # type: ignore[assert-type]
-        _1 = Series([1]).dt  # type: ignore[arg-type] # pyright: ignore[reportAttributeAccessIssue]
+        _0 = Series([1]).dt  # type: ignore[arg-type] # pyright: ignore[reportAttributeAccessIssue]
+        _1 = Series(["2025-01-01"]).dt  # type: ignore[arg-type] # pyright: ignore[reportAttributeAccessIssue]
 
 
 def test_property_array() -> None: