effect 3.10.18 → 3.11.0

package/dist/esm/DateTime.js

@@ -1,124 +1,18 @@
-/**
- * @since 3.6.0
- */
-import { IllegalArgumentException } from "./Cause.js";
-import * as Clock from "./Clock.js";
 import * as Context from "./Context.js";
-import * as Duration from "./Duration.js";
 import * as Effect from "./Effect.js";
-import * as Either from "./Either.js";
-import * as Equal from "./Equal.js";
-import * as Equivalence_ from "./Equivalence.js";
-import { dual, pipe } from "./Function.js";
-import { globalValue } from "./GlobalValue.js";
-import * as Hash from "./Hash.js";
-import * as Inspectable from "./Inspectable.js";
+import { dual } from "./Function.js";
+import * as Internal from "./internal/dateTime.js";
 import * as Layer from "./Layer.js";
-import * as Option from "./Option.js";
-import * as order from "./Order.js";
-import { pipeArguments } from "./Pipeable.js";
-import * as Predicate from "./Predicate.js";
 /**
  * @since 3.6.0
  * @category type ids
  */
-export const TypeId = /*#__PURE__*/Symbol.for("effect/DateTime");
+export const TypeId = Internal.TypeId;
 /**
  * @since 3.6.0
  * @category type ids
  */
-export const TimeZoneTypeId = /*#__PURE__*/Symbol.for("effect/DateTime/TimeZone");
-const Proto = {
-  [TypeId]: TypeId,
-  pipe() {
-    return pipeArguments(this, arguments);
-  },
-  [Inspectable.NodeInspectSymbol]() {
-    return this.toString();
-  },
-  toJSON() {
-    return toDateUtc(this).toJSON();
-  }
-};
-const ProtoUtc = {
-  ...Proto,
-  _tag: "Utc",
-  [Hash.symbol]() {
-    return Hash.cached(this, Hash.number(this.epochMillis));
-  },
-  [Equal.symbol](that) {
-    return isDateTime(that) && that._tag === "Utc" && this.epochMillis === that.epochMillis;
-  },
-  toString() {
-    return `DateTime.Utc(${toDateUtc(this).toJSON()})`;
-  }
-};
-const ProtoZoned = {
-  ...Proto,
-  _tag: "Zoned",
-  [Hash.symbol]() {
-    return pipe(Hash.number(this.epochMillis), Hash.combine(Hash.hash(this.zone)), Hash.cached(this));
-  },
-  [Equal.symbol](that) {
-    return isDateTime(that) && that._tag === "Zoned" && this.epochMillis === that.epochMillis && Equal.equals(this.zone, that.zone);
-  },
-  toString() {
-    return `DateTime.Zoned(${formatIsoZoned(this)})`;
-  }
-};
-const ProtoTimeZone = {
-  [TimeZoneTypeId]: TimeZoneTypeId,
-  [Inspectable.NodeInspectSymbol]() {
-    return this.toString();
-  }
-};
-const ProtoTimeZoneNamed = {
-  ...ProtoTimeZone,
-  _tag: "Named",
-  [Hash.symbol]() {
-    return Hash.cached(this, Hash.string(`Named:${this.id}`));
-  },
-  [Equal.symbol](that) {
-    return isTimeZone(that) && that._tag === "Named" && this.id === that.id;
-  },
-  toString() {
-    return `TimeZone.Named(${this.id})`;
-  },
-  toJSON() {
-    return {
-      _id: "TimeZone",
-      _tag: "Named",
-      id: this.id
-    };
-  }
-};
-const ProtoTimeZoneOffset = {
-  ...ProtoTimeZone,
-  _tag: "Offset",
-  [Hash.symbol]() {
-    return Hash.cached(this, Hash.string(`Offset:${this.offset}`));
-  },
-  [Equal.symbol](that) {
-    return isTimeZone(that) && that._tag === "Offset" && this.offset === that.offset;
-  },
-  toString() {
-    return `TimeZone.Offset(${offsetToString(this.offset)})`;
-  },
-  toJSON() {
-    return {
-      _id: "TimeZone",
-      _tag: "Offset",
-      offset: this.offset
-    };
-  }
-};
-const makeZonedProto = (epochMillis, zone, partsUtc) => {
-  const self = Object.create(ProtoZoned);
-  self.epochMillis = epochMillis;
-  self.zone = zone;
-  self.partsUtc = partsUtc;
-  return self;
-};
+export const TimeZoneTypeId = Internal.TimeZoneTypeId;
 // =============================================================================
 // guards
 // =============================================================================
