remove deprecated components, move itemized deltas to pure Python

Author: ariebovenberg

CHANGELOG.md

@@ -1,5 +1,48 @@
 # Changelog
 
+## 0.11.0 (unreleased)
+
+**Breaking changes**
+
+- Removed the ``DateDelta`` and ``DateTimeDelta`` classes,
+  which were deprecated in 0.10.0.
+  Use ``ItemizedDateDelta`` and ``ItemizedDelta`` instead.
+- Removed the ``years()``, ``months()``, ``weeks()``, ``days()`` helper
+  functions, which were deprecated in 0.10.0.
+  Use ``ItemizedDateDelta(years=...)``, etc. instead,
+  or use keyword arguments directly (e.g. ``dt.add(years=1, months=2)``).
+- Removed the ``Date.__add__``/``__sub__`` operators with ``DateDelta``
+  and ``Date.__sub__`` between two dates (returning ``DateDelta``),
+  which were deprecated in 0.10.0.
+  Use ``add()``, ``subtract()``, ``since()``, or ``until()`` instead.
+- Removed the ``ignore_dst`` parameter from ``OffsetDateTime`` and
+  ``PlainDateTime`` methods, which was deprecated in 0.10.0.
+  Use ``stale_offset_ok=True`` (``OffsetDateTime``) or
+  ``naive_arithmetic_ok=True`` (``PlainDateTime``) instead.
+- Removed the ``py_date()``, ``py_time()``, ``py_datetime()``, and
+  ``py_timedelta()`` methods, which were deprecated in 0.10.0.
+  Use ``to_stdlib()`` instead.
+- Removed the ``from_py_date()``, ``from_py_time()``,
+  ``from_py_datetime()``, and ``from_py_timedelta()`` methods,
+  which were deprecated in 0.10.0.
+  Use the constructor directly (e.g. ``Date(datetime.date(...))``).
+- Removed ``TimeDelta.in_hours()``, ``.in_minutes()``, ``.in_seconds()``,
+  ``.in_milliseconds()``, ``.in_microseconds()``, ``.in_nanoseconds()``,
+  ``.in_days_of_24h()``, and ``.in_hrs_mins_secs_nanos()``,
+  which were deprecated in 0.10.0.
+  Use ``total()`` or ``in_units()`` instead.
+- Removed ``Date.days_since()`` and ``Date.days_until()``,
+  which were deprecated in 0.10.0.
+  Use ``since()`` and ``until()`` with ``total='days'`` instead.
+- Removed ``parse_strptime()`` methods on ``OffsetDateTime`` and
+  ``PlainDateTime``, which were deprecated in 0.10.0.
+  Use ``parse()`` instead.
+- Removed ``ZonedDateTime.start_of_day()``,
+  which was deprecated in 0.10.0.
+  Use ``start_of("day")`` instead.
+- Removed ``WheneverDeprecationWarning`` and ``ImplicitlyIgnoringDST``
+  exception classes, which are no longer needed.
+
 
 ## 0.10.1 (2026-05-??)
 

docs/guide/choosing-a-type.md

@@ -131,7 +131,7 @@ an efficient and compatible choice for representing times in the past.
 ```python
 >>> flight_departure = OffsetDateTime(2023, 4, 21, hour=9, offset=-4)
 >>> flight_arrival = OffsetDateTime(2023, 4, 21, hour=10, offset=-6)
->>> (flight_arrival - flight_departure).in_hours()
+>>> (flight_arrival - flight_departure).total("hours")
 3
 >>> # This will emit a warning!
 >>> flight_arrival.add(hours=3)  # a DST-bug waiting to happen!

docs/guide/parsing.md

@@ -78,13 +78,6 @@ ZonedDateTime("2024-03-15 14:30:00+01:00[Europe/Paris]")
 See the {ref}`pattern format reference <pattern-format>` for the
 full list of specifiers and details.
 
-```{deprecated} 0.10.0
-The ``parse_strptime()`` methods on ``OffsetDateTime`` and ``PlainDateTime``
-are deprecated. Use ``parse()`` with a pattern string instead, or convert
-from a stdlib datetime:
-``OffsetDateTime(datetime.strptime(...))``.
-```
-
 ## Pydantic integration
 
 ```{warning}

docs/guide/warnings.md

@@ -121,11 +121,6 @@ next_departure = scheduled.add(hours=1, naive_arithmetic_ok=True)
 The keyword argument documents the decision at the call site
 while keeping the suppression limited to exactly one operation.
 
-```{note}
-These keyword arguments supersede the ``ignore_dst`` keyword argument
-(deprecated in 0.10).
-```
-
 ### Operators
 
 The `+` and `-` operators always emit warnings when applicable, because

docs/reference/datetime.md

@@ -109,7 +109,6 @@ Several other methods are unique to one or more classes:
 |                                            |                                         | {meth}`~OffsetDateTime.assume_tz`      | {meth}`~PlainDateTime.assume_tz`                       |
 |                                            |                                         |                                        | {meth}`~PlainDateTime.assume_system_tz`                |
 |                                            |                                         |                                        | {meth}`~PlainDateTime.assume_fixed_offset`             |
-|                                            |                                         | {meth}`~OffsetDateTime.parse_strptime` *(deprecated)* | {meth}`~PlainDateTime.parse_strptime` *(deprecated)*                  |
 |                                            | {attr}`~ZonedDateTime.tz`               |                                        |                                                        |
 |                                            | {meth}`~ZonedDateTime.now_in_system_tz` |                                        |                                                        |
 |                                            | {meth}`~ZonedDateTime.is_ambiguous`     |                                        |                                                        |
@@ -118,7 +117,6 @@ Several other methods are unique to one or more classes:
 |                                            | {meth}`~ZonedDateTime.day_length`       |                                        |                                                        |
 |                                            | {meth}`~ZonedDateTime.next_transition`  |                                        |                                                        |
 |                                            | {meth}`~ZonedDateTime.prev_transition`  |                                        |                                                        |
-|                                            | {meth}`~ZonedDateTime.start_of_day` *(deprecated)* |                                        |                                                        |
 
 
 [^1]: `timestamp_millis()` and `timestamp_nanos()` methods are also

docs/reference/deltas.md

@@ -43,7 +43,7 @@ each suited for different use cases:
 
 ```{note}
 {class}`ItemizedDelta` and {class}`ItemizedDateDelta` were introduced in version 0.10,
-and replace the (now deprecated) {class}`DateTimeDelta` and {class}`DateDelta` classes.
+replacing the removed ``DateTimeDelta`` and ``DateDelta`` classes.
 ```
 
 

docs/reference/deprecated.rst

@@ -18,9 +18,6 @@ Warnings
 .. autoexception:: PotentialDstBugWarning
    :show-inheritance:
 
-.. autoexception:: WheneverDeprecationWarning
-   :show-inheritance:
-
 
 Exceptions
 ----------

docs/reference/exceptions.rst

@@ -10,7 +10,6 @@ This section contains API documentation for miscellaneous functions and data
 
     other-types
     exceptions
-    deprecated
 
 
 Context managers

docs/reference/misc.rst

@@ -175,8 +175,8 @@ See [](faq-leap-seconds) for details.
 
 ## Comparison with strftime
 
-The {meth}`~OffsetDateTime.parse_strptime` methods on {class}`OffsetDateTime` and
-{class}`PlainDateTime` are deprecated in favor of
+The removed ``parse_strptime()`` methods on {class}`OffsetDateTime` and
+{class}`PlainDateTime` have been replaced by
 {meth}`~OffsetDateTime.parse`. Here's a migration guide:
 
 | strftime | Pattern | Notes |