pandas.Timestamp#

class pandas.Timestamp(ts_input=<object object>, year=None, month=None, day=None, hour=None, minute=None, second=None, microsecond=None, tzinfo=None, *, nanosecond=None, tz=<object object>, unit=None, fold=None)#

Pandas 用于替换 python datetime.datetime 对象的替代品。

Timestamp 是 pandas 中相当于 python 的 Datetime，在大多数情况下可以与它互换。它是构成 DatetimeIndex 以及其他面向时间序列的数据结构中的条目所使用的类型。

参数:

ts_inputdatetime-like, str, int, float

要转换为时间戳的值。

年int

年份的值。

月份int

月份的值

天int

一天的价值。

小时int, 可选, 默认值 0

小时的值。

minuteint, 可选, 默认值 0

分钟的值。

第二int, 可选, 默认值 0

第二个的值

微秒int, 可选, 默认值 0

微秒的值。

tzinfodatetime.tzinfo, 可选, 默认 None

时区信息。

纳秒int, 可选, 默认值 0

纳秒的值。

tzstr, zoneinfo.ZoneInfo, pytz.timezone, dateutil.tz.tzfile 或 None

时间戳将具有的时间区域。

单元str

如果 ts_input 是 int 或 float 类型，用于转换的单位。有效值为 ‘W’, ‘D’, ‘h’, ‘m’, ‘s’, ‘ms’, ‘us’, 和 ‘ns’。例如，’s’ 表示秒，’ms’ 表示毫秒。

对于浮点输入，结果将以纳秒为单位存储，并且单位属性将设置为 'ns'。

折叠{0, 1}, 默认 None, 仅关键字

由于夏令时，当从夏令时转换到冬令时时，一个挂钟时间可能会出现两次；fold 描述了 datetime-like 对应的是挂钟第一次（0）还是第二次（1）到达这个模糊时间。

参见

Timedelta: 表示一个持续时间，即两个日期或时间之间的差异。
datetime.datetime: Python datetime.datetime 对象。

备注

构造函数基本上有三种调用约定。主要形式接受四个参数。它们可以通过位置或关键字传递。

另外两种形式模仿了 datetime.datetime 的参数。它们可以通过位置或关键字传递，但不能混合使用。

例子

使用主要的调用约定：

这将转换一个类似日期时间的字符串

>>> pd.Timestamp('2017-01-01T12')
Timestamp('2017-01-01 12:00:00')

这将一个表示Unix纪元（以秒为单位）的浮点数进行转换

>>> pd.Timestamp(1513393355.5, unit='s')
Timestamp('2017-12-16 03:02:35.500000')

这将转换一个表示Unix纪元（以周为单位）的整数

>>> pd.Timestamp(1535, unit='W')
Timestamp('1999-06-03 00:00:00')

这将转换一个表示Unix纪元（以秒为单位）的整数，并针对特定时区进行转换

>>> pd.Timestamp(1513393355, unit='s', tz='US/Pacific')
Timestamp('2017-12-15 19:02:35-0800', tz='US/Pacific')

使用另外两种模仿 datetime.datetime API 的形式：

>>> 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')

属性

`asm8`	返回具有相同精度的 numpy datetime64 格式。
`天`	Return the day of the Timestamp.
`day_of_week`	返回星期几。
`day_of_year`	返回一年中的某一天。
`dayofweek`	返回星期几。
`dayofyear`	返回一年中的某一天。
`days_in_month`	返回月份中的天数。
`daysinmonth`	返回月份中的天数。
`fold`
`小时`
`is_leap_year`	如果年份是闰年，则返回 True。
`is_month_end`	检查日期是否是该月的最后一天。
`is_month_start`	检查日期是否是月份的第一天。
`is_quarter_end`	检查日期是否是季度的最后一天。
`is_quarter_start`	检查日期是否是季度的第一天。
`is_year_end`	如果日期是该年的最后一天，则返回 True。
`is_year_start`	如果日期是年份的第一天，则返回 True。
`max`
`微秒`
`min`
`分钟`
`月份`
`纳秒`
`季度`	返回 Timestamp 的年份季度。
`分辨率`
`秒`
`tz`	tzinfo 的别名。
`tzinfo`
`单位`	与 self._creso 相关的缩写。
`值`
`周`	返回一年中的周数。
`weekofyear`	返回一年中的周数。
`年`

