Fix doctest, typo

Author: jbrockmendel

pandas/conftest.py

@@ -146,6 +146,8 @@ def pytest_collection_modifyitems(items, config) -> None:
         ("Series.idxmax", "The behavior of Series.idxmax"),
         ("SeriesGroupBy.idxmin", "The behavior of Series.idxmin"),
         ("SeriesGroupBy.idxmax", "The behavior of Series.idxmax"),
+        ("DatetimeArray.time", "with pyarrow time dtype"),
+        ("DatetimeIndex.time", "with pyarrow time dtype"),
         # Docstring divides by zero to show behavior difference
         ("missing.mask_zero_div_zero", "divide by zero encountered"),
         (

pandas/core/arrays/datetimes.py

@@ -1387,7 +1387,7 @@ def time(self) -> npt.NDArray[np.object_] | ArrowExtensionArray:
         if opt is None:
             warnings.warn(
                 f"The behavior of {type(self).__name__}.time is deprecated. "
-                "In a future version, this will an array with pyarrow time "
+                "In a future version, this will return an array with pyarrow time "
                 "dtype instead of object dtype. To opt in to the future behavior, "
                 "set `pd.set_option('future.infer_time', True)`.",
                 FutureWarning,

pandas/tests/arrays/test_datetimes.py

@@ -156,7 +156,7 @@ def test_time_date(self, dta_dti, meth):
         dta, dti = dta_dti
 
         warn = None
-        msg = "In a future version, this will an array with pyarrow time dtype"
+        msg = "In a future version, this will return an array with pyarrow time dtype"
         if meth == "time":
             warn = FutureWarning
 

pandas/tests/generic/test_finalize.py

@@ -673,7 +673,7 @@ def test_datetime_property(attr):
     s.attrs = {"a": 1}
 
     warn = None
-    msg = "In a future version, this will an array with pyarrow time dtype"
+    msg = "In a future version, this will return an array with pyarrow time dtype"
     if attr == "time":
         warn = FutureWarning
     with tm.assert_produces_warning(warn, match=msg):

pandas/tests/indexes/datetimes/test_scalar_compat.py

@@ -24,7 +24,7 @@
 class TestDatetimeIndexOps:
     def test_dti_time(self):
         rng = date_range("1/1/2000", freq="12min", periods=10)
-        msg = "In a future version, this will an array with pyarrow time dtype"
+        msg = "In a future version, this will return an array with pyarrow time dtype"
         with tm.assert_produces_warning(FutureWarning, match=msg):
             result = pd.Index(rng).time
         expected = [t.time() for t in rng]

pandas/tests/indexes/datetimes/test_timezones.py

@@ -854,7 +854,7 @@ def test_time_accessor(self, dtype):
 
         index = DatetimeIndex(["2018-06-04 10:20:30", pd.NaT], dtype=dtype)
 
-        msg = "In a future version, this will an array with pyarrow time dtype"
+        msg = "In a future version, this will return an array with pyarrow time dtype"
         with tm.assert_produces_warning(FutureWarning, match=msg):
             result = index.time
 

pandas/tests/io/parser/test_parse_dates.py

@@ -479,7 +479,7 @@ def test_date_col_as_index_col(all_parsers):
     if parser.engine == "pyarrow":
         # https://github.com/pandas-dev/pandas/issues/44231
         # pyarrow 6.0 starts to infer time type
-        msg = "In a future version, this will an array with pyarrow time dtype"
+        msg = "In a future version, this will return an array with pyarrow time dtype"
         with tm.assert_produces_warning(FutureWarning, match=msg):
             expected["X2"] = pd.to_datetime("1970-01-01" + expected["X2"]).dt.time
 

pandas/tests/series/accessors/test_dt_accessor.py

@@ -91,7 +91,9 @@ def get_expected(ser, prop):
             return Series(result, index=ser.index, name=ser.name, dtype=result.dtype)
 
         if name == "time":
-            msg = "In a future version, this will an array with pyarrow time dtype"
+            msg = (
+                "In a future version, this will return an array with pyarrow time dtype"
+            )
             with tm.assert_produces_warning(FutureWarning, match=msg):
                 left = getattr(ser.dt, name)
                 right = get_expected(ser, name)
@@ -680,7 +682,7 @@ def test_valid_dt_with_missing_values(self):
         )
         tm.assert_series_equal(result, expected)
 
-        msg = "In a future version, this will an array with pyarrow time"
+        msg = "In a future version, this will return an array with pyarrow time"
         with tm.assert_produces_warning(FutureWarning, match=msg):
             result = ser.dt.time
         expected = Series([time(0), time(0), pd.NaT, time(0), time(0)], dtype="object")