COMPAT: alias .to_numpy() for timestamp and timedelta scalars

Author: Chris Bertinato

doc/source/whatsnew/v0.24.2.rst

@@ -15,6 +15,12 @@ Whats New in 0.24.2 (February XX, 2019)
 These are the changes in pandas 0.24.2. See :ref:`release` for a full changelog
 including other versions of pandas.
 
+.. _whatsnew_0242.api:
+
+API Changes
+~~~~~~~~~~~
+- ``Timestamp`` and ``Timedelta`` scalars now implement the :meth:`to_numpy` method as aliases to :meth:`Timestamp.to_datetime64` and :meth:`Timedelta.to_timedelta64`, respectively.
+
 .. _whatsnew_0242.regressions:
 
 Fixed Regressions

pandas/_libs/tslibs/timedeltas.pyx

@@ -824,6 +824,10 @@ cdef class _Timedelta(timedelta):
         """ Returns a numpy.timedelta64 object with 'ns' precision """
         return np.timedelta64(self.value, 'ns')
 
+    def to_numpy(self, dtype=None, copy=False):
+        """ Alias to to_timedelta64 for Timedelta scalars """
+        return self.to_timedelta64()
+
     def total_seconds(self):
         """
         Total duration of timedelta in seconds (to ns precision)

pandas/_libs/tslibs/timestamps.pyx

@@ -343,6 +343,10 @@ cdef class _Timestamp(datetime):
         """ Returns a numpy.datetime64 object with 'ns' precision """
         return np.datetime64(self.value, 'ns')
 
+    def to_numpy(self, dtype=None, copy=False):
+        """ Alias to to_datetime64 for Timestamp scalars """
+        return self.to_datetime64()
+
     def __add__(self, other):
         cdef:
             int64_t other_int, nanos

pandas/tests/arithmetic/test_datetime64.py

@@ -2336,3 +2336,10 @@ def test_shift_months(years, months):
            for x in dti]
     expected = DatetimeIndex(raw)
     tm.assert_index_equal(actual, expected)
+
+
+def test_to_numpy_alias():
+    # GH 24653: alias .to_numpy() for scalars
+    ts = pd.Timestamp(datetime.now())
+    assert ts.to_datetime64() == ts.to_numpy()
+

pandas/tests/arithmetic/test_timedelta64.py

@@ -1975,3 +1975,9 @@ def test_td64arr_pow_invalid(self, scalar_td, box_with_array):
 
         with pytest.raises(TypeError, match=pattern):
             td1 ** scalar_td
+
+
+def test_to_numpy_alias():
+    # GH 24653: alias .to_numpy() for scalars
+    td = Timedelta('10m7s')
+    assert td.to_timedelta64() == td.to_numpy()