Recommend .to_numpy() in lieu of .values

Author: Chris Bertinato

doc/source/whatsnew/v0.24.0.rst

@@ -1152,7 +1152,7 @@ Deprecations
 - Passing a string alias like ``'datetime64[ns, UTC]'`` as the ``unit`` parameter to :class:`DatetimeTZDtype` is deprecated. Use :class:`DatetimeTZDtype.construct_from_string` instead (:issue:`23990`).
 - In :meth:`Series.where` with Categorical data, providing an ``other`` that is not present in the categories is deprecated. Convert the categorical to a different dtype or add the ``other`` to the categories first (:issue:`24077`).
 - :meth:`Series.clip_lower`, :meth:`Series.clip_upper`, :meth:`DataFrame.clip_lower` and :meth:`DataFrame.clip_upper` are deprecated and will be removed in a future version. Use ``Series.clip(lower=threshold)``, ``Series.clip(upper=threshold)`` and the equivalent ``DataFrame`` methods (:issue:`24203`)
-- The functions :func:`pandas.to_datetime` and :func:`pandas.to_timedelta` have deprecated the ``box`` keyword. Use :attr:`Series.values` and :meth:`Timestamp.to_datetime64`/:meth:`Timedelta.to_timedelta64` instead to get an ndarray of values or ``numpy.timestamp64``/``numpy.timedelta64``, respectively (:issue:`24416`).
+- The functions :func:`pandas.to_datetime` and :func:`pandas.to_timedelta` have deprecated the ``box`` keyword. Use :meth:`.to_numpy` and :meth:`Timestamp.to_datetime64`/:meth:`Timedelta.to_timedelta64` instead to get an ndarray of values or ``numpy.datetime64``/``numpy.timedelta64``, respectively (:issue:`24416`).
 
 .. _whatsnew_0240.deprecations.datetimelike_int_ops:
 

pandas/core/tools/datetimes.py

@@ -439,7 +439,7 @@ def to_datetime(arg, errors='raise', dayfirst=False, yearfirst=False,
         - If False returns ndarray of values.
 
         .. deprecated:: 0.24.0
-            Use :attr:`Series.values` or :meth:`Timestamp.to_datetime64`
+            Use :meth:`.to_numpy` or :meth:`Timestamp.to_datetime64`
             instead to get an ndarray of values or numpy.datetime64,
             respectively.
 

pandas/core/tools/timedeltas.py

@@ -45,7 +45,7 @@ def to_timedelta(arg, unit='ns', box=True, errors='raise'):
           values of dtype timedelta64[ns].
 
         .. deprecated:: 0.24.0
-            Use :attr:`Series.values` or :meth:`Timedelta.to_timedelta64`
+            Use :meth:`.to_numpy` or :meth:`Timedelta.to_timedelta64`
             instead to get an ndarray of values or numpy.timedelta64,
             respectively.