@@ -126,33 +20,32 @@ const makeZonedProto = (epochMillis, zone, partsUtc) => {
  * @since 3.6.0
  * @category guards
  */
-export const isDateTime = u => Predicate.hasProperty(u, TypeId);
-const isDateTimeArgs = args => isDateTime(args[0]);
+export const isDateTime = Internal.isDateTime;
 /**
  * @since 3.6.0
  * @category guards
  */
-export const isTimeZone = u => Predicate.hasProperty(u, TimeZoneTypeId);
+export const isTimeZone = Internal.isTimeZone;
 /**
  * @since 3.6.0
  * @category guards
  */
-export const isTimeZoneOffset = u => isTimeZone(u) && u._tag === "Offset";
+export const isTimeZoneOffset = Internal.isTimeZoneOffset;
 /**
  * @since 3.6.0
  * @category guards
  */
-export const isTimeZoneNamed = u => isTimeZone(u) && u._tag === "Named";
+export const isTimeZoneNamed = Internal.isTimeZoneNamed;
 /**
  * @since 3.6.0
  * @category guards
  */
-export const isUtc = self => self._tag === "Utc";
+export const isUtc = Internal.isUtc;
 /**
  * @since 3.6.0
  * @category guards
  */
-export const isZoned = self => self._tag === "Zoned";
+export const isZoned = Internal.isZoned;
 // =============================================================================
 // instances
 // =============================================================================
@@ -160,24 +53,19 @@ export const isZoned = self => self._tag === "Zoned";
  * @since 3.6.0
  * @category instances
  */
-export const Equivalence = /*#__PURE__*/Equivalence_.make((a, b) => a.epochMillis === b.epochMillis);
+export const Equivalence = Internal.Equivalence;
 /**
  * @since 3.6.0
  * @category instances
  */
-export const Order = /*#__PURE__*/order.make((self, that) => self.epochMillis < that.epochMillis ? -1 : self.epochMillis > that.epochMillis ? 1 : 0);
+export const Order = Internal.Order;
 /**
  * @since 3.6.0
  */
-export const clamp = /*#__PURE__*/order.clamp(Order);
+export const clamp = Internal.clamp;
 // =============================================================================
 // constructors
 // =============================================================================
-const makeUtc = epochMillis => {
-  const self = Object.create(ProtoUtc);
-  self.epochMillis = epochMillis;
-  return self;
-};
 /**
  * Create a `DateTime` from a `Date`.
  *
@@ -186,13 +74,7 @@ const makeUtc = epochMillis => {
  * @since 3.6.0
  * @category constructors
  */
-export const unsafeFromDate = date => {
-  const epochMillis = date.getTime();
-  if (Number.isNaN(epochMillis)) {
-    throw new IllegalArgumentException("Invalid date");
-  }
-  return makeUtc(epochMillis);
-};
+export const unsafeFromDate = Internal.unsafeFromDate;
 /**
  * Create a `DateTime` from one of the following:
  *
@@ -205,6 +87,7 @@ export const unsafeFromDate = date => {
  * @since 3.6.0
  * @category constructors
  * @example
+ * ```ts
  * import { DateTime } from "effect"
  *
  * // from Date
@@ -215,19 +98,9 @@ export const unsafeFromDate = date => {
  *
  * // from string
  * DateTime.unsafeMake("2024-01-01")
+ * ```
  */
-export const unsafeMake = input => {
-  if (isDateTime(input)) {
-    return input;
-  } else if (input instanceof Date) {
-    return unsafeFromDate(input);
-  } else if (typeof input === "object") {
-    const date = new Date(0);
-    setPartsDate(date, input);
-    return unsafeFromDate(date);
-  }
-  return unsafeFromDate(new Date(input));
-};
+export const unsafeMake = Internal.unsafeMake;
 /**
  * Create a `DateTime.Zoned` using `DateTime.unsafeMake` and a time zone.
  *
@@ -238,35 +111,13 @@ export const unsafeMake = input => {
  * @since 3.6.0
  * @category constructors
  * @example
+ * ```ts
  * import { DateTime } from "effect"
  *
  * DateTime.unsafeMakeZoned(new Date(), { timeZone: "Europe/London" })
+ * ```
  */
-export const unsafeMakeZoned = (input, options) => {
-  if (options?.timeZone === undefined && isDateTime(input) && isZoned(input)) {
-    return input;
-  }
-  const self = unsafeMake(input);
-  let zone;
-  if (options?.timeZone === undefined) {
-    const offset = new Date(self.epochMillis).getTimezoneOffset() * -60 * 1000;
-    zone = zoneMakeOffset(offset);
-  } else if (isTimeZone(options?.timeZone)) {
-    zone = options.timeZone;
-  } else if (typeof options?.timeZone === "number") {
-    zone = zoneMakeOffset(options.timeZone);
-  } else {
-    const parsedZone = zoneFromString(options.timeZone);
-    if (Option.isNone(parsedZone)) {
-      throw new IllegalArgumentException(`Invalid time zone: ${options.timeZone}`);
-    }
-    zone = parsedZone.value;
-  }
-  if (options?.adjustForTimeZone !== true) {
-    return makeZonedProto(self.epochMillis, zone, self.partsUtc);
-  }
-  return makeZonedFromAdjusted(self.epochMillis, zone);
-};
+export const unsafeMakeZoned = Internal.unsafeMakeZoned;
 /**
  * Create a `DateTime.Zoned` using `DateTime.make` and a time zone.
  *
@@ -277,11 +128,13 @@ export const unsafeMakeZoned = (input, options) => {
  * @since 3.6.0
  * @category constructors
  * @example
+ * ```ts
  * import { DateTime } from "effect"
  *
  * DateTime.makeZoned(new Date(), { timeZone: "Europe/London" })
+ * ```
  */
-export const makeZoned = /*#__PURE__*/Option.liftThrowable(unsafeMakeZoned);
+export const makeZoned = Internal.makeZoned;
 /**
  * Create a `DateTime` from one of the following:
  *
@@ -296,6 +149,7 @@ export const makeZoned = /*#__PURE__*/Option.liftThrowable(unsafeMakeZoned);
  * @since 3.6.0
  * @category constructors
  * @example
+ * ```ts
  * import { DateTime } from "effect"
  *
  * // from Date
@@ -306,9 +160,9 @@ export const makeZoned = /*#__PURE__*/Option.liftThrowable(unsafeMakeZoned);
  *
  * // from string
  * DateTime.make("2024-01-01")
+ * ```
  */
-export const make = /*#__PURE__*/Option.liftThrowable(unsafeMake);
-const zonedStringRegex = /^(.{17,35})\[(.+)\]$/;
+export const make = Internal.make;
 /**
  * Create a `DateTime.Zoned` from a string.
  *
@@ -317,39 +171,29 @@ const zonedStringRegex = /^(.{17,35})\[(.+)\]$/;
  * @since 3.6.0
  * @category constructors
  */
-export const makeZonedFromString = input => {
-  const match = zonedStringRegex.exec(input);
-  if (match === null) {
-    const offset = parseOffset(input);
-    return offset !== null ? makeZoned(input, {
-      timeZone: offset
-    }) : Option.none();
-  }
-  const [, isoString, timeZone] = match;
-  return makeZoned(isoString, {
-    timeZone
-  });
-};
+export const makeZonedFromString = Internal.makeZonedFromString;
 /**
  * Get the current time using the `Clock` service and convert it to a `DateTime`.
  *
  * @since 3.6.0
  * @category constructors
  * @example
+ * ```ts
  * import { DateTime, Effect } from "effect"
  *
  * Effect.gen(function* () {
  *   const now = yield* DateTime.now
  * })
+ * ```
  */
-export const now = /*#__PURE__*/Effect.map(Clock.currentTimeMillis, makeUtc);
+export const now = Internal.now;
 /**
  * Get the current time using `Date.now`.
  *
  * @since 3.6.0
  * @category constructors
  */
-export const unsafeNow = () => makeUtc(Date.now());
+export const unsafeNow = Internal.unsafeNow;
 // =============================================================================
 // time zones
 // =============================================================================
@@ -359,6 +203,7 @@ export const unsafeNow = () => makeUtc(Date.now());
  * @since 3.6.0
  * @category time zones
  * @example
+ * ```ts
  * import { DateTime, Effect } from "effect"
  *
  * Effect.gen(function* () {
@@ -368,8 +213,9 @@ export const unsafeNow = () => makeUtc(Date.now());
  *   // set the time zone
  *   const zoned: DateTime.Zoned = DateTime.setZone(now, zone)
  * })
+ * ```
  */
-export const setZone = /*#__PURE__*/dual(isDateTimeArgs, (self, zone, options) => options?.adjustForTimeZone === true ? makeZonedFromAdjusted(self.epochMillis, zone) : makeZonedProto(self.epochMillis, zone, self.partsUtc));
+export const setZone = Internal.setZone;
 /**
  * Add a fixed offset time zone to a `DateTime`.
  *
@@ -378,6 +224,7 @@ export const setZone = /*#__PURE__*/dual(isDateTimeArgs, (self, zone, options) =
  * @since 3.6.0
  * @category time zones
  * @example
+ * ```ts
  * import { DateTime, Effect } from "effect"
  *
  * Effect.gen(function* () {
@@ -386,31 +233,9 @@ export const setZone = /*#__PURE__*/dual(isDateTimeArgs, (self, zone, options) =
  *   // set the offset time zone in milliseconds
  *   const zoned: DateTime.Zoned = DateTime.setZoneOffset(now, 3 * 60 * 60 * 1000)
  * })
+ * ```
  */
-export const setZoneOffset = /*#__PURE__*/dual(isDateTimeArgs, (self, offset, options) => setZone(self, zoneMakeOffset(offset), options));
-const validZoneCache = /*#__PURE__*/globalValue("effect/DateTime/validZoneCache", () => new Map());
-const formatOptions = {
-  day: "numeric",
-  month: "numeric",
-  year: "numeric",
-  hour: "numeric",
-  minute: "numeric",
-  second: "numeric",
-  timeZoneName: "longOffset",
-  fractionalSecondDigits: 3,
-  hourCycle: "h23"
-};
-const zoneMakeIntl = format => {
-  const zoneId = format.resolvedOptions().timeZone;
-  if (validZoneCache.has(zoneId)) {
-    return validZoneCache.get(zoneId);
-  }
-  const zone = Object.create(ProtoTimeZoneNamed);
-  zone.id = zoneId;
-  zone.format = format;
-  validZoneCache.set(zoneId, zone);
-  return zone;
-};
+export const setZoneOffset = Internal.setZoneOffset;
 /**
  * Attempt to create a named time zone from a IANA time zone identifier.
  *
@@ -419,30 +244,14 @@ const zoneMakeIntl = format => {
  * @since 3.6.0
  * @category time zones
  */
-export const zoneUnsafeMakeNamed = zoneId => {
-  if (validZoneCache.has(zoneId)) {
-    return validZoneCache.get(zoneId);
-  }
-  try {
-    return zoneMakeIntl(new Intl.DateTimeFormat("en-US", {
-      ...formatOptions,
-      timeZone: zoneId
-    }));
-  } catch (_) {
-    throw new IllegalArgumentException(`Invalid time zone: ${zoneId}`);
-  }
-};
+export const zoneUnsafeMakeNamed = Internal.zoneUnsafeMakeNamed;
 /**
  * Create a fixed offset time zone.
  *
  * @since 3.6.0
  * @category time zones
  */
-export const zoneMakeOffset = offset => {
-  const zone = Object.create(ProtoTimeZoneOffset);
-  zone.offset = offset;
-  return zone;
-};
+export const zoneMakeOffset = Internal.zoneMakeOffset;
 /**
  * Create a named time zone from a IANA time zone identifier. If the time zone
  * is invalid, `None` will be returned.
@@ -450,7 +259,7 @@ export const zoneMakeOffset = offset => {
  * @since 3.6.0
  * @category time zones
  */
-export const zoneMakeNamed = /*#__PURE__*/Option.liftThrowable(zoneUnsafeMakeNamed);
+export const zoneMakeNamed = Internal.zoneMakeNamed;
 /**
  * Create a named time zone from a IANA time zone identifier. If the time zone
  * is invalid, it will fail with an `IllegalArgumentException`.
@@ -458,37 +267,28 @@ export const zoneMakeNamed = /*#__PURE__*/Option.liftThrowable(zoneUnsafeMakeNam
  * @since 3.6.0
  * @category time zones
  */
-export const zoneMakeNamedEffect = zoneId => Effect.try({
-  try: () => zoneUnsafeMakeNamed(zoneId),
-  catch: e => e
-});
+export const zoneMakeNamedEffect = Internal.zoneMakeNamedEffect;
 /**
  * Create a named time zone from the system's local time zone.
  *
  * @since 3.6.0
  * @category time zones
  */
-export const zoneMakeLocal = () => zoneMakeIntl(new Intl.DateTimeFormat("en-US", formatOptions));
-const offsetZoneRegex = /^(?:GMT|[+-])/;
+export const zoneMakeLocal = Internal.zoneMakeLocal;
 /**
  * Try parse a TimeZone from a string
  *
  * @since 3.6.0
  * @category time zones
  */
-export const zoneFromString = zone => {
-  if (offsetZoneRegex.test(zone)) {
-    const offset = parseOffset(zone);
-    return offset === null ? Option.none() : Option.some(zoneMakeOffset(offset));
-  }
-  return zoneMakeNamed(zone);
-};
+export const zoneFromString = Internal.zoneFromString;
 /**
  * Format a `TimeZone` as a string.
  *
  * @since 3.6.0
  * @category time zones
  * @example
+ * ```ts
  * import { DateTime, Effect } from "effect"
  *
  * // Outputs "+03:00"
@@ -496,13 +296,9 @@ export const zoneFromString = zone => {
  *
  * // Outputs "Europe/London"
  * DateTime.zoneToString(DateTime.zoneUnsafeMakeNamed("Europe/London"))
+ * ```
  */
-export const zoneToString = self => {
-  if (self._tag === "Offset") {
-    return offsetToString(self.offset);
-  }
-  return self.id;
-};
+export const zoneToString = Internal.zoneToString;
 /**
  * Set the time zone of a `DateTime` from an IANA time zone identifier. If the
  * time zone is invalid, `None` will be returned.
@@ -510,6 +306,7 @@ export const zoneToString = self => {
  * @since 3.6.0
  * @category time zones
  * @example
+ * ```ts
  * import { DateTime, Effect } from "effect"
  *
  * Effect.gen(function* () {
@@ -517,8 +314,9 @@ export const zoneToString = self => {
  *   // set the time zone, returns an Option
  *   DateTime.setZoneNamed(now, "Europe/London")
  * })
+ * ```
  */
-export const setZoneNamed = /*#__PURE__*/dual(isDateTimeArgs, (self, zoneId, options) => Option.map(zoneMakeNamed(zoneId), zone => setZone(self, zone, options)));
+export const setZoneNamed = Internal.setZoneNamed;
 /**
  * Set the time zone of a `DateTime` from an IANA time zone identifier. If the
  * time zone is invalid, an `IllegalArgumentException` will be thrown.
@@ -526,6 +324,7 @@ export const setZoneNamed = /*#__PURE__*/dual(isDateTimeArgs, (self, zoneId, opt
  * @since 3.6.0
  * @category time zones
  * @example
+ * ```ts
  * import { DateTime, Effect } from "effect"
  *
  * Effect.gen(function* () {
@@ -533,8 +332,9 @@ export const setZoneNamed = /*#__PURE__*/dual(isDateTimeArgs, (self, zoneId, opt
  *   // set the time zone
  *   DateTime.unsafeSetZoneNamed(now, "Europe/London")
  * })
+ * ```
  */
-export const unsafeSetZoneNamed = /*#__PURE__*/dual(isDateTimeArgs, (self, zoneId, options) => setZone(self, zoneUnsafeMakeNamed(zoneId), options));
+export const unsafeSetZoneNamed = Internal.unsafeSetZoneNamed;
 // =============================================================================
 // comparisons
 // =============================================================================
@@ -547,6 +347,7 @@ export const unsafeSetZoneNamed = /*#__PURE__*/dual(isDateTimeArgs, (self, zoneI
  * @since 3.6.0
  * @category comparisons
  * @example
+ * ```ts
  * import { DateTime, Effect } from "effect"
  *
  * Effect.gen(function* () {
@@ -556,8 +357,9 @@ export const unsafeSetZoneNamed = /*#__PURE__*/dual(isDateTimeArgs, (self, zoneI
  *   // returns 60000
  *   DateTime.distance(now, other)
  * })
+ * ```
  */
-export const distance = /*#__PURE__*/dual(2, (self, other) => toEpochMillis(other) - toEpochMillis(self));
+export const distance = Internal.distance;
 /**
  * Calulate the difference between two `DateTime` values.
  *
@@ -570,6 +372,7 @@ export const distance = /*#__PURE__*/dual(2, (self, other) => toEpochMillis(othe
  * @since 3.6.0
  * @category comparisons
  * @example
+ * ```ts
  * import { DateTime, Effect } from "effect"
  *
  * Effect.gen(function* () {
@@ -582,17 +385,16 @@ export const distance = /*#__PURE__*/dual(2, (self, other) => toEpochMillis(othe
  *   // returns Either.left(Duration.minutes(1))
  *   DateTime.distanceDurationEither(other, now)
  * })
+ * ```
  */
-export const distanceDurationEither = /*#__PURE__*/dual(2, (self, other) => {
-  const diffMillis = distance(self, other);
-  return diffMillis > 0 ? Either.right(Duration.millis(diffMillis)) : Either.left(Duration.millis(-diffMillis));
-});
+export const distanceDurationEither = Internal.distanceDurationEither;
 /**
  * Calulate the distance between two `DateTime` values.
  *
  * @since 3.6.0
  * @category comparisons
  * @example
+ * ```ts
  * import { DateTime, Effect } from "effect"
  *
  * Effect.gen(function* () {
@@ -602,63 +404,64 @@ export const distanceDurationEither = /*#__PURE__*/dual(2, (self, other) => {
  *   // returns Duration.minutes(1)
  *   DateTime.distanceDuration(now, other)
  * })
+ * ```
  */
-export const distanceDuration = /*#__PURE__*/dual(2, (self, other) => Duration.millis(Math.abs(distance(self, other))));
+export const distanceDuration = Internal.distanceDuration;
 /**
  * @since 3.6.0
  * @category comparisons
  */
-export const min = /*#__PURE__*/order.min(Order);
+export const min = Internal.min;
 /**
  * @since 3.6.0
  * @category comparisons
  */
-export const max = /*#__PURE__*/order.max(Order);
+export const max = Internal.max;
 /**
  * @since 3.6.0
  * @category comparisons
  */
-export const greaterThan = /*#__PURE__*/order.greaterThan(Order);
+export const greaterThan = Internal.greaterThan;
 /**
  * @since 3.6.0
  * @category comparisons
  */
-export const greaterThanOrEqualTo = /*#__PURE__*/order.greaterThanOrEqualTo(Order);
+export const greaterThanOrEqualTo = Internal.greaterThanOrEqualTo;
 /**
  * @since 3.6.0
  * @category comparisons
  */
-export const lessThan = /*#__PURE__*/order.lessThan(Order);
+export const lessThan = Internal.lessThan;
 /**
  * @since 3.6.0
  * @category comparisons
  */
-export const lessThanOrEqualTo = /*#__PURE__*/order.lessThanOrEqualTo(Order);
+export const lessThanOrEqualTo = Internal.lessThanOrEqualTo;
 /**
  * @since 3.6.0
  * @category comparisons
  */
-export const between = /*#__PURE__*/order.between(Order);
+export const between = Internal.between;
 /**
  * @since 3.6.0
  * @category comparisons
  */
-export const isFuture = self => Effect.map(now, lessThan(self));
+export const isFuture = Internal.isFuture;
 /**
  * @since 3.6.0
  * @category comparisons
  */
-export const unsafeIsFuture = self => lessThan(unsafeNow(), self);
+export const unsafeIsFuture = Internal.unsafeIsFuture;
 /**
  * @since 3.6.0
  * @category comparisons
  */
-export const isPast = self => Effect.map(now, greaterThan(self));
+export const isPast = Internal.isPast;
 /**
  * @since 3.6.0
  * @category comparisons
  */
-export const unsafeIsPast = self => greaterThan(unsafeNow(), self);
+export const unsafeIsPast = Internal.unsafeIsPast;
 // =============================================================================
 // conversions
 // =============================================================================
@@ -668,44 +471,21 @@ export const unsafeIsPast = self => greaterThan(unsafeNow(), self);
  * @since 3.6.0
  * @category conversions
  */
-export const toDateUtc = self => new Date(self.epochMillis);
+export const toDateUtc = Internal.toDateUtc;
 /**
  * Convert a `DateTime` to a `Date`, applying the time zone first.
  *
  * @since 3.6.0
  * @category conversions
  */
-export const toDate = self => {
-  if (self._tag === "Utc") {
-    return new Date(self.epochMillis);
-  } else if (self.zone._tag === "Offset") {
-    return new Date(self.epochMillis + self.zone.offset);
-  } else if (self.adjustedEpochMillis !== undefined) {
-    return new Date(self.adjustedEpochMillis);
-  }
-  const parts = self.zone.format.formatToParts(self.epochMillis).filter(_ => _.type !== "literal");
-  const date = new Date(0);
-  date.setUTCFullYear(Number(parts[2].value), Number(parts[0].value) - 1, Number(parts[1].value));
-  date.setUTCHours(Number(parts[3].value), Number(parts[4].value), Number(parts[5].value), Number(parts[6].value));
-  self.adjustedEpochMillis = date.getTime();
-  return date;
-};
+export const toDate = Internal.toDate;
 /**
  * Calculate the time zone offset of a `DateTime.Zoned` in milliseconds.
  *
  * @since 3.6.0
  * @category conversions
  */
-export const zonedOffset = self => {
-  const date = toDate(self);
-  return date.getTime() - toEpochMillis(self);
-};
-const offsetToString = offset => {
-  const abs = Math.abs(offset);
-  const hours = Math.floor(abs / (60 * 60 * 1000));
-  const minutes = Math.round(abs % (60 * 60 * 1000) / (60 * 1000));
-  return `${offset < 0 ? "-" : "+"}${String(hours).padStart(2, "0")}:${String(minutes).padStart(2, "0")}`;
-};
+export const zonedOffset = Internal.zonedOffset;
 /**
  * Calculate the time zone offset of a `DateTime` in milliseconds.
  *
@@ -714,14 +494,14 @@ const offsetToString = offset => {
  * @since 3.6.0
  * @category conversions
  */
-export const zonedOffsetIso = self => offsetToString(zonedOffset(self));
+export const zonedOffsetIso = Internal.zonedOffsetIso;
 /**
  * Get the milliseconds since the Unix epoch of a `DateTime`.
  *
  * @since 3.6.0
  * @category conversions
  */
-export const toEpochMillis = self => self.epochMillis;
+export const toEpochMillis = Internal.toEpochMillis;
 /**
  * Remove the time aspect of a `DateTime`, first adjusting for the time
  * zone. It will return a `DateTime.Utc` only containing the date.
@@ -729,6 +509,7 @@ export const toEpochMillis = self => self.epochMillis;
  * @since 3.6.0
  * @category conversions
  * @example
+ * ```ts
  * import { DateTime } from "effect"
  *
  * // returns "2024-01-01T00:00:00Z"
@@ -739,24 +520,12 @@ export const toEpochMillis = self => self.epochMillis;
  *   DateTime.removeTime,
  *   DateTime.formatIso
  * )
+ * ```
  */
-export const removeTime = self => withDate(self, date => {
-  date.setUTCHours(0, 0, 0, 0);
-  return makeUtc(date.getTime());
-});
+export const removeTime = Internal.removeTime;
 // =============================================================================
 // parts
 // =============================================================================
-const dateToParts = date => ({
-  millis: date.getUTCMilliseconds(),
-  seconds: date.getUTCSeconds(),
-  minutes: date.getUTCMinutes(),
-  hours: date.getUTCHours(),
-  day: date.getUTCDate(),
-  weekDay: date.getUTCDay(),
-  month: date.getUTCMonth() + 1,
-  year: date.getUTCFullYear()
-});
 /**
  * Get the different parts of a `DateTime` as an object.
  *
@@ -765,15 +534,7 @@ const dateToParts = date => ({
  * @since 3.6.0
  * @category parts
  */
-export const toParts = self => {
-  if (self._tag === "Utc") {
-    return toPartsUtc(self);
-  } else if (self.partsAdjusted !== undefined) {
-    return self.partsAdjusted;
-  }
-  self.partsAdjusted = withDate(self, dateToParts);
-  return self.partsAdjusted;
-};
+export const toParts = Internal.toParts;
 /**
  * Get the different parts of a `DateTime` as an object.
  *
@@ -782,13 +543,7 @@ export const toParts = self => {
  * @since 3.6.0
  * @category parts
  */
-export const toPartsUtc = self => {
-  if (self.partsUtc !== undefined) {
-    return self.partsUtc;
-  }
-  self.partsUtc = withDateUtc(self, dateToParts);
-  return self.partsUtc;
-};
+export const toPartsUtc = Internal.toPartsUtc;
 /**
  * Get a part of a `DateTime` as a number.
  *
@@ -797,13 +552,15 @@ export const toPartsUtc = self => {
  * @since 3.6.0
  * @category parts
  * @example
+ * ```ts
  * import { DateTime } from "effect"
  *
  * const now = DateTime.unsafeMake({ year: 2024 })
  * const year = DateTime.getPartUtc(now, "year")
  * assert.strictEqual(year, 2024)
+ * ```
  */
-export const getPartUtc = /*#__PURE__*/dual(2, (self, part) => toPartsUtc(self)[part]);
+export const getPartUtc = Internal.getPartUtc;
 /**
  * Get a part of a `DateTime` as a number.
  *
@@ -812,40 +569,15 @@ export const getPartUtc = /*#__PURE__*/dual(2, (self, part) => toPartsUtc(self)[
  * @since 3.6.0
  * @category parts
  * @example
+ * ```ts
  * import { DateTime } from "effect"
  *
  * const now = DateTime.unsafeMakeZoned({ year: 2024 }, { timeZone: "Europe/London" })
  * const year = DateTime.getPart(now, "year")
  * assert.strictEqual(year, 2024)
+ * ```
  */
-export const getPart = /*#__PURE__*/dual(2, (self, part) => toParts(self)[part]);
-const setPartsDate = (date, parts) => {
-  if (parts.year !== undefined) {
-    date.setUTCFullYear(parts.year);
-  }
-  if (parts.month !== undefined) {
-    date.setUTCMonth(parts.month - 1);
-  }
-  if (parts.day !== undefined) {
-    date.setUTCDate(parts.day);
-  }
-  if (parts.weekDay !== undefined) {
-    const diff = parts.weekDay - date.getUTCDay();
-    date.setUTCDate(date.getUTCDate() + diff);
-  }
-  if (parts.hours !== undefined) {
-    date.setUTCHours(parts.hours);
-  }
-  if (parts.minutes !== undefined) {
-    date.setUTCMinutes(parts.minutes);
-  }
-  if (parts.seconds !== undefined) {
-    date.setUTCSeconds(parts.seconds);
-  }
-  if (parts.millis !== undefined) {
-    date.setUTCMilliseconds(parts.millis);
-  }
-};
+export const getPart = Internal.getPart;
 /**
  * Set the different parts of a `DateTime` as an object.
  *
@@ -854,21 +586,21 @@ const setPartsDate = (date, parts) => {
  * @since 3.6.0
  * @category parts
  */
-export const setParts = /*#__PURE__*/dual(2, (self, parts) => mutate(self, date => setPartsDate(date, parts)));
+export const setParts = Internal.setParts;
 /**
  * Set the different parts of a `DateTime` as an object.
  *
  * @since 3.6.0
  * @category parts
  */
-export const setPartsUtc = /*#__PURE__*/dual(2, (self, parts) => mutateUtc(self, date => setPartsDate(date, parts)));
+export const setPartsUtc = Internal.setPartsUtc;
 // =============================================================================
 // current time zone
 // =============================================================================
-/**
- * @since 3.6.0
- * @category current time zone
- */
+// =============================================================================
+// current time zone
+// =============================================================================
+/** @internal */
 export class CurrentTimeZone extends /*#__PURE__*/Context.Tag("effect/DateTime/CurrentTimeZone")() {}
 /**
  * Set the time zone of a `DateTime` to the current time zone, which is
@@ -877,6 +609,7 @@ export class CurrentTimeZone extends /*#__PURE__*/Context.Tag("effect/DateTime/C
  * @since 3.6.0
  * @category current time zone
  * @example
+ * ```ts
  * import { DateTime, Effect } from "effect"
  *
  * Effect.gen(function* () {
@@ -885,6 +618,7 @@ export class CurrentTimeZone extends /*#__PURE__*/Context.Tag("effect/DateTime/C
  *   // set the time zone to "Europe/London"
  *   const zoned = yield* DateTime.setZoneCurrent(now)
  * }).pipe(DateTime.withCurrentZoneNamed("Europe/London"))
+ * ```
  */
 export const setZoneCurrent = self => Effect.map(CurrentTimeZone, zone => setZone(self, zone));
 /**
@@ -893,6 +627,7 @@ export const setZoneCurrent = self => Effect.map(CurrentTimeZone, zone => setZon
  * @since 3.6.0
  * @category current time zone
  * @example
+ * ```ts
  * import { DateTime, Effect } from "effect"
  *
  * const zone = DateTime.zoneUnsafeMakeNamed("Europe/London")
@@ -900,6 +635,7 @@ export const setZoneCurrent = self => Effect.map(CurrentTimeZone, zone => setZon
  * Effect.gen(function* () {
  *   const now = yield* DateTime.nowInCurrentZone
  * }).pipe(DateTime.withCurrentZone(zone))
+ * ```
  */
 export const withCurrentZone = /*#__PURE__*/dual(2, (effect, zone) => Effect.provideService(effect, CurrentTimeZone, zone));
 /**
@@ -909,12 +645,14 @@ export const withCurrentZone = /*#__PURE__*/dual(2, (effect, zone) => Effect.pro
  * @since 3.6.0
  * @category current time zone
  * @example
+ * ```ts
  * import { DateTime, Effect } from "effect"
  *
  * Effect.gen(function* () {
  *   // will use the system's local time zone
  *   const now = yield* DateTime.nowInCurrentZone
  * }).pipe(DateTime.withCurrentZoneLocal)
+ * ```
  */
 export const withCurrentZoneLocal = effect => Effect.provideServiceEffect(effect, CurrentTimeZone, Effect.sync(zoneMakeLocal));
 /**
@@ -923,12 +661,14 @@ export const withCurrentZoneLocal = effect => Effect.provideServiceEffect(effect
  * @since 3.6.0
  * @category current time zone
  * @example
+ * ```ts
  * import { DateTime, Effect } from "effect"
  *
  * Effect.gen(function* () {
  *   // will use the system's local time zone
  *   const now = yield* DateTime.nowInCurrentZone
  * }).pipe(DateTime.withCurrentZoneOffset(3 * 60 * 60 * 1000))
+ * ```
  */
 export const withCurrentZoneOffset = /*#__PURE__*/dual(2, (effect, offset) => Effect.provideService(effect, CurrentTimeZone, zoneMakeOffset(offset)));
 /**
@@ -940,12 +680,14 @@ export const withCurrentZoneOffset = /*#__PURE__*/dual(2, (effect, offset) => Ef
  * @since 3.6.0
  * @category current time zone
  * @example
+ * ```ts
  * import { DateTime, Effect } from "effect"
  *
  * Effect.gen(function* () {
  *   // will use the "Europe/London" time zone
  *   const now = yield* DateTime.nowInCurrentZone
  * }).pipe(DateTime.withCurrentZoneNamed("Europe/London"))
+ * ```
  */
 export const withCurrentZoneNamed = /*#__PURE__*/dual(2, (effect, zone) => Effect.provideServiceEffect(effect, CurrentTimeZone, zoneMakeNamedEffect(zone)));
 /**
@@ -954,70 +696,19 @@ export const withCurrentZoneNamed = /*#__PURE__*/dual(2, (effect, zone) => Effec
  * @since 3.6.0
  * @category current time zone
  * @example
+ * ```ts
  * import { DateTime, Effect } from "effect"
  *
  * Effect.gen(function* () {
  *   // will use the "Europe/London" time zone
  *   const now = yield* DateTime.nowInCurrentZone
  * }).pipe(DateTime.withCurrentZoneNamed("Europe/London"))
+ * ```
  */
 export const nowInCurrentZone = /*#__PURE__*/Effect.flatMap(now, setZoneCurrent);
-/**
- * Create a Layer from the given time zone.
- *
- * @since 3.6.0
- * @category current time zone
- */
-export const layerCurrentZone = zone => Layer.succeed(CurrentTimeZone, zone);
-/**
- * Create a Layer from the given time zone offset.
- *
- * @since 3.6.0
- * @category current time zone
- */
-export const layerCurrentZoneOffset = offset => Layer.succeed(CurrentTimeZone, zoneMakeOffset(offset));
-/**
- * Create a Layer from the given IANA time zone identifier.
- *
- * @since 3.6.0
- * @category current time zone
- */
-export const layerCurrentZoneNamed = zoneId => Layer.effect(CurrentTimeZone, zoneMakeNamedEffect(zoneId));
-/**
- * Create a Layer from the systems local time zone.
- *
- * @since 3.6.0
- * @category current time zone
- */
-export const layerCurrentZoneLocal = /*#__PURE__*/Layer.sync(CurrentTimeZone, zoneMakeLocal);
 // =============================================================================
 // mapping
 // =============================================================================
-const makeZonedFromAdjusted = (adjustedMillis, zone) => {
-  const offset = zone._tag === "Offset" ? zone.offset : calculateNamedOffset(adjustedMillis, zone);
-  return makeZonedProto(adjustedMillis - offset, zone);
-};
-const offsetRegex = /([+-])(\d{2}):(\d{2})$/;
-const parseOffset = offset => {
-  const match = offsetRegex.exec(offset);
-  if (match === null) {
-    return null;
-  }
-  const [, sign, hours, minutes] = match;
-  return (sign === "+" ? 1 : -1) * (Number(hours) * 60 + Number(minutes)) * 60 * 1000;
-};
-const calculateNamedOffset = (adjustedMillis, zone) => {
-  const offset = zone.format.formatToParts(adjustedMillis).find(_ => _.type === "timeZoneName")?.value ?? "";
-  if (offset === "GMT") {
-    return 0;
-  }
-  const result = parseOffset(offset);
-  if (result === null) {
-    // fallback to using the adjusted date
-    return zonedOffset(makeZonedProto(adjustedMillis, zone));
-  }
-  return result;
-};
 /**
  * Modify a `DateTime` by applying a function to a cloned `Date` instance.
  *
@@ -1027,28 +718,14 @@ const calculateNamedOffset = (adjustedMillis, zone) => {
  * @since 3.6.0
  * @category mapping
  */
-export const mutate = /*#__PURE__*/dual(2, (self, f) => {
-  if (self._tag === "Utc") {
-    const date = toDateUtc(self);
-    f(date);
-    return makeUtc(date.getTime());
-  }
-  const adjustedDate = toDate(self);
-  const newAdjustedDate = new Date(adjustedDate.getTime());
-  f(newAdjustedDate);
-  return makeZonedFromAdjusted(newAdjustedDate.getTime(), self.zone);
-});
+export const mutate = Internal.mutate;
 /**
  * Modify a `DateTime` by applying a function to a cloned UTC `Date` instance.
  *
  * @since 3.6.0
  * @category mapping
  */
-export const mutateUtc = /*#__PURE__*/dual(2, (self, f) => mapEpochMillis(self, millis => {
-  const date = new Date(millis);
-  f(date);
-  return date.getTime();
-}));
+export const mutateUtc = Internal.mutateUtc;
 /**
  * Transform a `DateTime` by applying a function to the number of milliseconds
  * since the Unix epoch.
@@ -1056,17 +733,16 @@ export const mutateUtc = /*#__PURE__*/dual(2, (self, f) => mapEpochMillis(self,
  * @since 3.6.0
  * @category mapping
  * @example
+ * ```ts
  * import { DateTime } from "effect"
  *
  * // add 10 milliseconds
  * DateTime.unsafeMake(0).pipe(
  *   DateTime.mapEpochMillis((millis) => millis + 10)
  * )
+ * ```
  */
-export const mapEpochMillis = /*#__PURE__*/dual(2, (self, f) => {
-  const millis = f(toEpochMillis(self));
-  return self._tag === "Utc" ? makeUtc(millis) : makeZonedProto(millis, self.zone);
-});
+export const mapEpochMillis = Internal.mapEpochMillis;
 /**
  * Using the time zone adjusted `Date`, apply a function to the `Date` and
  * return the result.
@@ -1074,14 +750,16 @@ export const mapEpochMillis = /*#__PURE__*/dual(2, (self, f) => {
  * @since 3.6.0
  * @category mapping
  * @example
+ * ```ts
  * import { DateTime } from "effect"
  *
  * // get the time zone adjusted date in milliseconds
  * DateTime.unsafeMakeZoned(0, { timeZone: "Europe/London" }).pipe(
  *   DateTime.withDate((date) => date.getTime())
  * )
+ * ```
  */
-export const withDate = /*#__PURE__*/dual(2, (self, f) => f(toDate(self)));
+export const withDate = Internal.withDate;
 /**
  * Using the time zone adjusted `Date`, apply a function to the `Date` and
  * return the result.
@@ -1089,19 +767,21 @@ export const withDate = /*#__PURE__*/dual(2, (self, f) => f(toDate(self)));
  * @since 3.6.0
  * @category mapping
  * @example
+ * ```ts
  * import { DateTime } from "effect"
  *
  * // get the date in milliseconds
  * DateTime.unsafeMake(0).pipe(
  *   DateTime.withDateUtc((date) => date.getTime())
  * )
+ * ```
  */
-export const withDateUtc = /*#__PURE__*/dual(2, (self, f) => f(toDateUtc(self)));
+export const withDateUtc = Internal.withDateUtc;
 /**
  * @since 3.6.0
  * @category mapping
  */
-export const match = /*#__PURE__*/dual(2, (self, options) => self._tag === "Utc" ? options.onUtc(self) : options.onZoned(self));
+export const match = Internal.match;
 // =============================================================================
 // math
 // =============================================================================
@@ -1111,31 +791,32 @@ export const match = /*#__PURE__*/dual(2, (self, options) => self._tag === "Utc"
  * @since 3.6.0
  * @category math
  * @example
+ * ```ts
  * import { DateTime } from "effect"
  *
  * // add 5 minutes
  * DateTime.unsafeMake(0).pipe(
  *   DateTime.addDuration("5 minutes")
  * )
+ * ```
  */
-export const addDuration = /*#__PURE__*/dual(2, (self, duration) => mapEpochMillis(self, millis => millis + Duration.toMillis(duration)));
+export const addDuration = Internal.addDuration;
 /**
  * Subtract the given `Duration` from a `DateTime`.
  *
  * @since 3.6.0
  * @category math
  * @example
+ * ```ts
  * import { DateTime } from "effect"
  *
  * // subtract 5 minutes
  * DateTime.unsafeMake(0).pipe(
  *   DateTime.subtractDuration("5 minutes")
  * )
+ * ```
  */
-export const subtractDuration = /*#__PURE__*/dual(2, (self, duration) => mapEpochMillis(self, millis => millis - Duration.toMillis(duration)));
-const addMillis = (date, amount) => {
-  date.setTime(date.getTime() + amount);
-};
+export const subtractDuration = Internal.subtractDuration;
 /**
  * Add the given `amount` of `unit`'s to a `DateTime`.
  *
@@ -1145,113 +826,32 @@ const addMillis = (date, amount) => {
  * @since 3.6.0
  * @category math
  * @example
+ * ```ts
  * import { DateTime } from "effect"
  *
  * // add 5 minutes
  * DateTime.unsafeMake(0).pipe(
  *   DateTime.add({ minutes: 5 })
  * )
+ * ```
  */
-export const add = /*#__PURE__*/dual(2, (self, parts) => mutate(self, date => {
-  if (parts.millis) {
-    addMillis(date, parts.millis);
-  }
-  if (parts.seconds) {
-    addMillis(date, parts.seconds * 1000);
-  }
-  if (parts.minutes) {
-    addMillis(date, parts.minutes * 60 * 1000);
-  }
-  if (parts.hours) {
-    addMillis(date, parts.hours * 60 * 60 * 1000);
-  }
-  if (parts.days) {
-    date.setUTCDate(date.getUTCDate() + parts.days);
-  }
-  if (parts.weeks) {
-    date.setUTCDate(date.getUTCDate() + parts.weeks * 7);
-  }
-  if (parts.months) {
-    const day = date.getUTCDate();
-    date.setUTCMonth(date.getUTCMonth() + parts.months + 1, 0);
-    if (day < date.getUTCDate()) {
-      date.setUTCDate(day);
-    }
-  }
-  if (parts.years) {
-    const day = date.getUTCDate();
-    const month = date.getUTCMonth();
-    date.setUTCFullYear(date.getUTCFullYear() + parts.years, month + 1, 0);
-    if (day < date.getUTCDate()) {
-      date.setUTCDate(day);
-    }
-  }
-}));
+export const add = Internal.add;
 /**
  * Subtract the given `amount` of `unit`'s from a `DateTime`.
  *
  * @since 3.6.0
  * @category math
  * @example
+ * ```ts
  * import { DateTime } from "effect"
  *
  * // subtract 5 minutes
  * DateTime.unsafeMake(0).pipe(
  *   DateTime.subtract({ minutes: 5 })
  * )
+ * ```
  */
-export const subtract = /*#__PURE__*/dual(2, (self, parts) => {
-  const newParts = {};
-  for (const key in parts) {
-    newParts[key] = -1 * parts[key];
-  }
-  return add(self, newParts);
-});
-function startOfDate(date, part, options) {
-  switch (part) {
-    case "second":
-      {
-        date.setUTCMilliseconds(0);
-        break;
-      }
-    case "minute":
-      {
-        date.setUTCSeconds(0, 0);
-        break;
-      }
-    case "hour":
-      {
-        date.setUTCMinutes(0, 0, 0);
-        break;
-      }
-    case "day":
-      {
-        date.setUTCHours(0, 0, 0, 0);
-        break;
-      }
-    case "week":
-      {
-        const weekStartsOn = options?.weekStartsOn ?? 0;
-        const day = date.getUTCDay();
-        const diff = (day - weekStartsOn + 7) % 7;
-        date.setUTCDate(date.getUTCDate() - diff);
-        date.setUTCHours(0, 0, 0, 0);
-        break;
-      }
-    case "month":
-      {
-        date.setUTCDate(1);
-        date.setUTCHours(0, 0, 0, 0);
-        break;
-      }
-    case "year":
-      {
-        date.setUTCMonth(0, 1);
-        date.setUTCHours(0, 0, 0, 0);
-        break;
-      }
-  }
-}
+export const subtract = Internal.subtract;
 /**
  * Converts a `DateTime` to the start of the given `part`.
  *
@@ -1261,6 +861,7 @@ function startOfDate(date, part, options) {
  * @since 3.6.0
  * @category math
  * @example
+ * ```ts
  * import { DateTime } from "effect"
  *
  * // returns "2024-01-01T00:00:00Z"
@@ -1268,53 +869,9 @@ function startOfDate(date, part, options) {
  *   DateTime.startOf("day"),
  *   DateTime.formatIso
  * )
+ * ```
  */
-export const startOf = /*#__PURE__*/dual(isDateTimeArgs, (self, part, options) => mutate(self, date => startOfDate(date, part, options)));
-function endOfDate(date, part, options) {
-  switch (part) {
-    case "second":
-      {
-        date.setUTCMilliseconds(999);
-        break;
-      }
-    case "minute":
-      {
-        date.setUTCSeconds(59, 999);
-        break;
-      }
-    case "hour":
-      {
-        date.setUTCMinutes(59, 59, 999);
-        break;
-      }
-    case "day":
-      {
-        date.setUTCHours(23, 59, 59, 999);
-        break;
-      }
-    case "week":
-      {
-        const weekStartsOn = options?.weekStartsOn ?? 0;
-        const day = date.getUTCDay();
-        const diff = (day - weekStartsOn + 7) % 7;
-        date.setUTCDate(date.getUTCDate() - diff + 6);
-        date.setUTCHours(23, 59, 59, 999);
-        break;
-      }
-    case "month":
-      {
-        date.setUTCMonth(date.getUTCMonth() + 1, 0);
-        date.setUTCHours(23, 59, 59, 999);
-        break;
-      }
-    case "year":
-      {
-        date.setUTCMonth(11, 31);
-        date.setUTCHours(23, 59, 59, 999);
-        break;
-      }
-  }
-}
+export const startOf = Internal.startOf;
 /**
  * Converts a `DateTime` to the end of the given `part`.
  *
@@ -1324,6 +881,7 @@ function endOfDate(date, part, options) {
  * @since 3.6.0
  * @category math
  * @example
+ * ```ts
  * import { DateTime } from "effect"
  *
  * // returns "2024-01-01T23:59:59.999Z"
@@ -1331,8 +889,9 @@ function endOfDate(date, part, options) {
  *   DateTime.endOf("day"),
  *   DateTime.formatIso
  * )
+ * ```
  */
-export const endOf = /*#__PURE__*/dual(isDateTimeArgs, (self, part, options) => mutate(self, date => endOfDate(date, part, options)));
+export const endOf = Internal.endOf;
 /**
  * Converts a `DateTime` to the nearest given `part`.
  *
@@ -1342,6 +901,7 @@ export const endOf = /*#__PURE__*/dual(isDateTimeArgs, (self, part, options) =>
  * @since 3.6.0
  * @category math
  * @example
+ * ```ts
  * import { DateTime } from "effect"
  *
  * // returns "2024-01-02T00:00:00Z"
@@ -1349,33 +909,12 @@ export const endOf = /*#__PURE__*/dual(isDateTimeArgs, (self, part, options) =>
  *   DateTime.nearest("day"),
  *   DateTime.formatIso
  * )
+ * ```
  */
-export const nearest = /*#__PURE__*/dual(isDateTimeArgs, (self, part, options) => mutate(self, date => {
-  if (part === "milli") return;
-  const millis = date.getTime();
-  const start = new Date(millis);
-  startOfDate(start, part, options);
-  const startMillis = start.getTime();
-  const end = new Date(millis);
-  endOfDate(end, part, options);
-  const endMillis = end.getTime() + 1;
-  const diffStart = millis - startMillis;
-  const diffEnd = endMillis - millis;
-  if (diffStart < diffEnd) {
-    date.setTime(startMillis);
-  } else {
-    date.setTime(endMillis);
-  }
-}));
+export const nearest = Internal.nearest;
 // =============================================================================
 // formatting
 // =============================================================================
-const intlTimeZone = self => {
-  if (self._tag === "Named") {
-    return self.id;
-  }
-  return offsetToString(self.offset);
-};
 /**
  * Format a `DateTime` as a string using the `DateTimeFormat` API.
  *
@@ -1387,19 +926,7 @@ const intlTimeZone = self => {
  * @since 3.6.0
  * @category formatting
  */
-export const format = /*#__PURE__*/dual(isDateTimeArgs, (self, options) => {
-  try {
-    return new Intl.DateTimeFormat(options?.locale, {
-      timeZone: self._tag === "Utc" ? "UTC" : intlTimeZone(self.zone),
-      ...options
-    }).format(self.epochMillis);
-  } catch (_) {
-    return new Intl.DateTimeFormat(options?.locale, {
-      timeZone: "UTC",
-      ...options
-    }).format(toDate(self));
-  }
-});
+export const format = Internal.format;
 /**
  * Format a `DateTime` as a string using the `DateTimeFormat` API.
  *
@@ -1408,7 +935,7 @@ export const format = /*#__PURE__*/dual(isDateTimeArgs, (self, options) => {
  * @since 3.6.0
  * @category formatting
  */
-export const formatLocal = /*#__PURE__*/dual(isDateTimeArgs, (self, options) => new Intl.DateTimeFormat(options?.locale, options).format(self.epochMillis));
+export const formatLocal = Internal.formatLocal;
 /**
  * Format a `DateTime` as a string using the `DateTimeFormat` API.
  *
@@ -1417,48 +944,42 @@ export const formatLocal = /*#__PURE__*/dual(isDateTimeArgs, (self, options) =>
  * @since 3.6.0
  * @category formatting
  */
-export const formatUtc = /*#__PURE__*/dual(isDateTimeArgs, (self, options) => new Intl.DateTimeFormat(options?.locale, {
-  ...options,
-  timeZone: "UTC"
-}).format(self.epochMillis));
+export const formatUtc = Internal.formatUtc;
 /**
  * Format a `DateTime` as a string using the `DateTimeFormat` API.
  *
  * @since 3.6.0
  * @category formatting
  */
-export const formatIntl = /*#__PURE__*/dual(2, (self, format) => format.format(self.epochMillis));
+export const formatIntl = Internal.formatIntl;
 /**
  * Format a `DateTime` as a UTC ISO string.
  *
  * @since 3.6.0
  * @category formatting
  */
-export const formatIso = self => toDateUtc(self).toISOString();
+export const formatIso = Internal.formatIso;
 /**
  * Format a `DateTime` as a time zone adjusted ISO date string.
  *
  * @since 3.6.0
  * @category formatting
  */
-export const formatIsoDate = self => toDate(self).toISOString().slice(0, 10);
+export const formatIsoDate = Internal.formatIsoDate;
 /**
  * Format a `DateTime` as a UTC ISO date string.
  *
  * @since 3.6.0
  * @category formatting
  */
-export const formatIsoDateUtc = self => toDateUtc(self).toISOString().slice(0, 10);
+export const formatIsoDateUtc = Internal.formatIsoDateUtc;
 /**
  * Format a `DateTime.Zoned` as a ISO string with an offset.
  *
  * @since 3.6.0
  * @category formatting
  */
-export const formatIsoOffset = self => {
-  const date = toDate(self);
-  return self._tag === "Utc" ? date.toISOString() : `${date.toISOString().slice(0, -1)}${zonedOffsetIso(self)}`;
-};
+export const formatIsoOffset = Internal.formatIsoOffset;
 /**
  * Format a `DateTime.Zoned` as a string.
  *
@@ -1467,5 +988,33 @@ export const formatIsoOffset = self => {
  * @since 3.6.0
  * @category formatting
  */
-export const formatIsoZoned = self => self.zone._tag === "Offset" ? formatIsoOffset(self) : `${formatIsoOffset(self)}[${self.zone.id}]`;
+export const formatIsoZoned = Internal.formatIsoZoned;
+/**
+ * Create a Layer from the given time zone.
+ *
+ * @since 3.6.0
+ * @category current time zone
+ */
+export const layerCurrentZone = zone => Layer.succeed(CurrentTimeZone, zone);
+/**
+ * Create a Layer from the given time zone offset.
+ *
+ * @since 3.6.0
+ * @category current time zone
+ */
+export const layerCurrentZoneOffset = offset => Layer.succeed(CurrentTimeZone, Internal.zoneMakeOffset(offset));
+/**
+ * Create a Layer from the given IANA time zone identifier.
+ *
+ * @since 3.6.0
+ * @category current time zone
+ */
+export const layerCurrentZoneNamed = zoneId => Layer.effect(CurrentTimeZone, Internal.zoneMakeNamedEffect(zoneId));
+/**
+ * Create a Layer from the systems local time zone.
+ *
+ * @since 3.6.0
+ * @category current time zone
+ */
+export const layerCurrentZoneLocal = /*#__PURE__*/Layer.sync(CurrentTimeZone, zoneMakeLocal);
 //# sourceMappingURL=DateTime.js.map