Skip to main content
`Ctrl`+`K`

# pandas.Series.dt.isocalendar

Series.dt.isocalendar()

  Calculate year, week, and day according to the ISO 8601 standard.

  The ISO 8601 standard defines the first week of the year as the week containing the first Thursday. This method returns a DataFrame with columns for the ISO year, ISO week number, and ISO day of week.

  Returns:
    DataFrame

      With columns year, week and day.

  See also

  `Timestamp.isocalendar`

    Function return a 3-tuple containing ISO year, week number, and weekday for the given Timestamp object.

  `datetime.date.isocalendar`

    Return a named tuple object with three components: year, week and weekday.

  Examples

      >>> ser = pd.to_datetime(pd.Series(["2010-01-01", pd.NaT]))
      >>> ser.dt.isocalendar()
         year  week  day
      0  2009    53     5
      1  <NA>  <NA>  <NA>
      >>> ser.dt.isocalendar().week
      0      53
      1    <NA>
      Name: week, dtype: UInt32