Deprecate week and weekofyear in DatetimeArray

Author: mgmarino

pandas/core/arrays/datetimes.py

@@ -172,8 +172,6 @@ class DatetimeArray(dtl.DatetimeLikeArrayMixin, dtl.TimelikeOps, dtl.DatelikeOps
         "hour",
         "minute",
         "second",
-        "weekofyear",
-        "week",
         "weekday",
         "dayofweek",
         "dayofyear",
@@ -1289,6 +1287,28 @@ def isocalendar(self):
             iso_calendar_df.iloc[self._isnan] = None
         return iso_calendar_df
 
+    @property
+    def weekofyear(self):
+        """
+        The week ordinal of the year.
+
+        .. deprecated:: 1.1.0
+
+        weekofyear and week have been deprecated.
+        Please use DatetimeArray.isocalendar().week instead.
+        """
+        import warnings
+
+        warnings.warn(
+            "weekofyear and week have been deprecated.  "
+            "Please use DatetimeArray.isocalendar().week instead.",
+            FutureWarning,
+            stacklevel=2,
+        )
+        return self.isocalendar().week
+
+    week = weekofyear
+
     year = _field_accessor(
         "year",
         "Y",
@@ -1473,14 +1493,6 @@ def isocalendar(self):
         dtype: int64
         """,
     )
-    weekofyear = _field_accessor(
-        "weekofyear",
-        "woy",
-        """
-        The week ordinal of the year.
-        """,
-    )
-    week = weekofyear
     _dayofweek_doc = """
     The day of the week with Monday=0, Sunday=6.
 

pandas/tests/arrays/test_datetimes.py

@@ -425,3 +425,11 @@ def test_min_max_empty(self, skipna, tz):
 
         result = arr.max(skipna=skipna)
         assert result is pd.NaT
+
+
+def test_week_and_week_of_year_are_deprecated():
+    arr = DatetimeArray._from_sequence(["2000-01-03"])
+    with tm.assert_produces_warning(FutureWarning):
+        arr.week
+    with tm.assert_produces_warning(FutureWarning):
+        arr.weekofyear