pandas.时间戳#

熊猫类 时间戳( ts_input=<object object>年=None月=None日=None小时=None分钟=None秒=None微秒=None tzinfo=None *纳秒=None tz=None ,单位=无,折叠=无) #

Pandas 替换 python datetime.datetime 对象。

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

参数
ts_input类似日期时间、str、int、float

要转换为时间戳的值。

年、月、日int
小时、分钟、秒、微秒int,可选,默认 0
tzinfo datetime.tzinfo,可选,默认无
纳秒int,可选,默认 0
tz str、pytz.timezone、dateutil.tz.tzfile 或 None

Timestamp 将具有的时间的时区。

单位str

如果 ts_input 的类型为 int 或 float,则用于转换的单位。有效值为“D”、“h”、“m”、“s”、“ms”、“us”和“ns”。例如,“s”表示秒,“ms”表示毫秒。

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

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

由于夏令时的原因,从夏季时间转换到冬季时间时,一个挂钟时间可能会出现两次; Fold 描述了 datetime-like 是否对应于挂钟到达模糊时间的第一次 (0) 还是第二次 (1)。

笔记

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

其他两种形式模仿 中的参数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 纪元的 int

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

使用模仿 API 的其他两种形式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')

属性

asm8

返回 numpy datetime64 格式(以纳秒为单位)。

day

day_of_week

返回星期几。

day_of_year

返回一年中的第几天。

dayofweek

返回星期几。

dayofyear

返回一年中的第几天。

days_in_month

返回该月的天数。

daysinmonth

返回该月的天数。

fold

hour

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

microsecond

min

minute

month

nanosecond

quarter

返回一年中的季度。

resolution

second

tz

tzinfo 的别名。

tzinfo

unit

与 self._creso 相关的缩写。

value

week

返回一年中的周数。

weekofyear

返回一年中的周数。

year

方法

as_unit(单位[, round_ok])

将底层 int64 表示形式转换为给定单位。

astimezone(兹)

将时区感知时间戳转换为另一个时区。

ceil(freq[, 不明确, 不存在])

返回此分辨率上限的新时间戳。

combine(约会时间)

将日期、时间合并为具有相同日期和时间字段的日期时间。

ctime()

返回 ctime() 样式字符串。

date()

返回具有相同年、月、日的日期对象。

day_name([语言环境])

返回具有指定区域设置的时间戳的日期名称。

dst()

返回夏令时 (DST) 调整。

floor(freq[, 不明确, 不存在])

返回一个基于此分辨率的新时间戳。

fromisocalendar

int, int, int -> 根据 ISO 年、周数和工作日构造日期。

fromisoformat

来自 datetime.isoformat() 输出的字符串 -> 日期时间

fromordinal(序数[,tz])

从一个预推的格里高利序数构造一个时间戳。

fromtimestamp(TS)

将 timestamp[, tz] 从 POSIX 时间戳转换为 tz 的本地时间。

isocalendar()

返回包含 ISO 年份、周数和工作日的命名元组。

isoformat([九月,时间规范])

返回根据 ISO 8601 格式化的时间。

isoweekday()

返回日期所代表的星期几。

month_name([语言环境])

返回具有指定区域设置的时间戳的月份名称。

normalize()

将时间戳标准化为午夜,保留 tz 信息。

now([兹])

返回表示 tz 本地当前时间的新 Timestamp 对象。

replace([年、月、日、小时、分钟...])

实现 datetime.replace,处理纳秒。

round(freq[, 不明确, 不存在])

将时间戳舍入到指定的分辨率。

strftime(格式)

返回时间戳的格式化字符串。

strptime(字符串、格式)

功能未实现。

time()

返回具有相同时间但 tzinfo=None 的时间对象。

timestamp()

以浮点数形式返回 POSIX 时间戳。

timetuple()

返回时间元组,与time.localtime()兼容。

timetz()

返回具有相同时间和tzinfo的时间对象。

to_datetime64()

返回具有相同精度的 numpy.datetime64 对象。

to_julian_date()

将时间戳转换为儒略日期。

to_numpy([数据类型,复制])

将时间戳转换为 NumPy datetime64。

to_period([频率])

返回此时间戳是一个观察值的时间段。

to_pydatetime([警告])

将 Timestamp 对象转换为本机 Python 日期时间对象。

today([兹])

返回本地时区的当前时间。

toordinal()

返回未推算的格里高利序数。

tz_convert(兹)

将时区感知时间戳转换为另一个时区。

tz_localize(tz[,不明确,不存在])

将时间戳本地化为时区。

tzname()

返回时区名称。

utcfromtimestamp(TS)

从 POSIX 时间戳构造一个时区感知的 UTC 日期时间。

utcnow()

返回代表 UTC 日期和时间的新时间戳。

utcoffset()

返回 utc 偏移量。

utctimetuple()

返回UTC时间元组,与time.localtime()兼容。

weekday()

返回日期所代表的星期几。