fix pre-commit.ci err

Author: uditbaliyan

pandas/_libs/tslibs/timestamps.pyx

@@ -833,8 +833,8 @@ cdef class _Timestamp(ABCTimestamp):
         See Also
         --------
         pandas.Timestamp.day_name : Returns the name of the day of the week.
-        pandas.Timestamp.strftime : Returns a formatted string representation of the Timestamp.
-        datetime.datetime.strftime : Returns a string representing the date and time, controlled by an explicit format string.
+        pandas.Timestamp.strftime : Returns a formatted string of the Timestamp.
+        datetime.datetime.strftime : Returns a string representing the date and time.
 
         Examples
         --------
@@ -928,7 +928,7 @@ cdef class _Timestamp(ABCTimestamp):
         """
         Return the quarter of the year for the `Timestamp`.
 
-        This property returns an integer representing the quarter of the year in 
+        This property returns an integer representing the quarter of the year in
         which the `Timestamp` falls. The quarters are defined as follows:
         - Q1: January 1 to March 31
         - Q2: April 1 to June 30
@@ -944,8 +944,8 @@ cdef class _Timestamp(ABCTimestamp):
         --------
         pandas.Timestamp.month : Returns the month of the `Timestamp`.
         pandas.Timestamp.year : Returns the year of the `Timestamp`.
-        pandas.Timestamp.is_quarter_end : Boolean property indicating if the `Timestamp` is at the end of a quarter.
-        pandas.Timestamp.is_quarter_start : Boolean property indicating if the `Timestamp` is at the start of a quarter.
+        pandas.Timestamp.is_quarter_end : Returns if `Timestamp` is at the quarter's end.
+        pandas.Timestamp.is_quarter_start : Indicates if `Timestamp` is at the quarter's start.
 
         Examples
         --------
@@ -1025,9 +1025,9 @@ cdef class _Timestamp(ABCTimestamp):
 
         See Also
         --------
-        pandas.Timestamp.floor : Round down the `Timestamp` to the nearest specified frequency.
-        pandas.Timestamp.ceil : Round up the `Timestamp` to the nearest specified frequency.
-        pandas.Timestamp.round : Round the `Timestamp` to the nearest specified frequency.
+        pandas.Timestamp.floor : Rounds `Timestamp` down to the nearest frequency.
+        pandas.Timestamp.ceil : Rounds `Timestamp` up to the nearest frequency.
+        pandas.Timestamp.round : Rounds `Timestamp` to the nearest frequency.
 
         Examples
         --------
@@ -1279,7 +1279,7 @@ cdef class _Timestamp(ABCTimestamp):
         pandas.Timestamp.fromtimestamp : Construct a `Timestamp` from a POSIX timestamp.
         datetime.datetime.timestamp : Equivalent method from the `datetime` module.
         pandas.Timestamp.to_pydatetime : Convert the `Timestamp` to a `datetime` object.
-        pandas.Timestamp.to_datetime64 : Convert the `Timestamp` to a `numpy.datetime64` object.
+        pandas.Timestamp.to_datetime64 : Converts `Timestamp` to `numpy.datetime64`.
 
         Examples
         --------
@@ -1370,10 +1370,10 @@ cdef class _Timestamp(ABCTimestamp):
         Parameters
         ----------
         dtype : dtype, optional
-            Data type of the output, ignored in this method as the return type 
+            Data type of the output, ignored in this method as the return type
             is always `numpy.datetime64`.
         copy : bool, default False
-            Whether to ensure that the returned value is a new object. This 
+            Whether to ensure that the returned value is a new object. This
             parameter is also ignored as the method does not support copying.
 
         Returns
@@ -1412,9 +1412,7 @@ cdef class _Timestamp(ABCTimestamp):
         Parameters
         ----------
         freq : str, optional
-            The frequency string representing the desired period (e.g., 'Y' for yearly,
-            'M' for monthly, 'W' for weekly, etc.). If not provided, the default is `None`,
-            which will infer the frequency.
+            Frequency string for the period (e.g., 'Y', 'M', 'W'). Defaults to `None`.
 
         See Also
         --------
@@ -1649,7 +1647,7 @@ class Timestamp(_Timestamp):
         See Also
         --------
         datetime.datetime.today : Returns the current local date.
-        pandas.Timestamp.now : Returns the current time with an option to specify timezone.
+        pandas.Timestamp.now : Returns current time with optional timezone.
         pandas.Timestamp : A class representing a specific timestamp.
 
         Examples
@@ -1746,17 +1744,17 @@ class Timestamp(_Timestamp):
         """
         Create a `Timestamp` object from a POSIX timestamp.
 
