pandas.Timestamp¶
-
class
pandas.
Timestamp
¶ Pandas replacement for datetime.datetime
Timestamp is the pandas equivalent of python’s Datetime and is interchangeable with it in most cases. It’s the type used for the entries that make up a DatetimeIndex, and other timeseries oriented data structures in pandas.
Parameters: ts_input : datetime-like, str, int, float
Value to be converted to Timestamp
freq : str, DateOffset
Offset which Timestamp will have
tz : str, pytz.timezone, dateutil.tz.tzfile or None
Time zone for time which Timestamp will have.
unit : str
Unit used for conversion if ts_input is of type int or float. The valid values are ‘D’, ‘h’, ‘m’, ‘s’, ‘ms’, ‘us’, and ‘ns’. For example, ‘s’ means seconds and ‘ms’ means milliseconds.
year, month, day : int
New in version 0.19.0.
hour, minute, second, microsecond : int, optional, default 0
New in version 0.19.0.
nanosecond : int, optional, default 0
New in version 0.23.0.
tzinfo : datetime.tzinfo, optional, default None
New in version 0.19.0.
Notes
There are essentially three calling conventions for the constructor. The primary form accepts four parameters. They can be passed by position or keyword.
The other two forms mimic the parameters from
datetime.datetime
. They can be passed by either position or keyword, but not both mixed together.Examples
Using the primary calling convention:
This converts a datetime-like string >>> pd.Timestamp(‘2017-01-01T12’) Timestamp(‘2017-01-01 12:00:00’)
This converts a float representing a Unix epoch in units of seconds >>> pd.Timestamp(1513393355.5, unit=’s’) Timestamp(‘2017-12-16 03:02:35.500000’)
This converts an int representing a Unix-epoch in units of seconds and for a particular timezone >>> pd.Timestamp(1513393355, unit=’s’, tz=’US/Pacific’) Timestamp(‘2017-12-15 19:02:35-0800’, tz=’US/Pacific’)
Using the other two forms that mimic the API for
datetime.datetime
:>>> pd.Timestamp(2017, 1, 1, 12) Timestamp('2017-01-01 12:00:00')
>>> pd.Timestamp(year=2017, month=1, day=1, hour=12) Timestamp('2017-01-01 12:00:00')
Attributes
tz
Alias for tzinfo weekday_name
(DEPRECATED) .. asm8 day dayofweek dayofyear days_in_month daysinmonth fold freq freqstr hour is_leap_year is_month_end is_month_start is_quarter_end is_quarter_start is_year_end is_year_start microsecond minute month nanosecond quarter second tzinfo value week weekofyear year Methods
astimezone
Convert tz-aware Timestamp to another time zone. ceil
return a new Timestamp ceiled to this resolution combine
(date, time)date, time -> datetime with same date and time fields ctime
Return ctime() style string. date
Return date object with same year, month and day. day_name
Return the day name of the Timestamp with specified locale. dst
Return self.tzinfo.dst(self). floor
return a new Timestamp floored to this resolution fromordinal
(ordinal[, freq, tz])passed an ordinal, translate and convert to a ts note: by definition there cannot be any tz info on the ordinal itself fromtimestamp
(ts)timestamp[, tz] -> tz’s local time from POSIX timestamp. isocalendar
Return a 3-tuple containing ISO year, week number, and weekday. isoweekday
Return the day of the week represented by the date. month_name
Return the month name of the Timestamp with specified locale. normalize
Normalize Timestamp to midnight, preserving tz information. now
([tz])Returns new Timestamp object representing current time local to tz. replace
implements datetime.replace, handles nanoseconds round
Round the Timestamp to the specified resolution strftime
format -> strftime() style string. strptime
string, format -> new datetime parsed from a string (like time.strptime()). time
Return time object with same time but with tzinfo=None. timestamp
Return POSIX timestamp as float. timetuple
Return time tuple, compatible with time.localtime(). timetz
Return time object with same time and tzinfo. to_datetime64
Returns a numpy.datetime64 object with ‘ns’ precision to_julian_date
Convert TimeStamp to a Julian Date. to_period
Return an period of which this timestamp is an observation. to_pydatetime
Convert a Timestamp object to a native Python datetime object. today
(cls[, tz])Return the current time in the local timezone. toordinal
Return proleptic Gregorian ordinal. tz_convert
Convert tz-aware Timestamp to another time zone. tz_localize
Convert naive Timestamp to local time zone, or remove timezone from tz-aware Timestamp. tzname
Return self.tzinfo.tzname(self). utcfromtimestamp
(ts)Construct a naive UTC datetime from a POSIX timestamp. utcnow
()Return a new Timestamp representing UTC day and time. utcoffset
Return self.tzinfo.utcoffset(self). utctimetuple
Return UTC time tuple, compatible with time.localtime(). weekday
Return the day of the week represented by the date. isoformat