From f37505200313d0a24e295c0ae8ceb388c7d1df52 Mon Sep 17 00:00:00 2001
From: Echedey Luis <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 12 Aug 2025 01:05:17 +0100
Subject: [PATCH 1/5] Add to_julian_date to DatetimeIndex methods listing

---
 pandas/core/indexes/datetimes.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/pandas/core/indexes/datetimes.py b/pandas/core/indexes/datetimes.py
index b79043e8f61c8..ce6ea1ed980dd 100644
--- a/pandas/core/indexes/datetimes.py
+++ b/pandas/core/indexes/datetimes.py
@@ -222,6 +222,7 @@ class DatetimeIndex(DatetimeTimedeltaMixin):
     to_pydatetime
     to_series
     to_frame
+    to_julian_date
     month_name
     day_name
     mean

From 7261c6221a5808d199132e3b7a8c4735b94db735 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Echedey=20Luis=20=C3=81lvarez?=
 <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 12 Aug 2025 01:40:11 +0100
Subject: [PATCH 2/5] Update indexing.rst

---
 doc/source/reference/indexing.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/doc/source/reference/indexing.rst b/doc/source/reference/indexing.rst
index 79a49b2030c3f..93f88db0843dc 100644
--- a/doc/source/reference/indexing.rst
+++ b/doc/source/reference/indexing.rst
@@ -390,6 +390,7 @@ Conversion
    DatetimeIndex.to_pydatetime
    DatetimeIndex.to_series
    DatetimeIndex.to_frame
+   DatetimeIndex.to_julian_date
 
 Methods
 ~~~~~~~

From 7149795430398e5a1cd20d5d5892802d9210e699 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Echedey=20Luis=20=C3=81lvarez?=
 <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 12 Aug 2025 02:21:10 +0100
Subject: [PATCH 3/5] Fix docstring checks

Validate Docstrings
Error: /home/runner/work/pandas/pandas/pandas/core/indexes/datetimes.py:296:SS06:pandas.DatetimeIndex.to_julian_date:Summary should fit in a single line
Error: /home/runner/work/pandas/pandas/pandas/core/indexes/datetimes.py:296:SS03:pandas.DatetimeIndex.to_julian_date:Summary does not end with a period
Error: /home/runner/work/pandas/pandas/pandas/core/indexes/datetimes.py:296:EX01:pandas.DatetimeIndex.to_julian_date:No examples section found
Error: /home/runner/work/pandas/pandas/pandas/core/indexes/datetimes.py:296:RT01:pandas.DatetimeIndex.to_julian_date:No Returns section found
Error: /home/runner/work/pandas/pandas/pandas/core/indexes/datetimes.py:296:SA01:pandas.DatetimeIndex.to_julian_date:See Also section not found
Validate Docstrings DONE
Error: Process completed with exit code 5.
---
 pandas/core/arrays/datetimes.py | 21 +++++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

diff --git a/pandas/core/arrays/datetimes.py b/pandas/core/arrays/datetimes.py
index 30f45a4c57d87..17fcb81c511b0 100644
--- a/pandas/core/arrays/datetimes.py
+++ b/pandas/core/arrays/datetimes.py
@@ -2254,9 +2254,26 @@ def isocalendar(self) -> DataFrame:
 
     def to_julian_date(self) -> npt.NDArray[np.float64]:
         """
-        Convert Datetime Array to float64 ndarray of Julian Dates.
-        0 Julian date is noon January 1, 4713 BC.
+        Convert TimeStamp to a Julian Date.
+
+        This method returns the number of days as a float since
+
         https://en.wikipedia.org/wiki/Julian_day
+
+        Returns
+        -------
+        ndarray or Index
+            Float values that represent each date in Julian Calendar.
+
+        See Also
+        --------
+        Timestamp.to_julian_date : this same method on ``Timestamp`` objects.
+
+        Examples
+        --------
+        >>> idx = pd.DatetimeIndex(["2028-08-12 00:54", "2028-08-12 02:06"])
+        >>> idx.to_julian_date()
+        Index([2461995.5375, 2461995.5875], dtype='float64')
         """
 
         # http://mysite.verizon.net/aesir_research/date/jdalg2.htm

From 3fae8942eac7816dbc5b5edadeb1935a8bf9ee47 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Echedey=20Luis=20=C3=81lvarez?=
 <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 12 Aug 2025 02:45:12 +0100
Subject: [PATCH 4/5] Last doccheck, capitalization of description

---
 pandas/core/arrays/datetimes.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pandas/core/arrays/datetimes.py b/pandas/core/arrays/datetimes.py
index 17fcb81c511b0..d93b76195ad8f 100644
--- a/pandas/core/arrays/datetimes.py
+++ b/pandas/core/arrays/datetimes.py
@@ -2267,7 +2267,7 @@ def to_julian_date(self) -> npt.NDArray[np.float64]:
 
         See Also
         --------
-        Timestamp.to_julian_date : this same method on ``Timestamp`` objects.
+        Timestamp.to_julian_date : Equivalent method on ``Timestamp`` objects.
 
         Examples
         --------

From c63ffa7586b9bc3f06da53bf0c6526d443fa10e0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Echedey=20Luis=20=C3=81lvarez?=
 <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 13 Aug 2025 00:10:17 +0100
Subject: [PATCH 5/5] typo after proofreading docs

---
 pandas/core/arrays/datetimes.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pandas/core/arrays/datetimes.py b/pandas/core/arrays/datetimes.py
index d93b76195ad8f..4103b7c337efe 100644
--- a/pandas/core/arrays/datetimes.py
+++ b/pandas/core/arrays/datetimes.py
@@ -2256,7 +2256,7 @@ def to_julian_date(self) -> npt.NDArray[np.float64]:
         """
         Convert TimeStamp to a Julian Date.
 
-        This method returns the number of days as a float since
+        This method returns the number of days as a float since noon January 1, 4713 BC.
 
         https://en.wikipedia.org/wiki/Julian_day