-        This method converts a POSIX timestamp (the number of seconds since 
-        January 1, 1970, 00:00:00 UTC) into a `Timestamp` object. The resulting 
+        This method converts a POSIX timestamp (the number of seconds since
+        January 1, 1970, 00:00:00 UTC) into a `Timestamp` object. The resulting
         `Timestamp` can be localized to a specific time zone if provided.
 
         Parameters
         ----------
         ts : float
-            The POSIX timestamp to convert, representing seconds since 
+            The POSIX timestamp to convert, representing seconds since
             the epoch (1970-01-01 00:00:00 UTC).
-        tz : str, zoneinfo.ZoneInfo, pytz.timezone, dateutil.tz.tzfile, or None, optional
-            Time zone for the `Timestamp`. If not provided, the `Timestamp` will 
+        tz : str, zoneinfo.ZoneInfo, pytz.timezone, dateutil.tz.tzfile, optional
+            Time zone for the `Timestamp`. If not provided, the `Timestamp` will
             be timezone-naive (i.e., without time zone information).
 
         Returns
@@ -1768,7 +1766,7 @@ class Timestamp(_Timestamp):
         --------
         pandas.Timestamp : Represents a single timestamp, similar to `datetime`.
         pandas.to_datetime : Converts various types of data to datetime.
-        datetime.datetime.fromtimestamp : Returns a datetime object from a POSIX timestamp.
+        datetime.datetime.fromtimestamp : Returns a datetime from a POSIX timestamp.
 
         Examples
         --------
@@ -1866,7 +1864,7 @@ class Timestamp(_Timestamp):
 
     def date(self):
         """
-        Return a `datetime.date` object with the same year, month, and day as the Timestamp.
+        Returns `datetime.date` with the same year, month, and day.
 
         This method extracts the date component from the `Timestamp` and returns
         it as a `datetime.date` object, discarding the time information.
@@ -2064,13 +2062,13 @@ class Timestamp(_Timestamp):
 
         This method converts the `Timestamp` into a time tuple, which is compatible
         with functions like `time.localtime()`. The time tuple is a named tuple with
-        attributes such as year, month, day, hour, minute, second, weekday, day of the year,
-        and daylight savings indicator.
+        attributes such as year, month, day, hour, minute, second, weekday,
+        day of the year, and daylight savings indicator.
 
         See Also
         --------
         time.localtime : Converts a POSIX timestamp into a time tuple.
-        pandas.Timestamp : The `Timestamp` object that represents a specific point in time.
+        pandas.Timestamp : The `Timestamp` that represents a specific point in time.
         datetime.datetime.timetuple : Equivalent method in the `datetime` module.
 
         Examples
@@ -2119,7 +2117,7 @@ class Timestamp(_Timestamp):
         See Also
         --------
         datetime.datetime.toordinal : Equivalent method in the `datetime` module.
-        pandas.Timestamp : The `Timestamp` object that represents a specific point in time.
+        pandas.Timestamp : The `Timestamp` that represents a specific point in time.
         pandas.Timestamp.fromordinal : Create a `Timestamp` from an ordinal.
 
         Examples