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 ~~~~~~~ diff --git a/pandas/core/arrays/datetimes.py b/pandas/core/arrays/datetimes.py index 30f45a4c57d87..4103b7c337efe 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 noon January 1, 4713 BC. + 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 : Equivalent 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 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