effect 4.0.0-beta.70 → 4.0.0-beta.72

package/dist/DateTime.d.ts

@@ -399,47 +399,94 @@ export type Disambiguation = "compatible" | "earlier" | "later" | "reject";
 /**
  * Checks whether a value is a `DateTime`.
  *
+ * **When to use**
+ *
+ * Use to narrow an unknown value before treating it as a `DateTime`.
+ *
+ * @see {@link isUtc} for narrowing a known `DateTime` to UTC
+ * @see {@link isZoned} for narrowing a known `DateTime` to zoned
+ *
  * @category guards
  * @since 3.6.0
  */
 export declare const isDateTime: (u: unknown) => u is DateTime;
 /**
- * Checks if a value is a `TimeZone`.
+ * Checks whether a value is a `TimeZone`.
+ *
+ * **When to use**
+ *
+ * Use to narrow unknown input to any `TimeZone` before passing it to APIs that
+ * accept either fixed-offset or named time zones.
+ *
+ * @see {@link isTimeZoneOffset} for narrowing to fixed-offset time zones
+ * @see {@link isTimeZoneNamed} for narrowing to named time zones
  *
  * @category guards
  * @since 3.6.0
  */
 export declare const isTimeZone: (u: unknown) => u is TimeZone;
 /**
- * Checks if a value is an offset-based `TimeZone`.
+ * Checks whether a value is an offset-based `TimeZone`.
+ *
+ * **When to use**
+ *
+ * Use when narrowing an unknown or union `TimeZone` value to the fixed-offset
+ * variant before reading its offset in milliseconds.
+ *
+ * @see {@link isTimeZone} for checking either time zone variant
+ * @see {@link isTimeZoneNamed} for narrowing to named time zones
  *
  * @category guards
  * @since 3.6.0
  */
 export declare const isTimeZoneOffset: (u: unknown) => u is TimeZone.Offset;
 /**
- * Checks if a value is a named `TimeZone` (IANA time zone).
+ * Checks whether a value is a named `TimeZone` (IANA time zone).
+ *
+ * **When to use**
+ *
+ * Use to narrow an unknown value to the `TimeZone.Named` variant before
+ * reading named-zone fields such as `id`.
+ *
+ * @see {@link isTimeZone} for checking either time zone variant
+ * @see {@link isTimeZoneOffset} for narrowing to fixed-offset time zones
  *
  * @category guards
  * @since 3.6.0
  */
 export declare const isTimeZoneNamed: (u: unknown) => u is TimeZone.Named;
 /**
- * Checks if a `DateTime` is a UTC `DateTime` (no time zone information).
+ * Checks whether a `DateTime` is a UTC `DateTime` (no time zone information).
+ *
+ * **When to use**
+ *
+ * Use to narrow a `DateTime` before passing it to code that requires a UTC
+ * value without an associated time zone.
+ *
+ * @see {@link isZoned} for narrowing to zoned date-times
+ * @see {@link match} for handling both UTC and zoned cases
  *
  * @category guards
  * @since 3.6.0
  */
 export declare const isUtc: (self: DateTime) => self is Utc;
 /**
- * Checks if a `DateTime` is a zoned `DateTime` (has time zone information).
+ * Checks whether a `DateTime` is a zoned `DateTime` (has time zone information).
+ *
+ * **When to use**
+ *
+ * Use to narrow a known `DateTime` before reading its zone or passing it to
+ * APIs that require `DateTime.Zoned`.
+ *
+ * @see {@link isUtc} for narrowing to UTC date-times
+ * @see {@link match} for handling both UTC and zoned cases
  *
  * @category guards
  * @since 3.6.0
  */
 export declare const isZoned: (self: DateTime) => self is Zoned;
 /**
- * An `Equivalence` for comparing two `DateTime` values for equality.
+ * Provides an `Equivalence` for comparing two `DateTime` values for equality.
  *
  * **Details**
  *
@@ -464,7 +511,7 @@ export declare const isZoned: (self: DateTime) => self is Zoned;
  */
 export declare const Equivalence: Equ.Equivalence<DateTime>;
 /**
- * An `Order` for comparing and sorting `DateTime` values.
+ * Provides an `Order` for comparing and sorting `DateTime` values.
  *
  * **Details**
  *
@@ -491,7 +538,7 @@ export declare const Equivalence: Equ.Equivalence<DateTime>;
  */
 export declare const Order: order.Order<DateTime>;
 /**
- * Clamp a `DateTime` between a minimum and maximum value.
+ * Returns a `DateTime` constrained between a minimum and maximum value.
  *
  * **Details**
  *
@@ -512,12 +559,12 @@ export declare const Order: order.Order<DateTime>;
  * // clamped equals max (2024-12-31)
  * ```
  *
- * @category instances
+ * @category ordering
  * @since 3.6.0
  */
 export declare const clamp: {
     /**
-     * Clamp a `DateTime` between a minimum and maximum value.
+     * Returns a `DateTime` constrained between a minimum and maximum value.
      *
      * **Details**
      *
@@ -538,7 +585,7 @@ export declare const clamp: {
      * // clamped equals max (2024-12-31)
      * ```
      *
-     * @category instances
+     * @category ordering
      * @since 3.6.0
      */
     <Min extends DateTime, Max extends DateTime>(options: {
@@ -546,7 +593,7 @@ export declare const clamp: {
         readonly maximum: Max;
     }): <A extends DateTime>(self: A) => A | Min | Max;
     /**
-     * Clamp a `DateTime` between a minimum and maximum value.
+     * Returns a `DateTime` constrained between a minimum and maximum value.
      *
      * **Details**
      *
@@ -567,7 +614,7 @@ export declare const clamp: {
      * // clamped equals max (2024-12-31)
      * ```
      *
-     * @category instances
+     * @category ordering
      * @since 3.6.0
      */
     <A extends DateTime, Min extends DateTime, Max extends DateTime>(self: A, options: {
@@ -667,7 +714,7 @@ export declare const makeZonedUnsafe: (input: DateTime.Input, options?: {
     readonly disambiguation?: Disambiguation | undefined;
 }) => Zoned;
 /**
- * Creates a `DateTime.Zoned` from an input and a time zone.
+ * Creates a `DateTime.Zoned` safely from an input and a time zone.
  *
  * **Details**
  *
@@ -711,7 +758,7 @@ export declare const makeZoned: (input: DateTime.Input, options?: {
     readonly disambiguation?: Disambiguation | undefined;
 }) => Option.Option<Zoned>;
 /**
- * Creates a `DateTime` from supported input values.
+ * Creates a `DateTime` safely from supported input values.
  *
  * **Details**
  *
@@ -751,7 +798,7 @@ export declare const makeZoned: (input: DateTime.Input, options?: {
  */
 export declare const make: <A extends DateTime.Input>(input: A) => Option.Option<DateTime.PreserveZone<A>>;
 /**
- * Parses an ISO zoned date-time string into a `DateTime.Zoned`.
+ * Parses an ISO zoned date-time string into a `DateTime.Zoned` safely.
  *
  * **Details**
  *
@@ -782,7 +829,7 @@ export declare const make: <A extends DateTime.Input>(input: A) => Option.Option
  */
 export declare const makeZonedFromString: (input: string) => Option.Option<Zoned>;
 /**
- * Get the current time using the `Clock` service and convert it to a `DateTime`.
+ * Gets the current time using the `Clock` service and convert it to a `DateTime`.
  *
  * **Example** (Getting the current DateTime)
  *
@@ -818,7 +865,7 @@ export declare const now: Effect.Effect<Utc>;
  */
 export declare const nowAsDate: Effect.Effect<Date>;
 /**
- * Get the current time using `Date.now`.
+ * Gets the current time using `Date.now`.
  *
  * **Details**
  *
@@ -839,7 +886,16 @@ export declare const nowAsDate: Effect.Effect<Date>;
  */
 export declare const nowUnsafe: LazyArg<Utc>;
 /**
- * For a `DateTime` returns a new `DateTime.Utc`.
+ * Converts a `DateTime` to a UTC `DateTime`.
+ *
+ * **When to use**
+ *
+ * Use to represent the same instant in UTC instead of its current time zone.
+ *
+ * **Details**
+ *
+ * The returned value keeps the same epoch milliseconds and changes only the
+ * `DateTime` representation to UTC.
  *
  * **Example** (Converting DateTime values to UTC)
  *
@@ -859,7 +915,7 @@ export declare const nowUnsafe: LazyArg<Utc>;
  */
 export declare const toUtc: (self: DateTime) => Utc;
 /**
- * Set the time zone of a `DateTime`, returning a new `DateTime.Zoned`.
+ * Sets the time zone of a `DateTime`, returning a new `DateTime.Zoned`.
  *
  * **Example** (Setting time zones)
  *
@@ -880,7 +936,7 @@ export declare const toUtc: (self: DateTime) => Utc;
  */
 export declare const setZone: {
     /**
-     * Set the time zone of a `DateTime`, returning a new `DateTime.Zoned`.
+     * Sets the time zone of a `DateTime`, returning a new `DateTime.Zoned`.
      *
      * **Example** (Setting time zones)
      *
@@ -904,7 +960,7 @@ export declare const setZone: {
         readonly disambiguation?: Disambiguation | undefined;
     }): (self: DateTime) => Zoned;
     /**
-     * Set the time zone of a `DateTime`, returning a new `DateTime.Zoned`.
+     * Sets the time zone of a `DateTime`, returning a new `DateTime.Zoned`.
      *
      * **Example** (Setting time zones)
      *
@@ -929,7 +985,7 @@ export declare const setZone: {
     }): Zoned;
 };
 /**
- * Add a fixed offset time zone to a `DateTime`.
+ * Adds a fixed offset time zone to a `DateTime`.
  *
  * **Details**
  *
@@ -953,7 +1009,7 @@ export declare const setZone: {
  */
 export declare const setZoneOffset: {
     /**
-     * Add a fixed offset time zone to a `DateTime`.
+     * Adds a fixed offset time zone to a `DateTime`.
      *
      * **Details**
      *
@@ -980,7 +1036,7 @@ export declare const setZoneOffset: {
         readonly disambiguation?: Disambiguation | undefined;
     }): (self: DateTime) => Zoned;
     /**
-     * Add a fixed offset time zone to a `DateTime`.
+     * Adds a fixed offset time zone to a `DateTime`.
      *
      * **Details**
      *
@@ -1008,7 +1064,7 @@ export declare const setZoneOffset: {
     }): Zoned;
 };
 /**
- * Attempt to create a named time zone from a IANA time zone identifier.
+ * Attempts to create a named time zone from an IANA time zone identifier.
  *
  * **Details**
  *
@@ -1059,7 +1115,7 @@ export declare const zoneMakeNamedUnsafe: (zoneId: string) => TimeZone.Named;
  */
 export declare const zoneMakeOffset: (offset: number) => TimeZone.Offset;
 /**
- * Create a named time zone from a IANA time zone identifier.
+ * Creates a named time zone safely from an IANA time zone identifier.
  *
  * **Details**
  *
@@ -1082,7 +1138,7 @@ export declare const zoneMakeOffset: (offset: number) => TimeZone.Offset;
  */
 export declare const zoneMakeNamed: (zoneId: string) => Option.Option<TimeZone.Named>;
 /**
- * Create a named time zone from a IANA time zone identifier.
+ * Creates a named time zone effectfully from an IANA time zone identifier.
  *
  * **Details**
  *
@@ -1126,7 +1182,7 @@ export declare const zoneMakeNamedEffect: (zoneId: string) => Effect.Effect<Time
  */
 export declare const zoneMakeLocal: () => TimeZone.Named;
 /**
- * Try to parse a `TimeZone` from a string.
+ * Tries to parse a `TimeZone` from a string safely.
  *
  * **Details**
  *
@@ -1151,7 +1207,7 @@ export declare const zoneMakeLocal: () => TimeZone.Named;
  */
 export declare const zoneFromString: (zone: string) => Option.Option<TimeZone>;
 /**
- * Format a `TimeZone` as a string.
+ * Formats a `TimeZone` as a string.
  *
  * **Example** (Formatting time zones)
  *
@@ -1170,7 +1226,7 @@ export declare const zoneFromString: (zone: string) => Option.Option<TimeZone>;
  */
 export declare const zoneToString: (self: TimeZone) => string;
 /**
- * Set the time zone of a `DateTime` from an IANA time zone identifier. If the
+ * Sets the time zone of a `DateTime` safely from an IANA time zone identifier. If the
  * time zone is invalid, `None` will be returned.
  *
  * **Example** (Setting named time zones safely)
@@ -1190,7 +1246,7 @@ export declare const zoneToString: (self: TimeZone) => string;
  */
 export declare const setZoneNamed: {
     /**
-     * Set the time zone of a `DateTime` from an IANA time zone identifier. If the
+     * Sets the time zone of a `DateTime` safely from an IANA time zone identifier. If the
      * time zone is invalid, `None` will be returned.
      *
      * **Example** (Setting named time zones safely)
@@ -1213,7 +1269,7 @@ export declare const setZoneNamed: {
         readonly disambiguation?: Disambiguation | undefined;
     }): (self: DateTime) => Option.Option<Zoned>;
     /**
-     * Set the time zone of a `DateTime` from an IANA time zone identifier. If the
+     * Sets the time zone of a `DateTime` safely from an IANA time zone identifier. If the
      * time zone is invalid, `None` will be returned.
      *
      * **Example** (Setting named time zones safely)
@@ -1237,7 +1293,7 @@ export declare const setZoneNamed: {
     }): Option.Option<Zoned>;
 };
 /**
- * Set the time zone of a `DateTime` from an IANA time zone identifier. If the
+ * Sets the time zone of a `DateTime` from an IANA time zone identifier. If the
  * time zone is invalid, an `IllegalArgumentError` will be thrown.
  *
  * **Example** (Setting named time zones unsafely)
@@ -1257,7 +1313,7 @@ export declare const setZoneNamed: {
  */
 export declare const setZoneNamedUnsafe: {
     /**
-     * Set the time zone of a `DateTime` from an IANA time zone identifier. If the
+     * Sets the time zone of a `DateTime` from an IANA time zone identifier. If the
      * time zone is invalid, an `IllegalArgumentError` will be thrown.
      *
      * **Example** (Setting named time zones unsafely)
@@ -1280,7 +1336,7 @@ export declare const setZoneNamedUnsafe: {
         readonly disambiguation?: Disambiguation | undefined;
     }): (self: DateTime) => Zoned;
     /**
-     * Set the time zone of a `DateTime` from an IANA time zone identifier. If the
+     * Sets the time zone of a `DateTime` from an IANA time zone identifier. If the
      * time zone is invalid, an `IllegalArgumentError` will be thrown.
      *
      * **Example** (Setting named time zones unsafely)
@@ -1304,7 +1360,7 @@ export declare const setZoneNamedUnsafe: {
     }): Zoned;
 };
 /**
- * Calulate the difference between two `DateTime` values, returning a
+ * Computes the difference between two `DateTime` values, returning a
  * `Duration` representing the amount of time between them.
  *
  * **Details**
@@ -1332,7 +1388,7 @@ export declare const setZoneNamedUnsafe: {
  */
 export declare const distance: {
     /**
-     * Calulate the difference between two `DateTime` values, returning a
+     * Computes the difference between two `DateTime` values, returning a
      * `Duration` representing the amount of time between them.
      *
      * **Details**
@@ -1360,7 +1416,7 @@ export declare const distance: {
      */
     (other: DateTime): (self: DateTime) => Duration.Duration;
     /**
-     * Calulate the difference between two `DateTime` values, returning a
+     * Computes the difference between two `DateTime` values, returning a
      * `Duration` representing the amount of time between them.
      *
      * **Details**
@@ -1505,7 +1561,7 @@ export declare const max: {
     <Self extends DateTime, That extends DateTime>(self: Self, that: That): Self | That;
 };
 /**
- * Checks if the first `DateTime` is after the second `DateTime`.
+ * Checks whether the first `DateTime` is after the second `DateTime`.
  *
  * **Example** (Checking whether a DateTime is later)
  *
@@ -1524,7 +1580,7 @@ export declare const max: {
  */
 export declare const isGreaterThan: {
     /**
-     * Checks if the first `DateTime` is after the second `DateTime`.
+     * Checks whether the first `DateTime` is after the second `DateTime`.
      *
      * **Example** (Checking whether a DateTime is later)
      *
@@ -1543,7 +1599,7 @@ export declare const isGreaterThan: {
      */
     (that: DateTime): (self: DateTime) => boolean;
     /**
-     * Checks if the first `DateTime` is after the second `DateTime`.
+     * Checks whether the first `DateTime` is after the second `DateTime`.
      *
      * **Example** (Checking whether a DateTime is later)
      *
@@ -1563,7 +1619,7 @@ export declare const isGreaterThan: {
     (self: DateTime, that: DateTime): boolean;
 };
 /**
- * Checks if the first `DateTime` is after or equal to the second `DateTime`.
+ * Checks whether the first `DateTime` is after or equal to the second `DateTime`.
  *
  * **Example** (Checking whether a DateTime is later or equal)
  *
@@ -1584,7 +1640,7 @@ export declare const isGreaterThan: {
  */
 export declare const isGreaterThanOrEqualTo: {
     /**
-     * Checks if the first `DateTime` is after or equal to the second `DateTime`.
+     * Checks whether the first `DateTime` is after or equal to the second `DateTime`.
      *
      * **Example** (Checking whether a DateTime is later or equal)
      *
@@ -1605,7 +1661,7 @@ export declare const isGreaterThanOrEqualTo: {
      */
     (that: DateTime): (self: DateTime) => boolean;
     /**
-     * Checks if the first `DateTime` is after or equal to the second `DateTime`.
+     * Checks whether the first `DateTime` is after or equal to the second `DateTime`.
      *
      * **Example** (Checking whether a DateTime is later or equal)
      *
@@ -1627,7 +1683,7 @@ export declare const isGreaterThanOrEqualTo: {
     (self: DateTime, that: DateTime): boolean;
 };
 /**
- * Checks if the first `DateTime` is before the second `DateTime`.
+ * Checks whether the first `DateTime` is before the second `DateTime`.
  *
  * **Example** (Checking whether a DateTime is earlier)
  *
@@ -1646,7 +1702,7 @@ export declare const isGreaterThanOrEqualTo: {
  */
 export declare const isLessThan: {
     /**
-     * Checks if the first `DateTime` is before the second `DateTime`.
+     * Checks whether the first `DateTime` is before the second `DateTime`.
      *
      * **Example** (Checking whether a DateTime is earlier)
      *
@@ -1665,7 +1721,7 @@ export declare const isLessThan: {
      */
     (that: DateTime): (self: DateTime) => boolean;
     /**
-     * Checks if the first `DateTime` is before the second `DateTime`.
+     * Checks whether the first `DateTime` is before the second `DateTime`.
      *
      * **Example** (Checking whether a DateTime is earlier)
      *
@@ -1685,7 +1741,7 @@ export declare const isLessThan: {
     (self: DateTime, that: DateTime): boolean;
 };
 /**
- * Checks if the first `DateTime` is before or equal to the second `DateTime`.
+ * Checks whether the first `DateTime` is before or equal to the second `DateTime`.
  *
  * **Example** (Checking whether a DateTime is earlier or equal)
  *
@@ -1706,7 +1762,7 @@ export declare const isLessThan: {
  */
 export declare const isLessThanOrEqualTo: {
     /**
-     * Checks if the first `DateTime` is before or equal to the second `DateTime`.
+     * Checks whether the first `DateTime` is before or equal to the second `DateTime`.
      *
      * **Example** (Checking whether a DateTime is earlier or equal)
      *
@@ -1727,7 +1783,7 @@ export declare const isLessThanOrEqualTo: {
      */
     (that: DateTime): (self: DateTime) => boolean;
     /**
-     * Checks if the first `DateTime` is before or equal to the second `DateTime`.
+     * Checks whether the first `DateTime` is before or equal to the second `DateTime`.
      *
      * **Example** (Checking whether a DateTime is earlier or equal)
      *
@@ -1749,7 +1805,7 @@ export declare const isLessThanOrEqualTo: {
     (self: DateTime, that: DateTime): boolean;
 };
 /**
- * Checks if a `DateTime` is between two other `DateTime` values (inclusive).
+ * Checks whether a `DateTime` is between two other `DateTime` values (inclusive).
  *
  * **Example** (Checking whether a DateTime is within bounds)
  *
@@ -1768,7 +1824,7 @@ export declare const isLessThanOrEqualTo: {
  */
 export declare const between: {
     /**
-     * Checks if a `DateTime` is between two other `DateTime` values (inclusive).
+     * Checks whether a `DateTime` is between two other `DateTime` values (inclusive).
      *
      * **Example** (Checking whether a DateTime is within bounds)
      *
@@ -1790,7 +1846,7 @@ export declare const between: {
         maximum: DateTime;
     }): (self: DateTime) => boolean;
     /**
-     * Checks if a `DateTime` is between two other `DateTime` values (inclusive).
+     * Checks whether a `DateTime` is between two other `DateTime` values (inclusive).
      *
      * **Example** (Checking whether a DateTime is within bounds)
      *
@@ -1813,7 +1869,7 @@ export declare const between: {
     }): boolean;
 };
 /**
- * Checks if a `DateTime` is in the future compared to the current time.
+ * Checks effectfully if a `DateTime` is in the future compared to the current time.
  *
  * **Details**
  *
@@ -1836,7 +1892,7 @@ export declare const between: {
  */
 export declare const isFuture: (self: DateTime) => Effect.Effect<boolean>;
 /**
- * Checks if a `DateTime` is in the future compared to the current time.
+ * Checks synchronously if a `DateTime` is in the future compared to the current time.
  *
  * **Details**
  *
@@ -1859,7 +1915,7 @@ export declare const isFuture: (self: DateTime) => Effect.Effect<boolean>;
  */
 export declare const isFutureUnsafe: (self: DateTime) => boolean;
 /**
- * Checks if a `DateTime` is in the past compared to the current time.
+ * Checks effectfully if a `DateTime` is in the past compared to the current time.
  *
  * **Details**
  *
@@ -1882,7 +1938,7 @@ export declare const isFutureUnsafe: (self: DateTime) => boolean;
  */
 export declare const isPast: (self: DateTime) => Effect.Effect<boolean>;
 /**
- * Checks if a `DateTime` is in the past compared to the current time.
+ * Checks synchronously if a `DateTime` is in the past compared to the current time.
  *
  * **Details**
  *
@@ -1905,7 +1961,7 @@ export declare const isPast: (self: DateTime) => Effect.Effect<boolean>;
  */
 export declare const isPastUnsafe: (self: DateTime) => boolean;
 /**
- * Get the UTC `Date` of a `DateTime`.
+ * Gets the UTC `Date` of a `DateTime`.
  *
  * **Details**
  *
@@ -1929,7 +1985,7 @@ export declare const isPastUnsafe: (self: DateTime) => boolean;
  */
 export declare const toDateUtc: (self: DateTime) => Date;
 /**
- * Convert a `DateTime` to a `Date`, applying the time zone first.
+ * Converts a `DateTime` to a `Date`, applying the time zone first.
  *
  * **Details**
  *
@@ -1955,7 +2011,7 @@ export declare const toDateUtc: (self: DateTime) => Date;
  */
 export declare const toDate: (self: DateTime) => Date;
 /**
- * Calculate the time zone offset of a `DateTime.Zoned` in milliseconds.
+ * Computes the time zone offset of a `DateTime.Zoned` in milliseconds.
  *
  * **Details**
  *
@@ -1980,7 +2036,7 @@ export declare const toDate: (self: DateTime) => Date;
  */
 export declare const zonedOffset: (self: Zoned) => number;
 /**
- * Format the time zone offset of a `DateTime.Zoned` as an ISO string.
+ * Formats the time zone offset of a `DateTime.Zoned` as an ISO string.
  *
  * **Details**
  *
@@ -2004,7 +2060,7 @@ export declare const zonedOffset: (self: Zoned) => number;
  */
 export declare const zonedOffsetIso: (self: Zoned) => string;
 /**
- * Get the milliseconds since the Unix epoch of a `DateTime`.
+ * Gets the milliseconds since the Unix epoch of a `DateTime`.
  *
  * **Details**
  *
@@ -2026,7 +2082,7 @@ export declare const zonedOffsetIso: (self: Zoned) => string;
  */
 export declare const toEpochMillis: (self: DateTime) => number;
 /**
- * Remove the time aspect of a `DateTime`, first adjusting for the time
+ * Removes the time aspect of a `DateTime`, first adjusting for the time
  * zone. It will return a `DateTime.Utc` only containing the date.
  *
  * **Example** (Removing time components)
@@ -2049,7 +2105,7 @@ export declare const toEpochMillis: (self: DateTime) => number;
  */
 export declare const removeTime: (self: DateTime) => Utc;
 /**
- * Get the different parts of a `DateTime` as an object.
+ * Gets the time-zone-adjusted parts of a `DateTime` as an object.
  *
  * **Details**
  *
@@ -2081,7 +2137,7 @@ export declare const removeTime: (self: DateTime) => Utc;
  */
 export declare const toParts: (self: DateTime) => DateTime.PartsWithWeekday;
 /**
- * Get the different parts of a `DateTime` as an object.
+ * Gets the UTC parts of a `DateTime` as an object.
  *
  * **Details**
  *
@@ -2106,7 +2162,7 @@ export declare const toParts: (self: DateTime) => DateTime.PartsWithWeekday;
  */
 export declare const toPartsUtc: (self: DateTime) => DateTime.PartsWithWeekday;
 /**
- * Get a part of a `DateTime` as a number.
+ * Gets one UTC part of a `DateTime` as a number.
  *
  * **Details**
  *
@@ -2127,7 +2183,7 @@ export declare const toPartsUtc: (self: DateTime) => DateTime.PartsWithWeekday;
  */
 export declare const getPartUtc: {
     /**
-     * Get a part of a `DateTime` as a number.
+     * Gets one UTC part of a `DateTime` as a number.
      *
      * **Details**
      *
@@ -2148,7 +2204,7 @@ export declare const getPartUtc: {
      */
     (part: keyof DateTime.PartsWithWeekday): (self: DateTime) => number;
     /**
-     * Get a part of a `DateTime` as a number.
+     * Gets one UTC part of a `DateTime` as a number.
      *
      * **Details**
      *
@@ -2170,7 +2226,7 @@ export declare const getPartUtc: {
     (self: DateTime, part: keyof DateTime.PartsWithWeekday): number;
 };
 /**
- * Get a part of a `DateTime` as a number.
+ * Gets one time-zone-adjusted part of a `DateTime` as a number.
  *
  * **Details**
  *
@@ -2193,7 +2249,7 @@ export declare const getPartUtc: {
  */
 export declare const getPart: {
     /**
-     * Get a part of a `DateTime` as a number.
+     * Gets one time-zone-adjusted part of a `DateTime` as a number.
      *
      * **Details**
      *
@@ -2216,7 +2272,7 @@ export declare const getPart: {
      */
     (part: keyof DateTime.PartsWithWeekday): (self: DateTime) => number;
     /**
-     * Get a part of a `DateTime` as a number.
+     * Gets one time-zone-adjusted part of a `DateTime` as a number.
      *
      * **Details**
      *
@@ -2240,7 +2296,7 @@ export declare const getPart: {
     (self: DateTime, part: keyof DateTime.PartsWithWeekday): number;
 };
 /**
- * Set the different parts of a `DateTime` as an object.
+ * Sets time-zone-adjusted parts on a `DateTime`.
  *
  * **Details**
  *
@@ -2266,7 +2322,7 @@ export declare const getPart: {
  */
 export declare const setParts: {
     /**
-     * Set the different parts of a `DateTime` as an object.
+     * Sets time-zone-adjusted parts on a `DateTime`.
      *
      * **Details**
      *
@@ -2292,7 +2348,7 @@ export declare const setParts: {
      */
     (parts: Partial<DateTime.PartsWithWeekday>): <A extends DateTime>(self: A) => A;
     /**
-     * Set the different parts of a `DateTime` as an object.
+     * Sets time-zone-adjusted parts on a `DateTime`.
      *
      * **Details**
      *
@@ -2319,7 +2375,7 @@ export declare const setParts: {
     <A extends DateTime>(self: A, parts: Partial<DateTime.PartsWithWeekday>): A;
 };
 /**
- * Set the different parts of a `DateTime` as an object.
+ * Sets UTC parts on a `DateTime`.
  *
  * **Details**
  *
@@ -2344,7 +2400,7 @@ export declare const setParts: {
  */
 export declare const setPartsUtc: {
     /**
-     * Set the different parts of a `DateTime` as an object.
+     * Sets UTC parts on a `DateTime`.
      *
      * **Details**
      *
@@ -2369,7 +2425,7 @@ export declare const setPartsUtc: {
      */
     (parts: Partial<DateTime.PartsWithWeekday>): <A extends DateTime>(self: A) => A;
     /**
-     * Set the different parts of a `DateTime` as an object.
+     * Sets UTC parts on a `DateTime`.
      *
      * **Details**
      *
@@ -2427,7 +2483,7 @@ declare const CurrentTimeZone_base: Context.ServiceClass<CurrentTimeZone, "effec
 export declare class CurrentTimeZone extends CurrentTimeZone_base {
 }
 /**
- * Set the time zone of a `DateTime` to the current time zone, which is
+ * Sets the time zone of a `DateTime` to the current time zone, which is
  * determined by the `CurrentTimeZone` service.
  *
  * **Example** (Setting the current time zone)
@@ -2448,7 +2504,7 @@ export declare class CurrentTimeZone extends CurrentTimeZone_base {
  */
 export declare const setZoneCurrent: (self: DateTime) => Effect.Effect<Zoned, never, CurrentTimeZone>;
 /**
- * Provide the `CurrentTimeZone` to an effect.
+ * Provides the `CurrentTimeZone` to an effect.
  *
  * **Example** (Providing the current time zone)
  *
@@ -2467,7 +2523,7 @@ export declare const setZoneCurrent: (self: DateTime) => Effect.Effect<Zoned, ne
  */
 export declare const withCurrentZone: {
     /**
-     * Provide the `CurrentTimeZone` to an effect.
+     * Provides the `CurrentTimeZone` to an effect.
      *
      * **Example** (Providing the current time zone)
      *
@@ -2486,7 +2542,7 @@ export declare const withCurrentZone: {
      */
     (value: TimeZone): <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, CurrentTimeZone>>;
     /**
-     * Provide the `CurrentTimeZone` to an effect.
+     * Provides the `CurrentTimeZone` to an effect.
      *
      * **Example** (Providing the current time zone)
      *
@@ -2506,7 +2562,7 @@ export declare const withCurrentZone: {
     <A, E, R>(self: Effect.Effect<A, E, R>, value: TimeZone): Effect.Effect<A, E, Exclude<R, CurrentTimeZone>>;
 };
 /**
- * Provide the `CurrentTimeZone` to an effect, using the system's local time
+ * Provides the `CurrentTimeZone` to an effect, using the system's local time
  * zone.
  *
  * **Example** (Providing the local time zone)
@@ -2525,7 +2581,7 @@ export declare const withCurrentZone: {
  */
 export declare const withCurrentZoneLocal: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, CurrentTimeZone>>;
 /**
- * Provide the `CurrentTimeZone` to an effect, using a offset.
+ * Provides the `CurrentTimeZone` to an effect, using an offset.
  *
  * **Example** (Providing a fixed-offset time zone)
  *
@@ -2543,7 +2599,7 @@ export declare const withCurrentZoneLocal: <A, E, R>(effect: Effect.Effect<A, E,
  */
 export declare const withCurrentZoneOffset: {
     /**
-     * Provide the `CurrentTimeZone` to an effect, using a offset.
+     * Provides the `CurrentTimeZone` to an effect, using an offset.
      *
      * **Example** (Providing a fixed-offset time zone)
      *
@@ -2561,7 +2617,7 @@ export declare const withCurrentZoneOffset: {
      */
     (offset: number): <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, CurrentTimeZone>>;
     /**
-     * Provide the `CurrentTimeZone` to an effect, using a offset.
+     * Provides the `CurrentTimeZone` to an effect, using an offset.
      *
      * **Example** (Providing a fixed-offset time zone)
      *
@@ -2580,7 +2636,7 @@ export declare const withCurrentZoneOffset: {
     <A, E, R>(effect: Effect.Effect<A, E, R>, offset: number): Effect.Effect<A, E, Exclude<R, CurrentTimeZone>>;
 };
 /**
- * Provide the `CurrentTimeZone` to an effect using an IANA time zone
+ * Provides the `CurrentTimeZone` to an effect using an IANA time zone
  * identifier.
  *
  * **Details**
@@ -2603,7 +2659,7 @@ export declare const withCurrentZoneOffset: {
  */
 export declare const withCurrentZoneNamed: {
     /**
-     * Provide the `CurrentTimeZone` to an effect using an IANA time zone
+     * Provides the `CurrentTimeZone` to an effect using an IANA time zone
      * identifier.
      *
      * **Details**
@@ -2626,7 +2682,7 @@ export declare const withCurrentZoneNamed: {
      */
     (zone: string): <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E | IllegalArgumentError, Exclude<R, CurrentTimeZone>>;
     /**
-     * Provide the `CurrentTimeZone` to an effect using an IANA time zone
+     * Provides the `CurrentTimeZone` to an effect using an IANA time zone
      * identifier.
      *
      * **Details**
@@ -2650,7 +2706,7 @@ export declare const withCurrentZoneNamed: {
     <A, E, R>(effect: Effect.Effect<A, E, R>, zone: string): Effect.Effect<A, E | IllegalArgumentError, Exclude<R, CurrentTimeZone>>;
 };
 /**
- * Get the current time as a `DateTime.Zoned`, using the `CurrentTimeZone`.
+ * Gets the current time as a `DateTime.Zoned`, using the `CurrentTimeZone`.
  *
  * **Example** (Getting the current time in the current zone)
  *
@@ -2668,7 +2724,12 @@ export declare const withCurrentZoneNamed: {
  */
 export declare const nowInCurrentZone: Effect.Effect<Zoned, never, CurrentTimeZone>;
 /**
- * Modify a `DateTime` by applying a function to a cloned `Date` instance.
+ * Modifies a `DateTime` with a mutable local `Date` copy.
+ *
+ * **When to use**
+ *
+ * Use to adjust calendar fields in the `DateTime`'s own time zone with an
+ * existing `Date` mutation API.
  *
  * **Details**
  *
@@ -2697,7 +2758,12 @@ export declare const nowInCurrentZone: Effect.Effect<Zoned, never, CurrentTimeZo
  */
 export declare const mutate: {
     /**
-     * Modify a `DateTime` by applying a function to a cloned `Date` instance.
+     * Modifies a `DateTime` with a mutable local `Date` copy.
+     *
+     * **When to use**
+     *
+     * Use to adjust calendar fields in the `DateTime`'s own time zone with an
+     * existing `Date` mutation API.
      *
      * **Details**
      *
@@ -2728,7 +2794,12 @@ export declare const mutate: {
         readonly disambiguation?: Disambiguation | undefined;
     }): <A extends DateTime>(self: A) => A;
     /**
-     * Modify a `DateTime` by applying a function to a cloned `Date` instance.
+     * Modifies a `DateTime` with a mutable local `Date` copy.
+     *
+     * **When to use**
+     *
+     * Use to adjust calendar fields in the `DateTime`'s own time zone with an
+     * existing `Date` mutation API.
      *
      * **Details**
      *
@@ -2760,7 +2831,12 @@ export declare const mutate: {
     }): A;
 };
 /**
- * Modify a `DateTime` by applying a function to a cloned UTC `Date` instance.
+ * Modifies a `DateTime` with a mutable UTC `Date` copy.
+ *
+ * **When to use**
+ *
+ * Use to adjust the instant with an existing `Date` mutation API that works on
+ * UTC calendar fields.
  *
  * **Example** (Mutating DateTime values with UTC Dates)
  *
@@ -2783,7 +2859,12 @@ export declare const mutate: {
  */
 export declare const mutateUtc: {
     /**
-     * Modify a `DateTime` by applying a function to a cloned UTC `Date` instance.
+     * Modifies a `DateTime` with a mutable UTC `Date` copy.
+     *
+     * **When to use**
+     *
+     * Use to adjust the instant with an existing `Date` mutation API that works on
+     * UTC calendar fields.
      *
      * **Example** (Mutating DateTime values with UTC Dates)
      *
@@ -2806,7 +2887,12 @@ export declare const mutateUtc: {
      */
     (f: (date: Date) => void): <A extends DateTime>(self: A) => A;
     /**
-     * Modify a `DateTime` by applying a function to a cloned UTC `Date` instance.
+     * Modifies a `DateTime` with a mutable UTC `Date` copy.
+     *
+     * **When to use**
+     *
+     * Use to adjust the instant with an existing `Date` mutation API that works on
+     * UTC calendar fields.
      *
      * **Example** (Mutating DateTime values with UTC Dates)
      *
@@ -2830,7 +2916,7 @@ export declare const mutateUtc: {
     <A extends DateTime>(self: A, f: (date: Date) => void): A;
 };
 /**
- * Transform a `DateTime` by applying a function to the number of milliseconds
+ * Transforms a `DateTime` by applying a function to the number of milliseconds
  * since the Unix epoch.
  *
  * **Example** (Mapping epoch milliseconds)
@@ -2849,7 +2935,7 @@ export declare const mutateUtc: {
  */
 export declare const mapEpochMillis: {
     /**
-     * Transform a `DateTime` by applying a function to the number of milliseconds
+     * Transforms a `DateTime` by applying a function to the number of milliseconds
      * since the Unix epoch.
      *
      * **Example** (Mapping epoch milliseconds)
@@ -2868,7 +2954,7 @@ export declare const mapEpochMillis: {
      */
     (f: (millis: number) => number): <A extends DateTime>(self: A) => A;
     /**
-     * Transform a `DateTime` by applying a function to the number of milliseconds
+     * Transforms a `DateTime` by applying a function to the number of milliseconds
      * since the Unix epoch.
      *
      * **Example** (Mapping epoch milliseconds)
@@ -3137,7 +3223,23 @@ export declare const match: {
     }): A | B;
 };
 /**
- * Add the given `Duration` to a `DateTime`.
+ * Adds the given `Duration` to a `DateTime`.
+ *
+ * **When to use**
+ *
+ * Use to move a `DateTime` by an elapsed duration such as minutes, seconds, or
+ * milliseconds.
+ *
+ * **Details**
+ *
+ * The duration is converted to milliseconds and added to the epoch
+ * milliseconds. Zoned values keep their original time zone.
+ *
+ * **Gotchas**
+ *
+ * This is elapsed-time arithmetic, not calendar-aware local date arithmetic.
+ * Use `add` when adding days, weeks, months, or years should account for the
+ * date/time zone rules.
  *
  * **Example** (Adding durations)
  *
@@ -3150,12 +3252,31 @@ export declare const match: {
  * )
  * ```
  *
+ * @see {@link add} for calendar-aware date/time part arithmetic
+ * @see {@link subtractDuration} for subtracting an elapsed duration
+ *
  * @category math
  * @since 3.6.0
  */
 export declare const addDuration: {
     /**
-     * Add the given `Duration` to a `DateTime`.
+     * Adds the given `Duration` to a `DateTime`.
+     *
+     * **When to use**
+     *
+     * Use to move a `DateTime` by an elapsed duration such as minutes, seconds, or
+     * milliseconds.
+     *
+     * **Details**
+     *
+     * The duration is converted to milliseconds and added to the epoch
+     * milliseconds. Zoned values keep their original time zone.
+     *
+     * **Gotchas**
+     *
+     * This is elapsed-time arithmetic, not calendar-aware local date arithmetic.
+     * Use `add` when adding days, weeks, months, or years should account for the
+     * date/time zone rules.
      *
      * **Example** (Adding durations)
      *
@@ -3168,12 +3289,31 @@ export declare const addDuration: {
      * )
      * ```
      *
+     * @see {@link add} for calendar-aware date/time part arithmetic
+     * @see {@link subtractDuration} for subtracting an elapsed duration
+     *
      * @category math
      * @since 3.6.0
      */
     (duration: Duration.Input): <A extends DateTime>(self: A) => A;
     /**
-     * Add the given `Duration` to a `DateTime`.
+     * Adds the given `Duration` to a `DateTime`.
+     *
+     * **When to use**
+     *
+     * Use to move a `DateTime` by an elapsed duration such as minutes, seconds, or
+     * milliseconds.
+     *
+     * **Details**
+     *
+     * The duration is converted to milliseconds and added to the epoch
+     * milliseconds. Zoned values keep their original time zone.
+     *
+     * **Gotchas**
+     *
+     * This is elapsed-time arithmetic, not calendar-aware local date arithmetic.
+     * Use `add` when adding days, weeks, months, or years should account for the
+     * date/time zone rules.
      *
      * **Example** (Adding durations)
      *
@@ -3186,13 +3326,16 @@ export declare const addDuration: {
      * )
      * ```
      *
+     * @see {@link add} for calendar-aware date/time part arithmetic
+     * @see {@link subtractDuration} for subtracting an elapsed duration
+     *
      * @category math
      * @since 3.6.0
      */
     <A extends DateTime>(self: A, duration: Duration.Input): A;
 };
 /**
- * Subtract the given `Duration` from a `DateTime`.
+ * Subtracts the given `Duration` from a `DateTime`.
  *
  * **Example** (Subtracting durations)
  *
@@ -3210,7 +3353,7 @@ export declare const addDuration: {
  */
 export declare const subtractDuration: {
     /**
-     * Subtract the given `Duration` from a `DateTime`.
+     * Subtracts the given `Duration` from a `DateTime`.
      *
      * **Example** (Subtracting durations)
      *
@@ -3228,7 +3371,7 @@ export declare const subtractDuration: {
      */
     (duration: Duration.Input): <A extends DateTime>(self: A) => A;
     /**
-     * Subtract the given `Duration` from a `DateTime`.
+     * Subtracts the given `Duration` from a `DateTime`.
      *
      * **Example** (Subtracting durations)
      *
@@ -3247,7 +3390,7 @@ export declare const subtractDuration: {
     <A extends DateTime>(self: A, duration: Duration.Input): A;
 };
 /**
- * Add the given `amount` of `unit`'s to a `DateTime`.
+ * Adds the given `amount` of `unit` to a `DateTime`.
  *
  * **Details**
  *
@@ -3270,7 +3413,7 @@ export declare const subtractDuration: {
  */
 export declare const add: {
     /**
-     * Add the given `amount` of `unit`'s to a `DateTime`.
+     * Adds the given `amount` of `unit` to a `DateTime`.
      *
      * **Details**
      *
@@ -3293,7 +3436,7 @@ export declare const add: {
      */
     (parts: Partial<DateTime.PartsForMath>): <A extends DateTime>(self: A) => A;
     /**
-     * Add the given `amount` of `unit`'s to a `DateTime`.
+     * Adds the given `amount` of `unit` to a `DateTime`.
      *
      * **Details**
      *
@@ -3317,7 +3460,7 @@ export declare const add: {
     <A extends DateTime>(self: A, parts: Partial<DateTime.PartsForMath>): A;
 };
 /**
- * Subtract the given `amount` of `unit`'s from a `DateTime`.
+ * Subtracts the given `amount` of `unit` from a `DateTime`.
  *
  * **Example** (Subtracting date and time parts)
  *
@@ -3335,7 +3478,7 @@ export declare const add: {
  */
 export declare const subtract: {
     /**
-     * Subtract the given `amount` of `unit`'s from a `DateTime`.
+     * Subtracts the given `amount` of `unit` from a `DateTime`.
      *
      * **Example** (Subtracting date and time parts)
      *
@@ -3353,7 +3496,7 @@ export declare const subtract: {
      */
     (parts: Partial<DateTime.PartsForMath>): <A extends DateTime>(self: A) => A;
     /**
-     * Subtract the given `amount` of `unit`'s from a `DateTime`.
+     * Subtracts the given `amount` of `unit` from a `DateTime`.
      *
      * **Example** (Subtracting date and time parts)
      *
@@ -3710,7 +3853,8 @@ export declare const format: {
     } | undefined): string;
 };
 /**
- * Format a `DateTime` as a string using the `DateTimeFormat` API.
+ * Formats a `DateTime` with `Intl.DateTimeFormat` using the system local time
+ * zone and locale.
  *
  * **Details**
  *
@@ -3740,7 +3884,8 @@ export declare const format: {
  */
 export declare const formatLocal: {
     /**
-     * Format a `DateTime` as a string using the `DateTimeFormat` API.
+     * Formats a `DateTime` with `Intl.DateTimeFormat` using the system local time
+     * zone and locale.
      *
      * **Details**
      *
@@ -3772,7 +3917,8 @@ export declare const formatLocal: {
         readonly locale?: string | undefined;
     } | undefined): (self: DateTime) => string;
     /**
-     * Format a `DateTime` as a string using the `DateTimeFormat` API.
+     * Formats a `DateTime` with `Intl.DateTimeFormat` using the system local time
+     * zone and locale.
      *
      * **Details**
      *
@@ -3805,7 +3951,7 @@ export declare const formatLocal: {
     } | undefined): string;
 };
 /**
- * Format a `DateTime` as a string using the `DateTimeFormat` API.
+ * Formats a `DateTime` with `Intl.DateTimeFormat` using the UTC time zone.
  *
  * **Details**
  *
@@ -3838,7 +3984,7 @@ export declare const formatLocal: {
  */
 export declare const formatUtc: {
     /**
-     * Format a `DateTime` as a string using the `DateTimeFormat` API.
+     * Formats a `DateTime` with `Intl.DateTimeFormat` using the UTC time zone.
      *
      * **Details**
      *
@@ -3873,7 +4019,7 @@ export declare const formatUtc: {
         readonly locale?: string | undefined;
     } | undefined): (self: DateTime) => string;
     /**
-     * Format a `DateTime` as a string using the `DateTimeFormat` API.
+     * Formats a `DateTime` with `Intl.DateTimeFormat` using the UTC time zone.
      *
      * **Details**
      *
@@ -3909,7 +4055,17 @@ export declare const formatUtc: {
     } | undefined): string;
 };
 /**
- * Format a `DateTime` as a string using the `DateTimeFormat` API.
+ * Formats a `DateTime` as a string using the `Intl.DateTimeFormat` API.
+ *
+ * **When to use**
+ *
+ * Use when you already have an `Intl.DateTimeFormat` and want it to control the
+ * locale, time zone, and formatting options.
+ *
+ * **Details**
+ *
+ * The formatter receives the `DateTime` epoch milliseconds. Any time zone
+ * conversion comes from the supplied formatter.
  *
  * **Example** (Formatting DateTime values with custom formatters)
  *
@@ -3929,15 +4085,28 @@ export declare const formatUtc: {
  * })
  *
  * const formatted = DateTime.formatIntl(dt, formatter)
- * console.log(formatted) // "15. Juni 2024, 16:30"
+ * console.log(formatted.length > 0) // true
  * ```
  *
+ * @see {@link formatUtc} for formatting with options forced to UTC
+ * @see {@link formatIso} for stable ISO formatting
+ *
  * @category formatting
  * @since 3.6.0
  */
 export declare const formatIntl: {
     /**
-     * Format a `DateTime` as a string using the `DateTimeFormat` API.
+     * Formats a `DateTime` as a string using the `Intl.DateTimeFormat` API.
+     *
+     * **When to use**
+     *
+     * Use when you already have an `Intl.DateTimeFormat` and want it to control the
+     * locale, time zone, and formatting options.
+     *
+     * **Details**
+     *
+     * The formatter receives the `DateTime` epoch milliseconds. Any time zone
+     * conversion comes from the supplied formatter.
      *
      * **Example** (Formatting DateTime values with custom formatters)
      *
@@ -3957,15 +4126,28 @@ export declare const formatIntl: {
      * })
      *
      * const formatted = DateTime.formatIntl(dt, formatter)
-     * console.log(formatted) // "15. Juni 2024, 16:30"
+     * console.log(formatted.length > 0) // true
      * ```
      *
+     * @see {@link formatUtc} for formatting with options forced to UTC
+     * @see {@link formatIso} for stable ISO formatting
+     *
      * @category formatting
      * @since 3.6.0
      */
     (format: Intl.DateTimeFormat): (self: DateTime) => string;
     /**
-     * Format a `DateTime` as a string using the `DateTimeFormat` API.
+     * Formats a `DateTime` as a string using the `Intl.DateTimeFormat` API.
+     *
+     * **When to use**
+     *
+     * Use when you already have an `Intl.DateTimeFormat` and want it to control the
+     * locale, time zone, and formatting options.
+     *
+     * **Details**
+     *
+     * The formatter receives the `DateTime` epoch milliseconds. Any time zone
+     * conversion comes from the supplied formatter.
      *
      * **Example** (Formatting DateTime values with custom formatters)
      *
@@ -3985,16 +4167,19 @@ export declare const formatIntl: {
      * })
      *
      * const formatted = DateTime.formatIntl(dt, formatter)
-     * console.log(formatted) // "15. Juni 2024, 16:30"
+     * console.log(formatted.length > 0) // true
      * ```
      *
+     * @see {@link formatUtc} for formatting with options forced to UTC
+     * @see {@link formatIso} for stable ISO formatting
+     *
      * @category formatting
      * @since 3.6.0
      */
     (self: DateTime, format: Intl.DateTimeFormat): string;
 };
 /**
- * Format a `DateTime` as a UTC ISO string.
+ * Formats a `DateTime` as a UTC ISO string.
  *
  * **Details**
  *
@@ -4019,7 +4204,7 @@ export declare const formatIntl: {
  */
 export declare const formatIso: (self: DateTime) => string;
 /**
- * Format a `DateTime` as a time zone adjusted ISO date string.
+ * Formats a `DateTime` as a time zone adjusted ISO date string.
  *
  * **Details**
  *
@@ -4044,7 +4229,7 @@ export declare const formatIso: (self: DateTime) => string;
  */
 export declare const formatIsoDate: (self: DateTime) => string;
 /**
- * Format a `DateTime` as a UTC ISO date string.
+ * Formats a `DateTime` as a UTC ISO date string.
  *
  * **Details**
  *
@@ -4069,7 +4254,7 @@ export declare const formatIsoDate: (self: DateTime) => string;
  */
 export declare const formatIsoDateUtc: (self: DateTime) => string;
 /**
- * Format a `DateTime.Zoned` as an ISO string with an offset.
+ * Formats a `DateTime.Zoned` as an ISO string with an offset.
  *
  * **Details**
  *
@@ -4095,7 +4280,7 @@ export declare const formatIsoDateUtc: (self: DateTime) => string;
  */
 export declare const formatIsoOffset: (self: DateTime) => string;
 /**
- * Format a `DateTime.Zoned` as a string.
+ * Formats a `DateTime.Zoned` as a string.
  *
  * **Details**
  *