pandas.Timestamp.fromtimestamp#

classmethod Timestamp.fromtimestamp(ts, tz=None)#

Create a Timestamp object from a POSIX timestamp.

This method converts a POSIX timestamp (the number of seconds since January 1, 1970, 00:00:00 UTC) into a Timestamp object. The resulting Timestamp can be localized to a specific time zone if provided.

Parameters:

tsfloat: The POSIX timestamp to convert, representing seconds since the epoch (1970-01-01 00:00:00 UTC).
tzstr, zoneinfo.ZoneInfo, pytz.timezone, dateutil.tz.tzfile, optional: Time zone for the Timestamp. If not provided, the Timestamp will be timezone-naive (i.e., without time zone information).

Returns:

Timestamp: A Timestamp object representing the given POSIX timestamp.

See also

Timestamp: Represents a single timestamp, similar to datetime.
to_datetime: Converts various types of data to datetime.
datetime.datetime.fromtimestamp: Returns a datetime from a POSIX timestamp.

Examples

Convert a POSIX timestamp to a Timestamp:

>>> pd.Timestamp.fromtimestamp(1584199972)  
Timestamp('2020-03-14 15:32:52')

Note that the output may change depending on your local time and time zone:

>>> pd.Timestamp.fromtimestamp(1584199972, tz='UTC')  
Timestamp('2020-03-14 15:32:52+0000', tz='UTC')