pandas.Timestamp.replace

Timestamp.replace(year=None, month=None, day=None, hour=None, minute=None, second=None, microsecond=None, nanosecond=None, tzinfo=<class 'object'>, fold=None)

实现 datetime.replace，处理纳秒。

此方法通过用新值替换指定字段来创建一个新的 Timestamp 对象。新的 Timestamp 保留未明确替换的原始字段。此方法处理纳秒，并且 tzinfo 参数允许在不转换的情况下替换时区。

参数:

年int, 可选

要替换的年份。如果 None，年份不会改变。

月份int, 可选

要替换的月份。如果 None，月份不会被改变。

天int, 可选

替换的日期。如果 None，则日期不变。

小时int, 可选

要替换的小时。如果 None，则小时不改变。

minuteint, 可选

分钟替换。如果 None，分钟不改变。

第二int, 可选

第二个要替换的。如果 None，则第二个不改变。

微秒int, 可选

要替换的微秒。如果为 None，则微秒不会被改变。

纳秒int, 可选

要替换的纳秒。如果 None，则纳秒不会被改变。

tzinfotz-convertible, 可选

要替换的时区信息。如果 None，则时区不变。

foldint, 可选

要替换的折叠信息。如果为 None，则折叠不变。

返回:

时间戳

一个带有指定字段替换的新 Timestamp 对象。

参见

时间戳

表示单个时间戳，类似于 datetime。

to_datetime

将各种类型的数据转换为日期时间。

注释

replace 方法不执行时区转换。如果需要转换时区，请使用 tz_convert 方法。

例子

创建一个时间戳对象：

>>> ts = pd.Timestamp('2020-03-14T15:32:52.192548651', tz='UTC')
>>> ts
Timestamp('2020-03-14 15:32:52.192548651+0000', tz='UTC')

替换年份和小时：

>>> ts.replace(year=1999, hour=10)
Timestamp('1999-03-14 10:32:52.192548651+0000', tz='UTC')

替换时区（不是转换）：

>>> import zoneinfo
>>> ts.replace(tzinfo=zoneinfo.ZoneInfo('US/Pacific'))
Timestamp('2020-03-14 15:32:52.192548651-0700', tz='US/Pacific')

类似于 pd.NaT：

>>> pd.NaT.replace(tzinfo=zoneinfo.ZoneInfo('US/Pacific'))
NaT