effect 4.0.1 → 4.0.3

package/dist/DateTime.d.ts

@@ -8,6 +8,7 @@
  * helpers, comparisons, date arithmetic, current-time effects, and formatting
  * functions.
  *
+ * @stability stable
  * @since 3.6.0
  */
 import type { IllegalArgumentError } from "./Cause.ts";
@@ -27,6 +28,7 @@ declare const TimeZoneTypeId = "~effect/DateTime/TimeZone";
  * A `DateTime` represents a point in time. It can optionally have a time zone
  * associated with it.
  *
+ * @stability stable
  * @category models
  * @since 3.6.0
  */
@@ -39,6 +41,7 @@ export type DateTime = Utc | Zoned;
  *
  * Use `DateTime.isUtc` to narrow a `DateTime` to this variant.
  *
+ * @stability stable
  * @category models
  * @since 3.6.0
  */
@@ -56,6 +59,7 @@ export interface Utc extends DateTime.Proto {
  * `epochMilliseconds`, while the time zone is used for wall-clock parts,
  * formatting, and zone-aware transformations.
  *
+ * @stability stable
  * @category models
  * @since 3.6.0
  */
@@ -71,6 +75,7 @@ export interface Zoned extends DateTime.Proto {
  * Companion namespace containing the public helper types used by `DateTime`
  * constructors, parts APIs, formatting, and date/time arithmetic.
  *
+ * @stability stable
  * @since 3.6.0
  */
 export declare namespace DateTime {
@@ -237,6 +242,7 @@ export declare namespace DateTime {
  *
  * A `TimeZone` is either a fixed offset from UTC or a named IANA time zone.
  *
+ * @stability stable
  * @category models
  * @since 3.6.0
  */
@@ -245,6 +251,7 @@ export type TimeZone = TimeZone.Offset | TimeZone.Named;
  * Companion namespace containing the public variant and protocol types for
  * `TimeZone`.
  *
+ * @stability stable
  * @since 3.6.0
  */
 export declare namespace TimeZone {
@@ -357,6 +364,7 @@ export declare namespace TimeZone {
  * afterGap.pipe(Option.getOrThrow, DateTime.formatIso) // => "2025-03-09T07:30:00.000Z"
  * ```
  *
+ * @stability stable
  * @category models
  * @since 3.18.0
  */
@@ -371,6 +379,7 @@ export type Disambiguation = "compatible" | "earlier" | "later" | "reject";
  * @see {@link isUtc} for narrowing a known `DateTime` to UTC
  * @see {@link isZoned} for narrowing a known `DateTime` to zoned
  *
+ * @stability stable
  * @category guards
  * @since 3.6.0
  */
@@ -386,6 +395,7 @@ export declare const isDateTime: (u: unknown) => u is DateTime;
  * @see {@link isTimeZoneOffset} for narrowing to fixed-offset time zones
  * @see {@link isTimeZoneNamed} for narrowing to named time zones
  *
+ * @stability stable
  * @category guards
  * @since 3.6.0
  */
@@ -401,6 +411,7 @@ export declare const isTimeZone: (u: unknown) => u is TimeZone;
  * @see {@link isTimeZone} for checking either time zone variant
  * @see {@link isTimeZoneNamed} for narrowing to named time zones
  *
+ * @stability stable
  * @category guards
  * @since 3.6.0
  */
@@ -416,6 +427,7 @@ export declare const isTimeZoneOffset: (u: unknown) => u is TimeZone.Offset;
  * @see {@link isTimeZone} for checking either time zone variant
  * @see {@link isTimeZoneOffset} for narrowing to fixed-offset time zones
  *
+ * @stability stable
  * @category guards
  * @since 3.6.0
  */
@@ -431,6 +443,7 @@ export declare const isTimeZoneNamed: (u: unknown) => u is TimeZone.Named;
  * @see {@link isZoned} for narrowing to zoned date-times
  * @see {@link match} for handling both UTC and zoned cases
  *
+ * @stability stable
  * @category guards
  * @since 3.6.0
  */
@@ -446,6 +459,7 @@ export declare const isUtc: (self: DateTime) => self is Utc;
  * @see {@link isUtc} for narrowing to UTC date-times
  * @see {@link match} for handling both UTC and zoned cases
  *
+ * @stability stable
  * @category guards
  * @since 3.6.0
  */
@@ -471,6 +485,7 @@ export declare const isZoned: (self: DateTime) => self is Zoned;
  * DateTime.Equivalence(utc, zoned) // => true
  * ```
  *
+ * @stability stable
  * @category instances
  * @since 3.6.0
  */
@@ -497,6 +512,7 @@ export declare const Equivalence: Equ.Equivalence<DateTime>;
  * Array.sort(dates, DateTime.Order).map(DateTime.formatIsoDateUtc) // => ["2024-01-01", "2024-02-01", "2024-03-01"]
  * ```
  *
+ * @stability stable
  * @category instances
  * @since 3.6.0
  */
@@ -522,6 +538,7 @@ export declare const Order: order.Order<DateTime>;
  * DateTime.clamp(date, { minimum: min, maximum: max }) // => DateTime.makeUnsafe("2024-12-31")
  * ```
  *
+ * @stability stable
  * @category ordering
  * @since 3.6.0
  */
@@ -547,6 +564,7 @@ export declare const clamp: {
      * DateTime.clamp(date, { minimum: min, maximum: max }) // => DateTime.makeUnsafe("2024-12-31")
      * ```
      *
+     * @stability stable
      * @category ordering
      * @since 3.6.0
      */
@@ -575,6 +593,7 @@ export declare const clamp: {
      * DateTime.clamp(date, { minimum: min, maximum: max }) // => DateTime.makeUnsafe("2024-12-31")
      * ```
      *
+     * @stability stable
      * @category ordering
      * @since 3.6.0
      */
@@ -598,6 +617,7 @@ export declare const clamp: {
  * DateTime.fromDateUnsafe(new Date("2024-01-01T12:00:00Z")) // => DateTime.makeUnsafe("2024-01-01T12:00:00Z")
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -633,6 +653,7 @@ export declare const fromDateUnsafe: (date: Date) => Utc;
  * DateTime.makeUnsafe("2024-01-01") // => DateTime.makeUnsafe("2024-01-01T00:00:00Z")
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -648,6 +669,7 @@ export declare const makeUnsafe: <A extends DateTime.Input>(input: A) => DateTim
  * DateTime.fromEpochSeconds(1704067200).toJSON() // => "2024-01-01T00:00:00.000Z"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -685,6 +707,7 @@ export declare const fromEpochSeconds: (seconds: number) => Utc;
  * DateTime.formatIsoZoned(zoned) // => "2024-06-15T15:30:00.000+01:00[Europe/London]"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -726,6 +749,7 @@ export declare const makeZonedUnsafe: (input: DateTime.Input, options?: {
  * result.pipe(Option.map(DateTime.formatIsoZoned)) // => Option.some("2024-06-15T15:30:00.000+01:00[Europe/London]")
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 3.6.0
  */
@@ -766,6 +790,7 @@ export declare const makeZoned: (input: DateTime.Input, options?: {
  * DateTime.make("not a date") // => Option.none()
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 3.6.0
  */
@@ -793,6 +818,7 @@ export declare const make: <A extends DateTime.Input>(input: A) => Option.Option
  * DateTime.makeZonedFromString("invalid") // => Option.none()
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 3.6.0
  */
@@ -809,6 +835,7 @@ export declare const makeZonedFromString: (input: string) => Option.Option<Zoned
  * await Effect.runPromise(Effect.map(DateTime.now, DateTime.isDateTime)) // => true
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 3.6.0
  */
@@ -826,6 +853,7 @@ export declare const now: Effect.Effect<Utc>;
  * await Effect.runPromise(Effect.map(DateTime.nowAsDate, (now) => now instanceof Date)) // => true
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 3.14.0
  */
@@ -851,6 +879,7 @@ export declare const nowAsDate: Effect.Effect<Date>;
  * Number.isFinite(DateTime.toEpochMillis(DateTime.nowUnsafe())) // => true
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -881,6 +910,7 @@ export declare const nowUnsafe: LazyArg<Utc>;
  * utc // => DateTime.makeUnsafe("2024-01-01T00:00:00Z")
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 3.13.0
  */
@@ -899,6 +929,7 @@ export declare const toUtc: (self: DateTime) => Utc;
  * DateTime.isZoned(zoned) // => true
  * ```
  *
+ * @stability stable
  * @category transforming
  * @since 3.6.0
  */
@@ -917,6 +948,7 @@ export declare const setZone: {
      * DateTime.isZoned(zoned) // => true
      * ```
      *
+     * @stability stable
      * @category transforming
      * @since 3.6.0
      */
@@ -938,6 +970,7 @@ export declare const setZone: {
      * DateTime.isZoned(zoned) // => true
      * ```
      *
+     * @stability stable
      * @category transforming
      * @since 3.6.0
      */
@@ -964,6 +997,7 @@ export declare const setZone: {
  * DateTime.zoneToString(zoned.zone) // => "+03:00"
  * ```
  *
+ * @stability stable
  * @category transforming
  * @since 3.6.0
  */
@@ -986,6 +1020,7 @@ export declare const setZoneOffset: {
      * DateTime.zoneToString(zoned.zone) // => "+03:00"
      * ```
      *
+     * @stability stable
      * @category transforming
      * @since 3.6.0
      */
@@ -1011,6 +1046,7 @@ export declare const setZoneOffset: {
      * DateTime.zoneToString(zoned.zone) // => "+03:00"
      * ```
      *
+     * @stability stable
      * @category transforming
      * @since 3.6.0
      */
@@ -1043,6 +1079,7 @@ export declare const setZoneOffset: {
  * // DateTime.zoneMakeNamedUnsafe("Invalid/Zone")
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1069,6 +1106,7 @@ export declare const zoneMakeNamedUnsafe: (zoneId: string) => TimeZone.Named;
  * DateTime.formatIsoZoned(dt) // => "2024-01-01T15:00:00.000+03:00"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 3.6.0
  */
@@ -1089,6 +1127,7 @@ export declare const zoneMakeOffset: (offset: number) => TimeZone.Offset;
  * DateTime.zoneMakeNamed("Invalid/Zone") // => Option.none()
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 3.6.0
  */
@@ -1115,6 +1154,7 @@ export declare const zoneMakeNamed: (zoneId: string) => Option.Option<TimeZone.N
  * DateTime.zoneToString((await Effect.runPromise(program)).zone) // => "Europe/London"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 3.6.0
  */
@@ -1135,6 +1175,7 @@ export declare const zoneMakeNamedEffect: (zoneId: string) => Effect.Effect<Time
  * DateTime.isTimeZoneNamed(DateTime.zoneMakeLocal()) // => true
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 3.6.0
  */
@@ -1156,6 +1197,7 @@ export declare const zoneMakeLocal: () => TimeZone.Named;
  * DateTime.zoneFromString("invalid") // => Option.none()
  * ```
  *
+ * @stability stable
  * @category decoding
  * @since 3.6.0
  */
@@ -1172,6 +1214,7 @@ export declare const zoneFromString: (zone: string) => Option.Option<TimeZone>;
  * DateTime.zoneToString(DateTime.zoneMakeNamedUnsafe("Europe/London")) // => "Europe/London"
  * ```
  *
+ * @stability stable
  * @category encoding
  * @since 3.6.0
  */
@@ -1191,6 +1234,7 @@ export declare const zoneToString: (self: TimeZone) => string;
  * result // => Option.some("2024-01-01T00:00:00.000+00:00[Europe/London]")
  * ```
  *
+ * @stability stable
  * @category transforming
  * @since 3.6.0
  */
@@ -1210,6 +1254,7 @@ export declare const setZoneNamed: {
      * result // => Option.some("2024-01-01T00:00:00.000+00:00[Europe/London]")
      * ```
      *
+     * @stability stable
      * @category transforming
      * @since 3.6.0
      */
@@ -1232,6 +1277,7 @@ export declare const setZoneNamed: {
      * result // => Option.some("2024-01-01T00:00:00.000+00:00[Europe/London]")
      * ```
      *
+     * @stability stable
      * @category transforming
      * @since 3.6.0
      */
@@ -1255,6 +1301,7 @@ export declare const setZoneNamed: {
  * DateTime.zoneToString(zoned.zone) // => "Europe/London"
  * ```
  *
+ * @stability stable
  * @category transforming
  * @since 4.0.0
  */
@@ -1274,6 +1321,7 @@ export declare const setZoneNamedUnsafe: {
      * DateTime.zoneToString(zoned.zone) // => "Europe/London"
      * ```
      *
+     * @stability stable
      * @category transforming
      * @since 4.0.0
      */
@@ -1296,6 +1344,7 @@ export declare const setZoneNamedUnsafe: {
      * DateTime.zoneToString(zoned.zone) // => "Europe/London"
      * ```
      *
+     * @stability stable
      * @category transforming
      * @since 4.0.0
      */
@@ -1325,6 +1374,7 @@ export declare const setZoneNamedUnsafe: {
  * DateTime.distance(start, end) // => Duration.minutes(1)
  * ```
  *
+ * @stability stable
  * @category comparisons
  * @since 3.6.0
  */
@@ -1350,6 +1400,7 @@ export declare const distance: {
      * DateTime.distance(start, end) // => Duration.minutes(1)
      * ```
      *
+     * @stability stable
      * @category comparisons
      * @since 3.6.0
      */
@@ -1375,6 +1426,7 @@ export declare const distance: {
      * DateTime.distance(start, end) // => Duration.minutes(1)
      * ```
      *
+     * @stability stable
      * @category comparisons
      * @since 3.6.0
      */
@@ -1394,6 +1446,7 @@ export declare const distance: {
  * DateTime.min(date1, date2) // => DateTime.makeUnsafe("2024-01-01")
  * ```
  *
+ * @stability stable
  * @category comparisons
  * @since 3.6.0
  */
@@ -1412,6 +1465,7 @@ export declare const min: {
      * DateTime.min(date1, date2) // => DateTime.makeUnsafe("2024-01-01")
      * ```
      *
+     * @stability stable
      * @category comparisons
      * @since 3.6.0
      */
@@ -1430,6 +1484,7 @@ export declare const min: {
      * DateTime.min(date1, date2) // => DateTime.makeUnsafe("2024-01-01")
      * ```
      *
+     * @stability stable
      * @category comparisons
      * @since 3.6.0
      */
@@ -1449,6 +1504,7 @@ export declare const min: {
  * DateTime.max(date1, date2) // => DateTime.makeUnsafe("2024-02-01")
  * ```
  *
+ * @stability stable
  * @category comparisons
  * @since 3.6.0
  */
@@ -1467,6 +1523,7 @@ export declare const max: {
      * DateTime.max(date1, date2) // => DateTime.makeUnsafe("2024-02-01")
      * ```
      *
+     * @stability stable
      * @category comparisons
      * @since 3.6.0
      */
@@ -1485,6 +1542,7 @@ export declare const max: {
      * DateTime.max(date1, date2) // => DateTime.makeUnsafe("2024-02-01")
      * ```
      *
+     * @stability stable
      * @category comparisons
      * @since 3.6.0
      */
@@ -1505,6 +1563,7 @@ export declare const max: {
  * DateTime.isGreaterThan(date2, date1) // => false
  * ```
  *
+ * @stability stable
  * @category comparisons
  * @since 4.0.0
  */
@@ -1524,6 +1583,7 @@ export declare const isGreaterThan: {
      * DateTime.isGreaterThan(date2, date1) // => false
      * ```
      *
+     * @stability stable
      * @category comparisons
      * @since 4.0.0
      */
@@ -1543,6 +1603,7 @@ export declare const isGreaterThan: {
      * DateTime.isGreaterThan(date2, date1) // => false
      * ```
      *
+     * @stability stable
      * @category comparisons
      * @since 4.0.0
      */
@@ -1565,6 +1626,7 @@ export declare const isGreaterThan: {
  * DateTime.isGreaterThanOrEqualTo(date1, date3) // => false
  * ```
  *
+ * @stability stable
  * @category comparisons
  * @since 4.0.0
  */
@@ -1586,6 +1648,7 @@ export declare const isGreaterThanOrEqualTo: {
      * DateTime.isGreaterThanOrEqualTo(date1, date3) // => false
      * ```
      *
+     * @stability stable
      * @category comparisons
      * @since 4.0.0
      */
@@ -1607,6 +1670,7 @@ export declare const isGreaterThanOrEqualTo: {
      * DateTime.isGreaterThanOrEqualTo(date1, date3) // => false
      * ```
      *
+     * @stability stable
      * @category comparisons
      * @since 4.0.0
      */
@@ -1627,6 +1691,7 @@ export declare const isGreaterThanOrEqualTo: {
  * DateTime.isLessThan(date2, date1) // => false
  * ```
  *
+ * @stability stable
  * @category comparisons
  * @since 4.0.0
  */
@@ -1646,6 +1711,7 @@ export declare const isLessThan: {
      * DateTime.isLessThan(date2, date1) // => false
      * ```
      *
+     * @stability stable
      * @category comparisons
      * @since 4.0.0
      */
@@ -1665,6 +1731,7 @@ export declare const isLessThan: {
      * DateTime.isLessThan(date2, date1) // => false
      * ```
      *
+     * @stability stable
      * @category comparisons
      * @since 4.0.0
      */
@@ -1687,6 +1754,7 @@ export declare const isLessThan: {
  * DateTime.isLessThanOrEqualTo(date3, date1) // => false
  * ```
  *
+ * @stability stable
  * @category comparisons
  * @since 4.0.0
  */
@@ -1708,6 +1776,7 @@ export declare const isLessThanOrEqualTo: {
      * DateTime.isLessThanOrEqualTo(date3, date1) // => false
      * ```
      *
+     * @stability stable
      * @category comparisons
      * @since 4.0.0
      */
@@ -1729,6 +1798,7 @@ export declare const isLessThanOrEqualTo: {
      * DateTime.isLessThanOrEqualTo(date3, date1) // => false
      * ```
      *
+     * @stability stable
      * @category comparisons
      * @since 4.0.0
      */
@@ -1749,6 +1819,7 @@ export declare const isLessThanOrEqualTo: {
  * DateTime.between(date, { minimum: min, maximum: max }) // => true
  * ```
  *
+ * @stability stable
  * @category comparisons
  * @since 3.6.0
  */
@@ -1768,6 +1839,7 @@ export declare const between: {
      * DateTime.between(date, { minimum: min, maximum: max }) // => true
      * ```
      *
+     * @stability stable
      * @category comparisons
      * @since 3.6.0
      */
@@ -1790,6 +1862,7 @@ export declare const between: {
      * DateTime.between(date, { minimum: min, maximum: max }) // => true
      * ```
      *
+     * @stability stable
      * @category comparisons
      * @since 3.6.0
      */
@@ -1815,6 +1888,7 @@ export declare const between: {
  * await Effect.runPromise(Effect.provide(DateTime.isFuture(futureDate), TestClock.layer())) // => true
  * ```
  *
+ * @stability stable
  * @category comparisons
  * @since 3.6.0
  */
@@ -1840,6 +1914,7 @@ export declare const isFuture: (self: DateTime) => Effect.Effect<boolean>;
  * DateTime.isFutureUnsafe(oneHourFromNow)
  * ```
  *
+ * @stability stable
  * @category comparisons
  * @since 4.0.0
  */
@@ -1861,6 +1936,7 @@ export declare const isFutureUnsafe: (self: DateTime) => boolean;
  * await Effect.runPromise(Effect.provide(DateTime.isPast(pastDate), TestClock.layer())) // => true
  * ```
  *
+ * @stability stable
  * @category comparisons
  * @since 3.6.0
  */
@@ -1886,6 +1962,7 @@ export declare const isPast: (self: DateTime) => Effect.Effect<boolean>;
  * DateTime.isPastUnsafe(oneHourAgo)
  * ```
  *
+ * @stability stable
  * @category comparisons
  * @since 4.0.0
  */
@@ -1895,7 +1972,7 @@ export declare const isPastUnsafe: (self: DateTime) => boolean;
  *
  * **Details**
  *
- * This always returns the UTC representation, ignoring any time zone information.
+ * This preserves the original instant, regardless of any time zone information.
  *
  * **Example** (Converting DateTime values to UTC Dates)
  *
@@ -1909,6 +1986,7 @@ export declare const isPastUnsafe: (self: DateTime) => boolean;
  * DateTime.toDateUtc(dt).toISOString() // => "2024-01-01T12:00:00.000Z"
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 3.6.0
  */
@@ -1918,7 +1996,9 @@ export declare const toDateUtc: (self: DateTime) => Date;
  *
  * **Details**
  *
- * For `DateTime.Zoned`, this adjusts for the time zone before converting.
+ * For `DateTime.Zoned`, this stores the zoned wall-clock time in the returned
+ * `Date`'s UTC fields, rather than preserving the original instant. Use
+ * `toDateUtc` to preserve the instant.
  * For `DateTime.Utc`, this is equivalent to `toDateUtc`.
  *
  * **Example** (Converting DateTime values to Dates)
@@ -1926,15 +2006,17 @@ export declare const toDateUtc: (self: DateTime) => Date;
  * ```ts import.meta.vitest
  * import { DateTime } from "effect"
  *
- * const utc = DateTime.makeUnsafe("2024-01-01T12:00:00Z")
- * const zoned = DateTime.makeZonedUnsafe("2024-01-01T12:00:00Z", {
+ * const utc = DateTime.makeUnsafe("2024-07-01T12:00:00Z")
+ * const zoned = DateTime.makeZonedUnsafe("2024-07-01T12:00:00Z", {
  *   timeZone: "Europe/London"
  * })
  *
- * DateTime.toDate(utc).toISOString() // => "2024-01-01T12:00:00.000Z"
- * DateTime.toDate(zoned).toISOString() // => "2024-01-01T12:00:00.000Z"
+ * DateTime.toDate(utc).toISOString() // => "2024-07-01T12:00:00.000Z"
+ * DateTime.toDate(zoned).toISOString() // => "2024-07-01T13:00:00.000Z"
+ * DateTime.toDateUtc(zoned).toISOString() // => "2024-07-01T12:00:00.000Z"
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 3.6.0
  */
@@ -1959,6 +2041,7 @@ export declare const toDate: (self: DateTime) => Date;
  * DateTime.zonedOffset(zoned) // => 0
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 3.6.0
  */
@@ -1982,6 +2065,7 @@ export declare const zonedOffset: (self: Zoned) => number;
  * DateTime.zonedOffsetIso(zoned) // => "+03:00"
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 3.6.0
  */
@@ -2002,6 +2086,7 @@ export declare const zonedOffsetIso: (self: Zoned) => string;
  * DateTime.toEpochMillis(dt) // => 1704067200000
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 3.6.0
  */
@@ -2023,6 +2108,7 @@ export declare const toEpochMillis: (self: DateTime) => number;
  * DateTime.toEpochSeconds(dt) // => 1704067200
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 4.0.0
  */
@@ -2046,6 +2132,7 @@ export declare const toEpochSeconds: (self: DateTime) => number;
  * ) // => "2024-01-01T00:00:00.000Z"
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 3.6.0
  */
@@ -2068,6 +2155,7 @@ export declare const removeTime: (self: DateTime) => Utc;
  * const selectedParts = [parts.year, parts.month, parts.day, parts.hour] // => [2024, 1, 1, 12]
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 3.6.0
  */
@@ -2092,6 +2180,7 @@ export declare const toParts: (self: DateTime) => DateTime.PartsWithWeekday;
  * const selectedParts = [parts.year, parts.month, parts.day, parts.hour] // => [2024, 1, 1, 12]
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 3.6.0
  */
@@ -2112,6 +2201,7 @@ export declare const toPartsUtc: (self: DateTime) => DateTime.PartsWithWeekday;
  * DateTime.getPartUtc(dateTime, "year") // => 2024
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 3.6.0
  */
@@ -2132,6 +2222,7 @@ export declare const getPartUtc: {
      * DateTime.getPartUtc(dateTime, "year") // => 2024
      * ```
      *
+     * @stability stable
      * @category getters
      * @since 3.6.0
      */
@@ -2152,6 +2243,7 @@ export declare const getPartUtc: {
      * DateTime.getPartUtc(dateTime, "year") // => 2024
      * ```
      *
+     * @stability stable
      * @category getters
      * @since 3.6.0
      */
@@ -2175,6 +2267,7 @@ export declare const getPartUtc: {
  * DateTime.getPart(dateTime, "year") // => 2024
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 3.6.0
  */
@@ -2197,6 +2290,7 @@ export declare const getPart: {
      * DateTime.getPart(dateTime, "year") // => 2024
      * ```
      *
+     * @stability stable
      * @category getters
      * @since 3.6.0
      */
@@ -2219,6 +2313,7 @@ export declare const getPart: {
      * DateTime.getPart(dateTime, "year") // => 2024
      * ```
      *
+     * @stability stable
      * @category getters
      * @since 3.6.0
      */
@@ -2246,6 +2341,7 @@ export declare const getPart: {
  * updated // => DateTime.makeZonedUnsafe("2025-06-15T12:00:00Z", { timeZone: "UTC" })
  * ```
  *
+ * @stability stable
  * @category transforming
  * @since 3.6.0
  */
@@ -2272,6 +2368,7 @@ export declare const setParts: {
      * updated // => DateTime.makeZonedUnsafe("2025-06-15T12:00:00Z", { timeZone: "UTC" })
      * ```
      *
+     * @stability stable
      * @category transforming
      * @since 3.6.0
      */
@@ -2298,6 +2395,7 @@ export declare const setParts: {
      * updated // => DateTime.makeZonedUnsafe("2025-06-15T12:00:00Z", { timeZone: "UTC" })
      * ```
      *
+     * @stability stable
      * @category transforming
      * @since 3.6.0
      */
@@ -2324,6 +2422,7 @@ export declare const setParts: {
  * updated // => DateTime.makeUnsafe("2025-01-01T18:00:00Z")
  * ```
  *
+ * @stability stable
  * @category transforming
  * @since 3.6.0
  */
@@ -2349,6 +2448,7 @@ export declare const setPartsUtc: {
      * updated // => DateTime.makeUnsafe("2025-01-01T18:00:00Z")
      * ```
      *
+     * @stability stable
      * @category transforming
      * @since 3.6.0
      */
@@ -2374,6 +2474,7 @@ export declare const setPartsUtc: {
      * updated // => DateTime.makeUnsafe("2025-01-01T18:00:00Z")
      * ```
      *
+     * @stability stable
      * @category transforming
      * @since 3.6.0
      */
@@ -2404,6 +2505,7 @@ declare const CurrentTimeZone_base: Context.ServiceClass<CurrentTimeZone, "effec
  * await Effect.runPromise(Effect.provide(program, layer)) // => "Europe/London"
  * ```
  *
+ * @stability stable
  * @category services
  * @since 3.11.0
  */
@@ -2424,6 +2526,7 @@ export declare class CurrentTimeZone extends CurrentTimeZone_base {
  * }).pipe(DateTime.withCurrentZoneNamed("Europe/London"))) // => "Europe/London"
  * ```
  *
+ * @stability stable
  * @category accessors
  * @since 3.6.0
  */
@@ -2444,6 +2547,7 @@ export declare const setZoneCurrent: (self: DateTime) => Effect.Effect<Zoned, ne
  * }).pipe(DateTime.withCurrentZone(zone))) // => "Europe/London"
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 3.6.0
  */
@@ -2464,6 +2568,7 @@ export declare const withCurrentZone: {
      * }).pipe(DateTime.withCurrentZone(zone))) // => "Europe/London"
      * ```
      *
+     * @stability stable
      * @category providing services
      * @since 3.6.0
      */
@@ -2484,6 +2589,7 @@ export declare const withCurrentZone: {
      * }).pipe(DateTime.withCurrentZone(zone))) // => "Europe/London"
      * ```
      *
+     * @stability stable
      * @category providing services
      * @since 3.6.0
      */
@@ -2503,6 +2609,7 @@ export declare const withCurrentZone: {
  * }).pipe(DateTime.withCurrentZoneLocal)) // => true
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 3.6.0
  */
@@ -2522,6 +2629,7 @@ export declare const withCurrentZoneLocal: <A, E, R>(effect: Effect.Effect<A, E,
  * await Effect.runPromise(program) // => "+03:00"
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 3.6.0
  */
@@ -2541,6 +2649,7 @@ export declare const withCurrentZoneOffset: {
      * await Effect.runPromise(program) // => "+03:00"
      * ```
      *
+     * @stability stable
      * @category providing services
      * @since 3.6.0
      */
@@ -2560,6 +2669,7 @@ export declare const withCurrentZoneOffset: {
      * await Effect.runPromise(program) // => "+03:00"
      * ```
      *
+     * @stability stable
      * @category providing services
      * @since 3.6.0
      */
@@ -2584,6 +2694,7 @@ export declare const withCurrentZoneOffset: {
  * }).pipe(DateTime.withCurrentZoneNamed("Europe/London"))) // => "Europe/London"
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 3.6.0
  */
@@ -2607,6 +2718,7 @@ export declare const withCurrentZoneNamed: {
      * }).pipe(DateTime.withCurrentZoneNamed("Europe/London"))) // => "Europe/London"
      * ```
      *
+     * @stability stable
      * @category providing services
      * @since 3.6.0
      */
@@ -2630,6 +2742,7 @@ export declare const withCurrentZoneNamed: {
      * }).pipe(DateTime.withCurrentZoneNamed("Europe/London"))) // => "Europe/London"
      * ```
      *
+     * @stability stable
      * @category providing services
      * @since 3.6.0
      */
@@ -2648,6 +2761,7 @@ export declare const withCurrentZoneNamed: {
  * }).pipe(DateTime.withCurrentZoneNamed("Europe/London"))) // => "Europe/London"
  * ```
  *
+ * @stability stable
  * @category accessors
  * @since 3.6.0
  */
@@ -2680,6 +2794,7 @@ export declare const nowInCurrentZone: Effect.Effect<Zoned, never, CurrentTimeZo
  * })
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 3.6.0
  */
@@ -2712,6 +2827,7 @@ export declare const mutate: {
      * })
      * ```
      *
+     * @stability stable
      * @category mapping
      * @since 3.6.0
      */
@@ -2746,6 +2862,7 @@ export declare const mutate: {
      * })
      * ```
      *
+     * @stability stable
      * @category mapping
      * @since 3.6.0
      */
@@ -2777,6 +2894,7 @@ export declare const mutate: {
  * modified // => DateTime.makeZonedUnsafe("2024-01-01T18:00:00Z", { timeZone: "Europe/London" })
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 3.6.0
  */
@@ -2805,6 +2923,7 @@ export declare const mutateUtc: {
      * modified // => DateTime.makeZonedUnsafe("2024-01-01T18:00:00Z", { timeZone: "Europe/London" })
      * ```
      *
+     * @stability stable
      * @category mapping
      * @since 3.6.0
      */
@@ -2833,6 +2952,7 @@ export declare const mutateUtc: {
      * modified // => DateTime.makeZonedUnsafe("2024-01-01T18:00:00Z", { timeZone: "Europe/London" })
      * ```
      *
+     * @stability stable
      * @category mapping
      * @since 3.6.0
      */
@@ -2854,6 +2974,7 @@ export declare const mutateUtc: {
  * result // => DateTime.makeUnsafe(10)
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 3.6.0
  */
@@ -2874,6 +2995,7 @@ export declare const mapEpochMillis: {
      * result // => DateTime.makeUnsafe(10)
      * ```
      *
+     * @stability stable
      * @category mapping
      * @since 3.6.0
      */
@@ -2894,6 +3016,7 @@ export declare const mapEpochMillis: {
      * result // => DateTime.makeUnsafe(10)
      * ```
      *
+     * @stability stable
      * @category mapping
      * @since 3.6.0
      */
@@ -2920,6 +3043,7 @@ export declare const mapEpochMillis: {
  * ) // => 3600000
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 3.6.0
  */
@@ -2945,6 +3069,7 @@ export declare const withDate: {
      * ) // => 3600000
      * ```
      *
+     * @stability stable
      * @category mapping
      * @since 3.6.0
      */
@@ -2970,6 +3095,7 @@ export declare const withDate: {
      * ) // => 3600000
      * ```
      *
+     * @stability stable
      * @category mapping
      * @since 3.6.0
      */
@@ -2995,6 +3121,7 @@ export declare const withDate: {
  * ) // => 0
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 3.6.0
  */
@@ -3019,6 +3146,7 @@ export declare const withDateUtc: {
      * ) // => 0
      * ```
      *
+     * @stability stable
      * @category mapping
      * @since 3.6.0
      */
@@ -3043,6 +3171,7 @@ export declare const withDateUtc: {
      * ) // => 0
      * ```
      *
+     * @stability stable
      * @category mapping
      * @since 3.6.0
      */
@@ -3075,6 +3204,7 @@ export declare const withDateUtc: {
  * result2 // => "Zoned: 2024-06-15T15:30:00.000+01:00[Europe/London]"
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 3.6.0
  */
@@ -3106,6 +3236,7 @@ export declare const match: {
      * result2 // => "Zoned: 2024-06-15T15:30:00.000+01:00[Europe/London]"
      * ```
      *
+     * @stability stable
      * @category mapping
      * @since 3.6.0
      */
@@ -3140,6 +3271,7 @@ export declare const match: {
      * result2 // => "Zoned: 2024-06-15T15:30:00.000+01:00[Europe/London]"
      * ```
      *
+     * @stability stable
      * @category mapping
      * @since 3.6.0
      */
@@ -3181,6 +3313,7 @@ export declare const match: {
  * @see {@link add} for calendar-aware date/time part arithmetic
  * @see {@link subtractDuration} for subtracting an elapsed duration
  *
+ * @stability stable
  * @category math
  * @since 3.6.0
  */
@@ -3218,6 +3351,7 @@ export declare const addDuration: {
      * @see {@link add} for calendar-aware date/time part arithmetic
      * @see {@link subtractDuration} for subtracting an elapsed duration
      *
+     * @stability stable
      * @category math
      * @since 3.6.0
      */
@@ -3255,6 +3389,7 @@ export declare const addDuration: {
      * @see {@link add} for calendar-aware date/time part arithmetic
      * @see {@link subtractDuration} for subtracting an elapsed duration
      *
+     * @stability stable
      * @category math
      * @since 3.6.0
      */
@@ -3274,6 +3409,7 @@ export declare const addDuration: {
  * ) // => DateTime.makeUnsafe(-300000)
  * ```
  *
+ * @stability stable
  * @category math
  * @since 3.6.0
  */
@@ -3292,6 +3428,7 @@ export declare const subtractDuration: {
      * ) // => DateTime.makeUnsafe(-300000)
      * ```
      *
+     * @stability stable
      * @category math
      * @since 3.6.0
      */
@@ -3310,6 +3447,7 @@ export declare const subtractDuration: {
      * ) // => DateTime.makeUnsafe(-300000)
      * ```
      *
+     * @stability stable
      * @category math
      * @since 3.6.0
      */
@@ -3334,6 +3472,7 @@ export declare const subtractDuration: {
  * ) // => DateTime.makeUnsafe(300000)
  * ```
  *
+ * @stability stable
  * @category math
  * @since 3.6.0
  */
@@ -3357,6 +3496,7 @@ export declare const add: {
      * ) // => DateTime.makeUnsafe(300000)
      * ```
      *
+     * @stability stable
      * @category math
      * @since 3.6.0
      */
@@ -3380,6 +3520,7 @@ export declare const add: {
      * ) // => DateTime.makeUnsafe(300000)
      * ```
      *
+     * @stability stable
      * @category math
      * @since 3.6.0
      */
@@ -3399,6 +3540,7 @@ export declare const add: {
  * ) // => DateTime.makeUnsafe(-300000)
  * ```
  *
+ * @stability stable
  * @category math
  * @since 3.6.0
  */
@@ -3417,6 +3559,7 @@ export declare const subtract: {
      * ) // => DateTime.makeUnsafe(-300000)
      * ```
      *
+     * @stability stable
      * @category math
      * @since 3.6.0
      */
@@ -3435,6 +3578,7 @@ export declare const subtract: {
      * ) // => DateTime.makeUnsafe(-300000)
      * ```
      *
+     * @stability stable
      * @category math
      * @since 3.6.0
      */
@@ -3459,6 +3603,7 @@ export declare const subtract: {
  * ) // => DateTime.makeUnsafe("2024-01-01T00:00:00Z")
  * ```
  *
+ * @stability stable
  * @category math
  * @since 3.6.0
  */
@@ -3482,6 +3627,7 @@ export declare const startOf: {
      * ) // => DateTime.makeUnsafe("2024-01-01T00:00:00Z")
      * ```
      *
+     * @stability stable
      * @category math
      * @since 3.6.0
      */
@@ -3507,6 +3653,7 @@ export declare const startOf: {
      * ) // => DateTime.makeUnsafe("2024-01-01T00:00:00Z")
      * ```
      *
+     * @stability stable
      * @category math
      * @since 3.6.0
      */
@@ -3533,6 +3680,7 @@ export declare const startOf: {
  * ) // => DateTime.makeUnsafe("2024-01-01T23:59:59.999Z")
  * ```
  *
+ * @stability stable
  * @category math
  * @since 3.6.0
  */
@@ -3556,6 +3704,7 @@ export declare const endOf: {
      * ) // => DateTime.makeUnsafe("2024-01-01T23:59:59.999Z")
      * ```
      *
+     * @stability stable
      * @category math
      * @since 3.6.0
      */
@@ -3581,6 +3730,7 @@ export declare const endOf: {
      * ) // => DateTime.makeUnsafe("2024-01-01T23:59:59.999Z")
      * ```
      *
+     * @stability stable
      * @category math
      * @since 3.6.0
      */
@@ -3607,6 +3757,7 @@ export declare const endOf: {
  * ) // => DateTime.makeUnsafe("2024-01-02T00:00:00Z")
  * ```
  *
+ * @stability stable
  * @category math
  * @since 3.6.0
  */
@@ -3630,6 +3781,7 @@ export declare const nearest: {
      * ) // => DateTime.makeUnsafe("2024-01-02T00:00:00Z")
      * ```
      *
+     * @stability stable
      * @category math
      * @since 3.6.0
      */
@@ -3655,6 +3807,7 @@ export declare const nearest: {
      * ) // => DateTime.makeUnsafe("2024-01-02T00:00:00Z")
      * ```
      *
+     * @stability stable
      * @category math
      * @since 3.6.0
      */
@@ -3690,6 +3843,7 @@ export declare const nearest: {
  * }) // => "Saturday, June 15, 2024 at 3:30 PM"
  * ```
  *
+ * @stability stable
  * @category formatting
  * @since 3.6.0
  */
@@ -3722,6 +3876,7 @@ export declare const format: {
      * }) // => "Saturday, June 15, 2024 at 3:30 PM"
      * ```
      *
+     * @stability stable
      * @category formatting
      * @since 3.6.0
      */
@@ -3756,6 +3911,7 @@ export declare const format: {
      * }) // => "Saturday, June 15, 2024 at 3:30 PM"
      * ```
      *
+     * @stability stable
      * @category formatting
      * @since 3.6.0
      */
@@ -3784,6 +3940,7 @@ export declare const format: {
  * })
  * ```
  *
+ * @stability stable
  * @category formatting
  * @since 3.6.0
  */
@@ -3809,6 +3966,7 @@ export declare const formatLocal: {
      * })
      * ```
      *
+     * @stability stable
      * @category formatting
      * @since 3.6.0
      */
@@ -3836,6 +3994,7 @@ export declare const formatLocal: {
      * })
      * ```
      *
+     * @stability stable
      * @category formatting
      * @since 3.6.0
      */
@@ -3870,6 +4029,7 @@ export declare const formatLocal: {
  * })
  * ```
  *
+ * @stability stable
  * @category formatting
  * @since 3.6.0
  */
@@ -3901,6 +4061,7 @@ export declare const formatUtc: {
      * })
      * ```
      *
+     * @stability stable
      * @category formatting
      * @since 3.6.0
      */
@@ -3934,6 +4095,7 @@ export declare const formatUtc: {
      * })
      * ```
      *
+     * @stability stable
      * @category formatting
      * @since 3.6.0
      */
@@ -3977,6 +4139,7 @@ export declare const formatUtc: {
  * @see {@link formatUtc} for formatting with options forced to UTC
  * @see {@link formatIso} for stable ISO formatting
  *
+ * @stability stable
  * @category formatting
  * @since 3.6.0
  */
@@ -4017,6 +4180,7 @@ export declare const formatIntl: {
      * @see {@link formatUtc} for formatting with options forced to UTC
      * @see {@link formatIso} for stable ISO formatting
      *
+     * @stability stable
      * @category formatting
      * @since 3.6.0
      */
@@ -4057,6 +4221,7 @@ export declare const formatIntl: {
      * @see {@link formatUtc} for formatting with options forced to UTC
      * @see {@link formatIso} for stable ISO formatting
      *
+     * @stability stable
      * @category formatting
      * @since 3.6.0
      */
@@ -4082,6 +4247,7 @@ export declare const formatIntl: {
  * DateTime.formatIso(zoned) // => "2024-01-01T12:30:45.123Z"
  * ```
  *
+ * @stability stable
  * @category formatting
  * @since 3.6.0
  */
@@ -4107,6 +4273,7 @@ export declare const formatIso: (self: DateTime) => string;
  * DateTime.formatIsoDate(zoned) // => "2024-01-02"
  * ```
  *
+ * @stability stable
  * @category formatting
  * @since 3.6.0
  */
@@ -4132,6 +4299,7 @@ export declare const formatIsoDate: (self: DateTime) => string;
  * DateTime.formatIsoDateUtc(zoned) // => "2024-01-01"
  * ```
  *
+ * @stability stable
  * @category formatting
  * @since 3.6.0
  */
@@ -4158,6 +4326,7 @@ export declare const formatIsoDateUtc: (self: DateTime) => string;
  * DateTime.formatIsoOffset(zoned) // => "2024-01-01T15:00:00.000+03:00"
  * ```
  *
+ * @stability stable
  * @category formatting
  * @since 3.6.0
  */
@@ -4187,6 +4356,7 @@ export declare const formatIsoOffset: (self: DateTime) => string;
  * DateTime.formatIsoZoned(offsetZone) // => "2024-06-15T17:30:45.123+03:00"
  * ```
  *
+ * @stability stable
  * @category formatting
  * @since 3.6.0
  */
@@ -4215,6 +4385,7 @@ export declare const formatIsoZoned: (self: Zoned) => string;
  * await Effect.runPromise(Effect.provide(program, layer)) // => "Europe/London"
  * ```
  *
+ * @stability stable
  * @category layers
  * @since 3.6.0
  */
@@ -4242,6 +4413,7 @@ export declare const layerCurrentZone: (resource: NoInfer<TimeZone>) => Layer.La
  * await Effect.runPromise(Effect.provide(program, layer)) // => "+03:00"
  * ```
  *
+ * @stability stable
  * @category layers
  * @since 3.6.0
  */
@@ -4269,6 +4441,7 @@ export declare const layerCurrentZoneOffset: (offset: number) => Layer.Layer<Cur
  * await Effect.runPromise(Effect.provide(program, layer)) // => "Europe/London"
  * ```
  *
+ * @stability stable
  * @category layers
  * @since 3.6.0
  */
@@ -4295,6 +4468,7 @@ export declare const layerCurrentZoneNamed: (zoneId: string) => Layer.Layer<Curr
  * await Effect.runPromise(Effect.provide(program, DateTime.layerCurrentZoneLocal)) // => true
  * ```
  *
+ * @stability stable
  * @category layers
  * @since 3.6.0
  */