pandas.Series.dt.isocalendar#

Series.dt.isocalendar()[source]#

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