DOC: Added an example for each series.dt field accessor (#33259)

Author: ShaharNaveh

pandas/core/arrays/datetimes.py

@@ -1239,55 +1239,183 @@ def date(self):
  "Y",
  """
  The year of the datetime.
+
+ Examples
+ --------
+ >>> datetime_series = pd.Series(
+ ... pd.date_range("2000-01-01", periods=3, freq="Y")
+ ... )
+ >>> datetime_series
+ 0 2000-12-31
+ 1 2001-12-31
+ 2 2002-12-31
+ dtype: datetime64[ns]
+ >>> datetime_series.dt.year
+ 0 2000
+ 1 2001
+ 2 2002
+ dtype: int64
  """,
  )
  month = _field_accessor(
  "month",
  "M",
  """
  The month as January=1, December=12.
+
+ Examples
+ --------
+ >>> datetime_series = pd.Series(
+ ... pd.date_range("2000-01-01", periods=3, freq="M")
+ ... )
+ >>> datetime_series
+ 0 2000-01-31
+ 1 2000-02-29
+ 2 2000-03-31
+ dtype: datetime64[ns]
+ >>> datetime_series.dt.month
+ 0 1
+ 1 2
+ 2 3
+ dtype: int64
  """,
  )
  day = _field_accessor(
  "day",
  "D",
  """
  The day of the datetime.
+
+ Examples
+ --------
+ >>> datetime_series = pd.Series(
+ ... pd.date_range("2000-01-01", periods=3, freq="D")
+ ... )
+ >>> datetime_series
+ 0 2000-01-01
+ 1 2000-01-02
+ 2 2000-01-03
+ dtype: datetime64[ns]
+ >>> datetime_series.dt.day
+ 0 1
+ 1 2
+ 2 3
+ dtype: int64
  """,
  )
  hour = _field_accessor(
  "hour",
  "h",
  """
  The hours of the datetime.
+
+ Examples
+ --------
+ >>> datetime_series = pd.Series(
+ ... pd.date_range("2000-01-01", periods=3, freq="h")
+ ... )
+ >>> datetime_series
+ 0 2000-01-01 00:00:00
+ 1 2000-01-01 01:00:00
+ 2 2000-01-01 02:00:00
+ dtype: datetime64[ns]
+ >>> datetime_series.dt.hour
+ 0 0
+ 1 1
+ 2 2
+ dtype: int64
  """,
  )
  minute = _field_accessor(
  "minute",
  "m",
  """
  The minutes of the datetime.
+
+ Examples
+ --------
+ >>> datetime_series = pd.Series(
+ ... pd.date_range("2000-01-01", periods=3, freq="T")
+ ... )
+ >>> datetime_series
+ 0 2000-01-01 00:00:00
+ 1 2000-01-01 00:01:00
+ 2 2000-01-01 00:02:00
+ dtype: datetime64[ns]
+ >>> datetime_series.dt.minute
+ 0 0
+ 1 1
+ 2 2
+ dtype: int64
  """,
  )
  second = _field_accessor(
  "second",
  "s",
  """
  The seconds of the datetime.
+
+ Examples
+ --------
+ >>> datetime_series = pd.Series(
+ ... pd.date_range("2000-01-01", periods=3, freq="s")
+ ... )
+ >>> datetime_series
+ 0 2000-01-01 00:00:00
+ 1 2000-01-01 00:00:01
+ 2 2000-01-01 00:00:02
+ dtype: datetime64[ns]
+ >>> datetime_series.dt.second
+ 0 0
+ 1 1
+ 2 2
+ dtype: int64
  """,
  )
  microsecond = _field_accessor(
  "microsecond",
  "us",
  """
  The microseconds of the datetime.
+
+ Examples
+ --------
+ >>> datetime_series = pd.Series(
+ ... pd.date_range("2000-01-01", periods=3, freq="us")
+ ... )
+ >>> datetime_series
+ 0 2000-01-01 00:00:00.000000
+ 1 2000-01-01 00:00:00.000001
+ 2 2000-01-01 00:00:00.000002
+ dtype: datetime64[ns]
+ >>> datetime_series.dt.microsecond
+ 0 0
+ 1 1
+ 2 2
+ dtype: int64
  """,
  )
  nanosecond = _field_accessor(
  "nanosecond",
  "ns",
  """
  The nanoseconds of the datetime.
+
+ Examples
+ --------
+ >>> datetime_series = pd.Series(
+ ... pd.date_range("2000-01-01", periods=3, freq="ns")
+ ... )
+ >>> datetime_series
+ 0 2000-01-01 00:00:00.000000000
+ 1 2000-01-01 00:00:00.000000001
+ 2 2000-01-01 00:00:00.000000002
+ dtype: datetime64[ns]
+ >>> datetime_series.dt.nanosecond
+ 0 0
+ 1 1
+ 2 2
+ dtype: int64
  """,
  )
  weekofyear = _field_accessor(