Add timestamp method+test; closes #17329

doc/source/api.rst

@@ -1793,6 +1793,7 @@ Methods
     Timestamp.strftime
     Timestamp.strptime
     Timestamp.time
+    Timestamp.timestamp
     Timestamp.timetuple
     Timestamp.timetz
     Timestamp.to_datetime64

doc/source/whatsnew/v0.21.0.txt

@@ -235,6 +235,7 @@ Other Enhancements
 - Improved the import time of pandas by about 2.25x.  (:issue:`16764`)
 - :func:`read_json` and :func:`to_json` now accept a ``compression`` argument which allows them to transparently handle compressed files. (:issue:`17798`)
 - :func:`Series.reindex`, :func:`DataFrame.reindex`, :func:`Index.get_indexer` now support list-like argument for ``tolerance``. (:issue:`17367`)
+- :meth:`Timestamp.timestamp` is now available in Python 2.7. (:issue:`17329`)
 
 .. _whatsnew_0210.api_breaking:
 

pandas/_libs/tslib.pyx

@@ -956,8 +956,7 @@ class NaTType(_NaT):
     combine = _make_error_func('combine', None)
     utcnow = _make_error_func('utcnow', None)
 
-    if PY3:
-        timestamp = _make_error_func('timestamp', datetime)
+    timestamp = _make_error_func('timestamp', Timestamp)
 
     # GH9513 NaT methods (except to_datetime64) to raise, return np.nan, or
     # return NaT create functions that raise, for binding to NaTType
@@ -1405,6 +1404,11 @@ cdef class _Timestamp(datetime):
         def __get__(self):
             return np.datetime64(self.value, 'ns')
 
+    def timestamp(self):
+        """Return POSIX timestamp as float."""
+        # py27 compat, see GH#17329
+        return self.value / 1e9
+
 
 cdef PyTypeObject* ts_type = <PyTypeObject*> Timestamp
 
@@ -3635,7 +3639,7 @@ cpdef int64_t tz_convert_single(int64_t val, object tz1, object tz2):
     """
     Convert the val (in i8) from timezone1 to timezone2
 
-    This is a single timezone versoin of tz_convert
+    This is a single timezone version of tz_convert
 
     Parameters
     ----------

pandas/tests/scalar/test_nat.py

@@ -123,6 +123,11 @@ def test_round_nat(klass):
             assert round_method(freq) is ts
 
 
+def test_timestamp():
+    # GH#17329
+    pytest.raises(ValueError, NaT.timestamp)
+
+
 def test_NaT_methods():
     # GH 9513
     raise_methods = ['astimezone', 'combine', 'ctime', 'dst',

pandas/tests/scalar/test_timestamp.py

@@ -19,7 +19,7 @@
 from pandas._libs import tslib, period
 from pandas._libs.tslibs.timezones import get_timezone
 
-from pandas.compat import lrange, long
+from pandas.compat import lrange, long, PY3
 from pandas.util.testing import assert_series_equal
 from pandas.compat.numpy import np_datetime64_compat
 from pandas import (Timestamp, date_range, Period, Timedelta, compat,
@@ -1079,6 +1079,23 @@ def test_is_leap_year(self):
             dt = Timestamp('2100-01-01 00:00:00', tz=tz)
             assert not dt.is_leap_year
 
+    def test_timestamp(self):
+        # GH#17329
+        # tz-naive --> treat it as if it were UTC for purposes of timestamp()
+        ts = Timestamp.now()
+        uts = ts.replace(tzinfo=utc)
+        assert ts.timestamp() == uts.timestamp()
+
+        tsc = Timestamp('2014-10-11 11:00:01.12345678', tz='US/Central')
+        utsc = tsc.tz_convert('UTC')
+        # utsc is a different representation of the same time
+        assert tsc.timestamp() == utsc.timestamp()
+
+        if PY3:
+            # should agree with datetime.timestamp method
+            dt = ts.to_pydatetime()
+            assert dt.timestamp() == round(ts.timestamp(), 6)
+
 
 class TestTimestampNsOperations(object):