方法

`as_unit`(unit[, round_ok])	将底层的 int64 表示转换为给定的单位。
`astimezone`(tz)	将时区感知的 Timestamp 转换为另一个时区。
`ceil`(freq[, ambiguous, nonexistent])	返回一个新的 Timestamp，向上舍入到此分辨率。
`combine`(date, time)	将日期和时间合并成一个单一的 Timestamp 对象。
`ctime`()	返回一个表示时间戳的 ctime() 样式字符串。
`日期`()	返回具有相同年、月和日的 datetime.date。
`day_name`([locale])	使用指定的区域设置返回时间戳的星期几名称。
`dst`()	返回夏令时（DST）调整。
`floor`(freq[, ambiguous, nonexistent])	返回一个新的 Timestamp，向下取整到此分辨率。
`fromisocalendar`	int, int, int -> 从ISO年份、周数和工作日构造一个日期。
`fromisoformat`	字符串 -> 从 datetime.isoformat() 输出转换为日期时间
`fromordinal`(ordinal[, tz])	从一个预设的格列高利序数构建一个时间戳。
`fromtimestamp`(ts[, tz])	从POSIX时间戳创建一个 Timestamp 对象。
`isocalendar`()	返回一个包含 ISO 年份、周数和工作日的命名元组。
`isoformat`([sep, timespec])	返回根据 ISO 8601 格式化的时间。
`isoweekday`()	返回由日期表示的星期几。
`month_name`([locale])	返回具有指定区域设置的 Timestamp 的月份名称。
`normalize`()	将时间戳标准化为午夜，保留时区信息。
`现在`([tz])	返回一个新的 Timestamp 对象，表示当前时间，本地化为 tz。
`replace`([year, month, day, hour, minute, ...])	实现 datetime.replace，处理纳秒。
`round`(freq[, ambiguous, nonexistent])	将时间戳四舍五入到指定的分辨率。
`strftime`(格式)	返回时间戳的格式化字符串。
`strptime`(date_string, format)	将字符串参数转换为日期时间。
`时间`()	返回一个时间对象，时间相同但 tzinfo=None。
`时间戳`()	返回 POSIX 时间戳作为浮点数。
`timetuple`()	返回时间元组，兼容 time.localtime()。
`timetz`()	返回具有相同时间和时区信息的时间对象。
`to_datetime64`()	返回一个具有相同精度的 NumPy datetime64 对象。
`to_julian_date`()	将时间戳转换为儒略日期。
`to_numpy`([dtype, copy])	将时间戳转换为 NumPy datetime64。
`to_period`([freq])	返回一个时间段，这个时间戳是该时间段的一个观察。
`to_pydatetime`([warn])	将一个 Timestamp 对象转换为原生的 Python datetime 对象。
`今天`([tz])	返回当前时间在本地时区的时间。
`toordinal`()	返回预测的公历序数。
`tz_convert`(tz)	将时区感知的 Timestamp 转换为另一个时区。
`tz_localize`(tz[, ambiguous, nonexistent])	将时间戳本地化为一个时区。
`tzname`()	返回时区名称。
`utcfromtimestamp`(ts)	从POSIX时间戳构造一个时区感知的UTC日期时间。
`utcnow`()	返回一个新的 Timestamp 表示 UTC 日期和时间。
`utcoffset`()	返回 utc 偏移量。
`utctimetuple`()	返回UTC时间元组，兼容 time.localtime()。
`工作日`()	返回由日期表示的星期几。