@@ -595,6 +595,10 @@ def tz(self) -> tzinfo | None:
595595 """
596596 Return the timezone.
597597
598+ This property returns the timezone information associated with the
599+ datetime data. If the data is timezone-naive (i.e. has no timezone
600+ information), it returns None.
601+
598602 Returns
599603 -------
600604 zoneinfo.ZoneInfo,, datetime.tzinfo, pytz.tzinfo.BaseTZInfo, dateutil.tz.tz.tzfile, or None
@@ -861,6 +865,10 @@ def tz_convert(self, tz) -> Self:
861865 """
862866 Convert tz-aware Datetime Array/Index from one time zone to another.
863867
868+ This method converts datetime values from their current timezone to a
869+ different timezone. The underlying UTC time remains the same, only the
870+ local time representation changes to reflect the target timezone.
871+
864872 Parameters
865873 ----------
866874 tz : str, zoneinfo.ZoneInfo, pytz.timezone, dateutil.tz.tzfile, datetime.tzinfo or None
@@ -1288,6 +1296,10 @@ def month_name(self, locale=None) -> npt.NDArray[np.object_]:
12881296 """
12891297 Return the month names with specified locale.
12901298
1299+ This method returns the full name of the month (e.g., "January", "February")
1300+ for each datetime value in the Series/Index. The names can be localized
1301+ to different languages using the locale parameter.
1302+
12911303 Parameters
12921304 ----------
12931305 locale : str, optional
@@ -1356,6 +1368,10 @@ def day_name(self, locale=None) -> npt.NDArray[np.object_]:
13561368 """
13571369 Return the day names with specified locale.
13581370
1371+ This method returns the full name of the day of the week (e.g., "Monday",
1372+ "Tuesday") for each datetime value in the Series/Index. The names can be
1373+ localized to different languages using the locale parameter.
1374+
13591375 Parameters
13601376 ----------
13611377 locale : str, optional
@@ -1555,6 +1571,10 @@ def isocalendar(self) -> DataFrame:
15551571 """
15561572 Calculate year, week, and day according to the ISO 8601 standard.
15571573
1574+ The ISO 8601 standard defines the first week of the year as the week
1575+ containing the first Thursday. This method returns a DataFrame with
1576+ columns for the ISO year, ISO week number, and ISO day of week.
1577+
15581578 Returns
15591579 -------
15601580 DataFrame
@@ -1600,6 +1620,10 @@ def isocalendar(self) -> DataFrame:
16001620 """
16011621 The year of the datetime.
16021622
1623+ This attribute returns the year component of each datetime value
1624+ in the Series/Index. The returned values are integers representing
1625+ the calendar year.
1626+
16031627 See Also
16041628 --------
16051629 DatetimeIndex.month: The month as January=1, December=12.
@@ -1628,6 +1652,10 @@ def isocalendar(self) -> DataFrame:
16281652 """
16291653 The month as January=1, December=12.
16301654
1655+ This attribute returns the month component of each datetime value
1656+ in the Series/Index. Months are numbered from 1 (January) through
1657+ 12 (December).
1658+
16311659 See Also
16321660 --------
16331661 DatetimeIndex.year: The year of the datetime.
@@ -1656,6 +1684,10 @@ def isocalendar(self) -> DataFrame:
16561684 """
16571685 The day of the datetime.
16581686
1687+ This attribute returns the day of the month component of each
1688+ datetime value in the Series/Index. Values range from 1 to 31,
1689+ depending on the month.
1690+
16591691 See Also
16601692 --------
16611693 DatetimeIndex.year: The year of the datetime.
@@ -1685,6 +1717,10 @@ def isocalendar(self) -> DataFrame:
16851717 """
16861718 The hours of the datetime.
16871719
1720+ This attribute returns the hour component of each datetime value
1721+ in the Series/Index. Values range from 0 to 23, representing the
1722+ hour of the day in 24-hour format.
1723+
16881724 See Also
16891725 --------
16901726 DatetimeIndex.day: The day of the datetime.
@@ -1714,6 +1750,9 @@ def isocalendar(self) -> DataFrame:
17141750 """
17151751 The minutes of the datetime.
17161752
1753+ This attribute returns the minute component of each datetime value
1754+ in the Series/Index. Values range from 0 to 59.
1755+
17171756 See Also
17181757 --------
17191758 DatetimeIndex.hour: The hours of the datetime.
@@ -1742,6 +1781,9 @@ def isocalendar(self) -> DataFrame:
17421781 """
17431782 The seconds of the datetime.
17441783
1784+ This attribute returns the second component of each datetime value
1785+ in the Series/Index. Values range from 0 to 59.
1786+
17451787 See Also
17461788 --------
17471789 DatetimeIndex.minute: The minutes of the datetime.
@@ -1771,6 +1813,10 @@ def isocalendar(self) -> DataFrame:
17711813 """
17721814 The microseconds of the datetime.
17731815
1816+ This attribute returns the microsecond component of each datetime
1817+ value in the Series/Index. Values range from 0 to 999999
1818+ (one microsecond is one millionth of a second).
1819+
17741820 See Also
17751821 --------
17761822 DatetimeIndex.second: The seconds of the datetime.
@@ -1799,6 +1845,10 @@ def isocalendar(self) -> DataFrame:
17991845 """
18001846 The nanoseconds of the datetime.
18011847
1848+ This attribute returns the nanosecond component of each datetime
1849+ value in the Series/Index. Values range from 0 to 999
1850+ (one nanosecond is one billionth of a second).
1851+
18021852 See Also
18031853 --------
18041854 DatetimeIndex.second: The seconds of the datetime.
@@ -1865,6 +1915,9 @@ def isocalendar(self) -> DataFrame:
18651915 """
18661916 The ordinal day of the year.
18671917
1918+ This attribute returns the day of the year for each datetime value
1919+ in the Series/Index. Values range from 1 to 365 (or 366 for leap years).
1920+
18681921 See Also
18691922 --------
18701923 DatetimeIndex.dayofweek : The day of the week with Monday=0, Sunday=6.
@@ -1900,6 +1953,11 @@ def isocalendar(self) -> DataFrame:
19001953 """
19011954 The quarter of the date.
19021955
1956+ This attribute returns the quarter of the year for each datetime value
1957+ in the Series/Index. Quarter 1 includes January through March, quarter 2
1958+ includes April through June, quarter 3 includes July through September,
1959+ and quarter 4 includes October through December.
1960+
19031961 See Also
19041962 --------
19051963 DatetimeIndex.snap : Snap time stamps to nearest occurring frequency.
@@ -1935,6 +1993,10 @@ def isocalendar(self) -> DataFrame:
19351993 """
19361994 The number of days in the month.
19371995
1996+ This attribute returns the total number of days in the month for each
1997+ datetime value in the Series/Index. The value depends on the month and
1998+ whether the year is a leap year (e.g., February has 29 days in a leap year).
1999+
19382000 See Also
19392001 --------
19402002 Series.dt.day : Return the day of the month.
@@ -1962,6 +2024,9 @@ def isocalendar(self) -> DataFrame:
19622024 _is_month_doc = """
19632025 Indicates whether the date is the {first_or_last} day of the month.
19642026
2027+ This boolean attribute evaluates to True if the date falls on the
2028+ {first_or_last} day of a calendar month, and False otherwise.
2029+
19652030 Returns
19662031 -------
19672032 Series or array
@@ -2017,6 +2082,10 @@ def isocalendar(self) -> DataFrame:
20172082 """
20182083 Indicator for whether the date is the first day of a quarter.
20192084
2085+ This boolean attribute evaluates to True if the date falls on the
2086+ first day of a calendar quarter (January 1, April 1, July 1, or
2087+ October 1), and False otherwise.
2088+
20202089 Returns
20212090 -------
20222091 is_quarter_start : Series or DatetimeIndex
@@ -2059,6 +2128,10 @@ def isocalendar(self) -> DataFrame:
20592128 """
20602129 Indicator for whether the date is the last day of a quarter.
20612130
2131+ This boolean attribute evaluates to True if the date falls on the
2132+ last day of a calendar quarter (March 31, June 30, September 30, or
2133+ December 31), and False otherwise.
2134+
20622135 Returns
20632136 -------
20642137 is_quarter_end : Series or DatetimeIndex
@@ -2101,6 +2174,9 @@ def isocalendar(self) -> DataFrame:
21012174 """
21022175 Indicate whether the date is the first day of a year.
21032176
2177+ This boolean attribute evaluates to True if the date is January 1st,
2178+ and False otherwise.
2179+
21042180 Returns
21052181 -------
21062182 Series or DatetimeIndex
@@ -2171,6 +2247,9 @@ def isocalendar(self) -> DataFrame:
21712247 """
21722248 Indicate whether the date is the last day of the year.
21732249
2250+ This boolean attribute evaluates to True if the date is December 31st,
2251+ and False otherwise.
2252+
21742253 Returns
21752254 -------
21762255 Series or DatetimeIndex
0 commit comments