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

Implements datetime.replace, handles nanoseconds.

This method creates a new Timestamp object by replacing the specified fields with new values. The new Timestamp retains the original fields that are not explicitly replaced. This method handles nanoseconds, and the tzinfo parameter allows for timezone replacement without conversion.

Parameters:

yearint, optional: The year to replace. If None, the year is not changed.
monthint, optional: The month to replace. If None, the month is not changed.
dayint, optional: The day to replace. If None, the day is not changed.
hourint, optional: The hour to replace. If None, the hour is not changed.
minuteint, optional: The minute to replace. If None, the minute is not changed.
secondint, optional: The second to replace. If None, the second is not changed.
microsecondint, optional: The microsecond to replace. If None, the microsecond is not changed.
nanosecondint, optional: The nanosecond to replace. If None, the nanosecond is not changed.
tzinfotz-convertible, optional: The timezone information to replace. If None, the timezone is not changed.
foldint, optional: The fold information to replace. If None, the fold is not changed.

Returns:

Timestamp: A new Timestamp object with the specified fields replaced.

See also

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

Notes

The replace method does not perform timezone conversions. If you need to convert the timezone, use the tz_convert method instead.

Examples

Create a timestamp object:

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

Replace year and the hour:

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

Replace timezone (not a conversion):

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

Analogous for pd.NaT:

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