Skip to main content
`Ctrl`+`K`

# pandas.Timestamp.to_period

Timestamp.to_period(freq=None)

  Return a period of which this timestamp is an observation.

  This method converts the given Timestamp to a Period object, which represents a span of time,such as a year, month, etc., based on the specified frequency.

  Parameters:
    freq str, optional

      Frequency string for the period (e.g., ‘Y’, ‘M’, ‘W’). Defaults to None.

  See also

  `Timestamp`

    Represents a specific timestamp.

  `Period`

    Represents a span of time.

  `to_period`

    Converts an object to a Period.

  Examples

      >>> ts = pd.Timestamp('2020-03-14T15:32:52.192548651')
      >>> # Year end frequency
      >>> ts.to_period(freq='Y')
      Period('2020', 'Y-DEC')

      >>> # Month end frequency
      >>> ts.to_period(freq='M')
      Period('2020-03', 'M')

      >>> # Weekly frequency
      >>> ts.to_period(freq='W')
      Period('2020-03-09/2020-03-15', 'W-SUN')

      >>> # Quarter end frequency
      >>> ts.to_period(freq='Q')
      Period('2020Q1', 'Q-DEC')