Skip to main content
`Ctrl`+`K`

# 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:
    year int, optional

      The year to replace. If None, the year is not changed.

    month int, optional

      The month to replace. If None, the month is not changed.

    day int, optional

      The day to replace. If None, the day is not changed.

    hour int, optional

      The hour to replace. If None, the hour is not changed.

    minute int, optional

      The minute to replace. If None, the minute is not changed.

    second int, optional

      The second to replace. If None, the second is not changed.

    microsecond int, optional

      The microsecond to replace. If None, the microsecond is not changed.

    nanosecond int, optional

      The nanosecond to replace. If None, the nanosecond is not changed.

    tzinfo tz-convertible, optional

      The timezone information to replace. If None, the timezone is not changed.

    fold int, 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