@depup/effect 3.20.0-depup.0

package/src/Duration.ts

@@ -0,0 +1,1140 @@
+/**
+ * @since 2.0.0
+ */
+import * as Equal from "./Equal.js"
+import type * as equivalence from "./Equivalence.js"
+import { dual } from "./Function.js"
+import * as Hash from "./Hash.js"
+import type { Inspectable } from "./Inspectable.js"
+import { NodeInspectSymbol } from "./Inspectable.js"
+import * as Option from "./Option.js"
+import * as order from "./Order.js"
+import type { Pipeable } from "./Pipeable.js"
+import { pipeArguments } from "./Pipeable.js"
+import { hasProperty, isBigInt, isNumber, isString } from "./Predicate.js"
+
+const TypeId: unique symbol = Symbol.for("effect/Duration")
+
+const bigint0 = BigInt(0)
+const bigint24 = BigInt(24)
+const bigint60 = BigInt(60)
+const bigint1e3 = BigInt(1_000)
+const bigint1e6 = BigInt(1_000_000)
+const bigint1e9 = BigInt(1_000_000_000)
+
+/**
+ * @since 2.0.0
+ * @category symbol
+ */
+export type TypeId = typeof TypeId
+
+/**
+ * @since 2.0.0
+ * @category models
+ */
+export interface Duration extends Equal.Equal, Pipeable, Inspectable {
+  readonly [TypeId]: TypeId
+  readonly value: DurationValue
+}
+/**
+ * @since 2.0.0
+ * @category models
+ */
+export type DurationValue =
+  | {
+    readonly _tag: "Millis"
+    readonly millis: number
+  }
+  | {
+    readonly _tag: "Nanos"
+    readonly nanos: bigint
+  }
+  | {
+    readonly _tag: "Infinity"
+  }
+
+/**
+ * @since 2.0.0
+ * @category models
+ */
+export type Unit =
+  | "nano"
+  | "nanos"
+  | "micro"
+  | "micros"
+  | "milli"
+  | "millis"
+  | "second"
+  | "seconds"
+  | "minute"
+  | "minutes"
+  | "hour"
+  | "hours"
+  | "day"
+  | "days"
+  | "week"
+  | "weeks"
+
+/**
+ * @since 2.0.0
+ * @category models
+ */
+export type DurationInput =
+  | Duration
+  | number // millis
+  | bigint // nanos
+  | readonly [seconds: number, nanos: number]
+  | `${number} ${Unit}`
+
+const DURATION_REGEX = /^(-?\d+(?:\.\d+)?)\s+(nanos?|micros?|millis?|seconds?|minutes?|hours?|days?|weeks?)$/
+
+/**
+ * @since 2.0.0
+ */
+export const decode = (input: DurationInput): Duration => {
+  if (isDuration(input)) {
+    return input
+  } else if (isNumber(input)) {
+    return millis(input)
+  } else if (isBigInt(input)) {
+    return nanos(input)
+  } else if (Array.isArray(input) && input.length === 2 && input.every(isNumber)) {
+    if (input[0] === -Infinity || input[1] === -Infinity || Number.isNaN(input[0]) || Number.isNaN(input[1])) {
+      return zero
+    }
+
+    if (input[0] === Infinity || input[1] === Infinity) {
+      return infinity
+    }
+
+    return nanos(BigInt(Math.round(input[0] * 1_000_000_000)) + BigInt(Math.round(input[1])))
+  } else if (isString(input)) {
+    const match = DURATION_REGEX.exec(input)
+    if (match) {
+      const [_, valueStr, unit] = match
+      const value = Number(valueStr)
+      switch (unit) {
+        case "nano":
+        case "nanos":
+          return nanos(BigInt(valueStr))
+        case "micro":
+        case "micros":
+          return micros(BigInt(valueStr))
+        case "milli":
+        case "millis":
+          return millis(value)
+        case "second":
+        case "seconds":
+          return seconds(value)
+        case "minute":
+        case "minutes":
+          return minutes(value)
+        case "hour":
+        case "hours":
+          return hours(value)
+        case "day":
+        case "days":
+          return days(value)
+        case "week":
+        case "weeks":
+          return weeks(value)
+      }
+    }
+  }
+  throw new Error("Invalid DurationInput")
+}
+
+/**
+ * @since 2.5.0
+ */
+export const decodeUnknown: (u: unknown) => Option.Option<Duration> = Option.liftThrowable(decode) as any
+
+const zeroValue: DurationValue = { _tag: "Millis", millis: 0 }
+const infinityValue: DurationValue = { _tag: "Infinity" }
+
+const DurationProto: Omit<Duration, "value"> = {
+  [TypeId]: TypeId,
+  [Hash.symbol](this: Duration) {
+    return Hash.cached(this, Hash.structure(this.value))
+  },
+  [Equal.symbol](this: Duration, that: unknown): boolean {
+    return isDuration(that) && equals(this, that)
+  },
+  toString(this: Duration) {
+    return `Duration(${format(this)})`
+  },
+  toJSON(this: Duration) {
+    switch (this.value._tag) {
+      case "Millis":
+        return { _id: "Duration", _tag: "Millis", millis: this.value.millis }
+      case "Nanos":
+        return { _id: "Duration", _tag: "Nanos", hrtime: toHrTime(this) }
+      case "Infinity":
+        return { _id: "Duration", _tag: "Infinity" }
+    }
+  },
+  [NodeInspectSymbol]() {
+    return this.toJSON()
+  },
+  pipe() {
+    return pipeArguments(this, arguments)
+  }
+} as const
+
+const make = (input: number | bigint): Duration => {
+  const duration = Object.create(DurationProto)
+  if (isNumber(input)) {
+    if (isNaN(input) || input <= 0) {
+      duration.value = zeroValue
+    } else if (!Number.isFinite(input)) {
+      duration.value = infinityValue
+    } else if (!Number.isInteger(input)) {
+      duration.value = { _tag: "Nanos", nanos: BigInt(Math.round(input * 1_000_000)) }
+    } else {
+      duration.value = { _tag: "Millis", millis: input }
+    }
+  } else if (input <= bigint0) {
+    duration.value = zeroValue
+  } else {
+    duration.value = { _tag: "Nanos", nanos: input }
+  }
+  return duration
+}
+
+/**
+ * @since 2.0.0
+ * @category guards
+ */
+export const isDuration = (u: unknown): u is Duration => hasProperty(u, TypeId)
+
+/**
+ * @since 2.0.0
+ * @category guards
+ */
+export const isFinite = (self: Duration): boolean => self.value._tag !== "Infinity"
+
+/**
+ * @since 3.5.0
+ * @category guards
+ */
+export const isZero = (self: Duration): boolean => {
+  switch (self.value._tag) {
+    case "Millis": {
+      return self.value.millis === 0
+    }
+    case "Nanos": {
+      return self.value.nanos === bigint0
+    }
+    case "Infinity": {
+      return false
+    }
+  }
+}
+
+/**
+ * @since 2.0.0
+ * @category constructors
+ */
+export const zero: Duration = make(0)
+
+/**
+ * @since 2.0.0
+ * @category constructors
+ */
+export const infinity: Duration = make(Infinity)
+
+/**
+ * @since 2.0.0
+ * @category constructors
+ */
+export const nanos = (nanos: bigint): Duration => make(nanos)
+
+/**
+ * @since 2.0.0
+ * @category constructors
+ */
+export const micros = (micros: bigint): Duration => make(micros * bigint1e3)
+
+/**
+ * @since 2.0.0
+ * @category constructors
+ */
+export const millis = (millis: number): Duration => make(millis)
+
+/**
+ * @since 2.0.0
+ * @category constructors
+ */
+export const seconds = (seconds: number): Duration => make(seconds * 1000)
+
+/**
+ * @since 2.0.0
+ * @category constructors
+ */
+export const minutes = (minutes: number): Duration => make(minutes * 60_000)
+
+/**
+ * @since 2.0.0
+ * @category constructors
+ */
+export const hours = (hours: number): Duration => make(hours * 3_600_000)
+
+/**
+ * @since 2.0.0
+ * @category constructors
+ */
+export const days = (days: number): Duration => make(days * 86_400_000)
+
+/**
+ * @since 2.0.0
+ * @category constructors
+ */
+export const weeks = (weeks: number): Duration => make(weeks * 604_800_000)
+
+/**
+ * @since 2.0.0
+ * @category getters
+ */
+export const toMillis = (self: DurationInput): number =>
+  match(self, {
+    onMillis: (millis) => millis,
+    onNanos: (nanos) => Number(nanos) / 1_000_000
+  })
+
+/**
+ * @since 2.0.0
+ * @category getters
+ */
+export const toSeconds = (self: DurationInput): number =>
+  match(self, {
+    onMillis: (millis) => millis / 1_000,
+    onNanos: (nanos) => Number(nanos) / 1_000_000_000
+  })
+
+/**
+ * @since 3.8.0
+ * @category getters
+ */
+export const toMinutes = (self: DurationInput): number =>
+  match(self, {
+    onMillis: (millis) => millis / 60_000,
+    onNanos: (nanos) => Number(nanos) / 60_000_000_000
+  })
+
+/**
+ * @since 3.8.0
+ * @category getters
+ */
+export const toHours = (self: DurationInput): number =>
+  match(self, {
+    onMillis: (millis) => millis / 3_600_000,
+    onNanos: (nanos) => Number(nanos) / 3_600_000_000_000
+  })
+
+/**
+ * @since 3.8.0
+ * @category getters
+ */
+export const toDays = (self: DurationInput): number =>
+  match(self, {
+    onMillis: (millis) => millis / 86_400_000,
+    onNanos: (nanos) => Number(nanos) / 86_400_000_000_000
+  })
+
+/**
+ * @since 3.8.0
+ * @category getters
+ */
+export const toWeeks = (self: DurationInput): number =>
+  match(self, {
+    onMillis: (millis) => millis / 604_800_000,
+    onNanos: (nanos) => Number(nanos) / 604_800_000_000_000
+  })
+
+/**
+ * Get the duration in nanoseconds as a bigint.
+ *
+ * If the duration is infinite, returns `Option.none()`
+ *
+ * @since 2.0.0
+ * @category getters
+ */
+export const toNanos = (self: DurationInput): Option.Option<bigint> => {
+  const _self = decode(self)
+  switch (_self.value._tag) {
+    case "Infinity":
+      return Option.none()
+    case "Nanos":
+      return Option.some(_self.value.nanos)
+    case "Millis":
+      return Option.some(BigInt(Math.round(_self.value.millis * 1_000_000)))
+  }
+}
+
+/**
+ * Get the duration in nanoseconds as a bigint.
+ *
+ * If the duration is infinite, it throws an error.
+ *
+ * @since 2.0.0
+ * @category getters
+ */
+export const unsafeToNanos = (self: DurationInput): bigint => {
+  const _self = decode(self)
+  switch (_self.value._tag) {
+    case "Infinity":
+      throw new Error("Cannot convert infinite duration to nanos")
+    case "Nanos":
+      return _self.value.nanos
+    case "Millis":
+      return BigInt(Math.round(_self.value.millis * 1_000_000))
+  }
+}
+
+/**
+ * @since 2.0.0
+ * @category getters
+ */
+export const toHrTime = (self: DurationInput): [seconds: number, nanos: number] => {
+  const _self = decode(self)
+  switch (_self.value._tag) {
+    case "Infinity":
+      return [Infinity, 0]
+    case "Nanos":
+      return [
+        Number(_self.value.nanos / bigint1e9),
+        Number(_self.value.nanos % bigint1e9)
+      ]
+    case "Millis":
+      return [
+        Math.floor(_self.value.millis / 1000),
+        Math.round((_self.value.millis % 1000) * 1_000_000)
+      ]
+  }
+}
+
+/**
+ * @since 2.0.0
+ * @category pattern matching
+ */
+export const match: {
+  /**
+   * @since 2.0.0
+   * @category pattern matching
+   */
+  <A, B>(
+    options: {
+      readonly onMillis: (millis: number) => A
+      readonly onNanos: (nanos: bigint) => B
+    }
+  ): (self: DurationInput) => A | B
+  /**
+   * @since 2.0.0
+   * @category pattern matching
+   */
+  <A, B>(
+    self: DurationInput,
+    options: {
+      readonly onMillis: (millis: number) => A
+      readonly onNanos: (nanos: bigint) => B
+    }
+  ): A | B
+} = dual(2, <A, B>(
+  self: DurationInput,
+  options: {
+    readonly onMillis: (millis: number) => A
+    readonly onNanos: (nanos: bigint) => B
+  }
+): A | B => {
+  const _self = decode(self)
+  switch (_self.value._tag) {
+    case "Nanos":
+      return options.onNanos(_self.value.nanos)
+    case "Infinity":
+      return options.onMillis(Infinity)
+    case "Millis":
+      return options.onMillis(_self.value.millis)
+  }
+})
+
+/**
+ * @since 2.0.0
+ * @category pattern matching
+ */
+export const matchWith: {
+  /**
+   * @since 2.0.0
+   * @category pattern matching
+   */
+  <A, B>(
+    that: DurationInput,
+    options: {
+      readonly onMillis: (self: number, that: number) => A
+      readonly onNanos: (self: bigint, that: bigint) => B
+    }
+  ): (self: DurationInput) => A | B
+  /**
+   * @since 2.0.0
+   * @category pattern matching
+   */
+  <A, B>(
+    self: DurationInput,
+    that: DurationInput,
+    options: {
+      readonly onMillis: (self: number, that: number) => A
+      readonly onNanos: (self: bigint, that: bigint) => B
+    }
+  ): A | B
+} = dual(3, <A, B>(
+  self: DurationInput,
+  that: DurationInput,
+  options: {
+    readonly onMillis: (self: number, that: number) => A
+    readonly onNanos: (self: bigint, that: bigint) => B
+  }
+): A | B => {
+  const _self = decode(self)
+  const _that = decode(that)
+  if (_self.value._tag === "Infinity" || _that.value._tag === "Infinity") {
+    return options.onMillis(
+      toMillis(_self),
+      toMillis(_that)
+    )
+  } else if (_self.value._tag === "Nanos" || _that.value._tag === "Nanos") {
+    const selfNanos = _self.value._tag === "Nanos" ?
+      _self.value.nanos :
+      BigInt(Math.round(_self.value.millis * 1_000_000))
+    const thatNanos = _that.value._tag === "Nanos" ?
+      _that.value.nanos :
+      BigInt(Math.round(_that.value.millis * 1_000_000))
+    return options.onNanos(selfNanos, thatNanos)
+  }
+
+  return options.onMillis(
+    _self.value.millis,
+    _that.value.millis
+  )
+})
+
+/**
+ * @category instances
+ * @since 2.0.0
+ */
+export const Order: order.Order<Duration> = order.make((self, that) =>
+  matchWith(self, that, {
+    onMillis: (self, that) => (self < that ? -1 : self > that ? 1 : 0),
+    onNanos: (self, that) => (self < that ? -1 : self > that ? 1 : 0)
+  })
+)
+
+/**
+ * Checks if a `Duration` is between a `minimum` and `maximum` value.
+ *
+ * @category predicates
+ * @since 2.0.0
+ */
+export const between: {
+  /**
+   * Checks if a `Duration` is between a `minimum` and `maximum` value.
+   *
+   * @category predicates
+   * @since 2.0.0
+   */
+  (
+    options: {
+      minimum: DurationInput
+      maximum: DurationInput
+    }
+  ): (self: DurationInput) => boolean
+  /**
+   * Checks if a `Duration` is between a `minimum` and `maximum` value.
+   *
+   * @category predicates
+   * @since 2.0.0
+   */
+  (
+    self: DurationInput,
+    options: {
+      minimum: DurationInput
+      maximum: DurationInput
+    }
+  ): boolean
+} = order.between(order.mapInput(Order, decode))
+
+/**
+ * @category instances
+ * @since 2.0.0
+ */
+export const Equivalence: equivalence.Equivalence<Duration> = (self, that) =>
+  matchWith(self, that, {
+    onMillis: (self, that) => self === that,
+    onNanos: (self, that) => self === that
+  })
+
+const _min = order.min(Order)
+
+/**
+ * @since 2.0.0
+ */
+export const min: {
+  /**
+   * @since 2.0.0
+   */
+  (that: DurationInput): (self: DurationInput) => Duration
+  /**
+   * @since 2.0.0
+   */
+  (self: DurationInput, that: DurationInput): Duration
+} = dual(2, (self: DurationInput, that: DurationInput): Duration => _min(decode(self), decode(that)))
+
+const _max = order.max(Order)
+
+/**
+ * @since 2.0.0
+ * @category order
+ */
+export const max: {
+  /**
+   * @since 2.0.0
+   * @category order
+   */
+  (that: DurationInput): (self: DurationInput) => Duration
+  /**
+   * @since 2.0.0
+   * @category order
+   */
+  (self: DurationInput, that: DurationInput): Duration
+} = dual(2, (self: DurationInput, that: DurationInput): Duration => _max(decode(self), decode(that)))
+
+const _clamp = order.clamp(Order)
+
+/**
+ * @since 2.0.0
+ * @category order
+ */
+export const clamp: {
+  /**
+   * @since 2.0.0
+   * @category order
+   */
+  (
+    options: {
+      minimum: DurationInput
+      maximum: DurationInput
+    }
+  ): (self: DurationInput) => Duration
+  /**
+   * @since 2.0.0
+   * @category order
+   */
+  (
+    self: DurationInput,
+    options: {
+      minimum: DurationInput
+      maximum: DurationInput
+    }
+  ): Duration
+} = dual(
+  2,
+  (self: DurationInput, options: {
+    minimum: DurationInput
+    maximum: DurationInput
+  }): Duration =>
+    _clamp(decode(self), {
+      minimum: decode(options.minimum),
+      maximum: decode(options.maximum)
+    })
+)
+
+/**
+ * @since 2.4.19
+ * @category math
+ */
+export const divide: {
+  /**
+   * @since 2.4.19
+   * @category math
+   */
+  (by: number): (self: DurationInput) => Option.Option<Duration>
+  /**
+   * @since 2.4.19
+   * @category math
+   */
+  (self: DurationInput, by: number): Option.Option<Duration>
+} = dual(
+  2,
+  (self: DurationInput, by: number): Option.Option<Duration> =>
+    match(self, {
+      onMillis: (millis) => {
+        if (by === 0 || isNaN(by) || !Number.isFinite(by)) {
+          return Option.none()
+        }
+        return Option.some(make(millis / by))
+      },
+      onNanos: (nanos) => {
+        if (isNaN(by) || by <= 0 || !Number.isFinite(by)) {
+          return Option.none()
+        }
+        try {
+          return Option.some(make(nanos / BigInt(by)))
+        } catch {
+          return Option.none()
+        }
+      }
+    })
+)
+
+/**
+ * @since 2.4.19
+ * @category math
+ */
+export const unsafeDivide: {
+  /**
+   * @since 2.4.19
+   * @category math
+   */
+  (by: number): (self: DurationInput) => Duration
+  /**
+   * @since 2.4.19
+   * @category math
+   */
+  (self: DurationInput, by: number): Duration
+} = dual(
+  2,
+  (self: DurationInput, by: number): Duration =>
+    match(self, {
+      onMillis: (millis) => make(millis / by),
+      onNanos: (nanos) => {
+        if (isNaN(by) || by < 0 || Object.is(by, -0)) {
+          return zero
+        } else if (Object.is(by, 0) || !Number.isFinite(by)) {
+          return infinity
+        }
+        return make(nanos / BigInt(by))
+      }
+    })
+)
+
+/**
+ * @since 2.0.0
+ * @category math
+ */
+export const times: {
+  /**
+   * @since 2.0.0
+   * @category math
+   */
+  (times: number): (self: DurationInput) => Duration
+  /**
+   * @since 2.0.0
+   * @category math
+   */
+  (self: DurationInput, times: number): Duration
+} = dual(
+  2,
+  (self: DurationInput, times: number): Duration =>
+    match(self, {
+      onMillis: (millis) => make(millis * times),
+      onNanos: (nanos) => make(nanos * BigInt(times))
+    })
+)
+
+/**
+ * @since 2.0.0
+ * @category math
+ */
+export const subtract: {
+  /**
+   * @since 2.0.0
+   * @category math
+   */
+  (that: DurationInput): (self: DurationInput) => Duration
+  /**
+   * @since 2.0.0
+   * @category math
+   */
+  (self: DurationInput, that: DurationInput): Duration
+} = dual(
+  2,
+  (self: DurationInput, that: DurationInput): Duration =>
+    matchWith(self, that, {
+      onMillis: (self, that) => make(self - that),
+      onNanos: (self, that) => make(self - that)
+    })
+)
+
+/**
+ * @since 2.0.0
+ * @category math
+ */
+export const sum: {
+  /**
+   * @since 2.0.0
+   * @category math
+   */
+  (that: DurationInput): (self: DurationInput) => Duration
+  /**
+   * @since 2.0.0
+   * @category math
+   */
+  (self: DurationInput, that: DurationInput): Duration
+} = dual(
+  2,
+  (self: DurationInput, that: DurationInput): Duration =>
+    matchWith(self, that, {
+      onMillis: (self, that) => make(self + that),
+      onNanos: (self, that) => make(self + that)
+    })
+)
+
+/**
+ * @since 2.0.0
+ * @category predicates
+ */
+export const lessThan: {
+  /**
+   * @since 2.0.0
+   * @category predicates
+   */
+  (that: DurationInput): (self: DurationInput) => boolean
+  /**
+   * @since 2.0.0
+   * @category predicates
+   */
+  (self: DurationInput, that: DurationInput): boolean
+} = dual(
+  2,
+  (self: DurationInput, that: DurationInput): boolean =>
+    matchWith(self, that, {
+      onMillis: (self, that) => self < that,
+      onNanos: (self, that) => self < that
+    })
+)
+
+/**
+ * @since 2.0.0
+ * @category predicates
+ */
+export const lessThanOrEqualTo: {
+  /**
+   * @since 2.0.0
+   * @category predicates
+   */
+  (that: DurationInput): (self: DurationInput) => boolean
+  /**
+   * @since 2.0.0
+   * @category predicates
+   */
+  (self: DurationInput, that: DurationInput): boolean
+} = dual(
+  2,
+  (self: DurationInput, that: DurationInput): boolean =>
+    matchWith(self, that, {
+      onMillis: (self, that) => self <= that,
+      onNanos: (self, that) => self <= that
+    })
+)
+
+/**
+ * @since 2.0.0
+ * @category predicates
+ */
+export const greaterThan: {
+  /**
+   * @since 2.0.0
+   * @category predicates
+   */
+  (that: DurationInput): (self: DurationInput) => boolean
+  /**
+   * @since 2.0.0
+   * @category predicates
+   */
+  (self: DurationInput, that: DurationInput): boolean
+} = dual(
+  2,
+  (self: DurationInput, that: DurationInput): boolean =>
+    matchWith(self, that, {
+      onMillis: (self, that) => self > that,
+      onNanos: (self, that) => self > that
+    })
+)
+
+/**
+ * @since 2.0.0
+ * @category predicates
+ */
+export const greaterThanOrEqualTo: {
+  /**
+   * @since 2.0.0
+   * @category predicates
+   */
+  (that: DurationInput): (self: DurationInput) => boolean
+  /**
+   * @since 2.0.0
+   * @category predicates
+   */
+  (self: DurationInput, that: DurationInput): boolean
+} = dual(
+  2,
+  (self: DurationInput, that: DurationInput): boolean =>
+    matchWith(self, that, {
+      onMillis: (self, that) => self >= that,
+      onNanos: (self, that) => self >= that
+    })
+)
+
+/**
+ * @since 2.0.0
+ * @category predicates
+ */
+export const equals: {
+  /**
+   * @since 2.0.0
+   * @category predicates
+   */
+  (that: DurationInput): (self: DurationInput) => boolean
+  /**
+   * @since 2.0.0
+   * @category predicates
+   */
+  (self: DurationInput, that: DurationInput): boolean
+} = dual(2, (self: DurationInput, that: DurationInput): boolean => Equivalence(decode(self), decode(that)))
+
+/**
+ * Converts a `Duration` to its parts.
+ *
+ * @since 3.8.0
+ * @category conversions
+ */
+export const parts = (self: DurationInput): {
+  days: number
+  hours: number
+  minutes: number
+  seconds: number
+  millis: number
+  nanos: number
+} => {
+  const duration = decode(self)
+  if (duration.value._tag === "Infinity") {
+    return {
+      days: Infinity,
+      hours: Infinity,
+      minutes: Infinity,
+      seconds: Infinity,
+      millis: Infinity,
+      nanos: Infinity
+    }
+  }
+
+  const nanos = unsafeToNanos(duration)
+  const ms = nanos / bigint1e6
+  const sec = ms / bigint1e3
+  const min = sec / bigint60
+  const hr = min / bigint60
+  const days = hr / bigint24
+
+  return {
+    days: Number(days),
+    hours: Number(hr % bigint24),
+    minutes: Number(min % bigint60),
+    seconds: Number(sec % bigint60),
+    millis: Number(ms % bigint1e3),
+    nanos: Number(nanos % bigint1e6)
+  }
+}
+
+/**
+ * Converts a `Duration` to a human readable string.
+ *
+ * @since 2.0.0
+ * @category conversions
+ * @example
+ * ```ts
+ * import { Duration } from "effect"
+ *
+ * Duration.format(Duration.millis(1000)) // "1s"
+ * Duration.format(Duration.millis(1001)) // "1s 1ms"
+ * ```
+ */
+export const format = (self: DurationInput): string => {
+  const duration = decode(self)
+  if (duration.value._tag === "Infinity") {
+    return "Infinity"
+  }
+  if (isZero(duration)) {
+    return "0"
+  }
+
+  const fragments = parts(duration)
+  const pieces = []
+  if (fragments.days !== 0) {
+    pieces.push(`${fragments.days}d`)
+  }
+
+  if (fragments.hours !== 0) {
+    pieces.push(`${fragments.hours}h`)
+  }
+
+  if (fragments.minutes !== 0) {
+    pieces.push(`${fragments.minutes}m`)
+  }
+
+  if (fragments.seconds !== 0) {
+    pieces.push(`${fragments.seconds}s`)
+  }
+
+  if (fragments.millis !== 0) {
+    pieces.push(`${fragments.millis}ms`)
+  }
+
+  if (fragments.nanos !== 0) {
+    pieces.push(`${fragments.nanos}ns`)
+  }
+
+  return pieces.join(" ")
+}
+
+/**
+ * Formats a Duration into an ISO8601 duration string.
+ *
+ * Months are assumed to be 30 days and years are assumed to be 365 days.
+ *
+ * Milliseconds and nanoseconds are expressed as fractional seconds.
+ *
+ * @example
+ * ```ts
+ * import { Duration } from "effect"
+ *
+ * Duration.unsafeFormatIso(Duration.days(1)) // => "P1D"
+ * Duration.unsafeFormatIso(Duration.minutes(90)) // => "PT1H30M"
+ * Duration.unsafeFormatIso(Duration.millis(1500)) // => "PT1.5S"
+ * ```
+ *
+ * @throws `RangeError` If the duration is not finite.
+ *
+ * @since 3.13.0
+ * @category conversions
+ */
+export const unsafeFormatIso = (self: DurationInput): string => {
+  const duration = decode(self)
+  if (!isFinite(duration)) {
+    throw new RangeError("Cannot format infinite duration")
+  }
+
+  const fragments = []
+  const {
+    days,
+    hours,
+    millis,
+    minutes,
+    nanos,
+    seconds
+  } = parts(duration)
+
+  let rest = days
+  if (rest >= 365) {
+    const years = Math.floor(rest / 365)
+    rest %= 365
+    fragments.push(`${years}Y`)
+  }
+
+  if (rest >= 30) {
+    const months = Math.floor(rest / 30)
+    rest %= 30
+    fragments.push(`${months}M`)
+  }
+
+  if (rest >= 7) {
+    const weeks = Math.floor(rest / 7)
+    rest %= 7
+    fragments.push(`${weeks}W`)
+  }
+
+  if (rest > 0) {
+    fragments.push(`${rest}D`)
+  }
+
+  if (hours !== 0 || minutes !== 0 || seconds !== 0 || millis !== 0 || nanos !== 0) {
+    fragments.push("T")
+
+    if (hours !== 0) {
+      fragments.push(`${hours}H`)
+    }
+
+    if (minutes !== 0) {
+      fragments.push(`${minutes}M`)
+    }
+
+    if (seconds !== 0 || millis !== 0 || nanos !== 0) {
+      const total = BigInt(seconds) * bigint1e9 + BigInt(millis) * bigint1e6 + BigInt(nanos)
+      const str = (Number(total) / 1e9).toFixed(9).replace(/\.?0+$/, "")
+      fragments.push(`${str}S`)
+    }
+  }
+
+  return `P${fragments.join("") || "T0S"}`
+}
+
+/**
+ * Formats a Duration into an ISO8601 duration string.
+ *
+ * Months are assumed to be 30 days and years are assumed to be 365 days.
+ *
+ * Returns `Option.none()` if the duration is infinite.
+ *
+ * @example
+ * ```ts
+ * import { Duration, Option } from "effect"
+ *
+ * Duration.formatIso(Duration.days(1)) // => Option.some("P1D")
+ * Duration.formatIso(Duration.minutes(90)) // => Option.some("PT1H30M")
+ * Duration.formatIso(Duration.millis(1500)) // => Option.some("PT1.5S")
+ * Duration.formatIso(Duration.infinity) // => Option.none()
+ * ```
+ *
+ * @since 3.13.0
+ * @category conversions
+ */
+export const formatIso = (self: DurationInput): Option.Option<string> => {
+  const duration = decode(self)
+  return isFinite(duration) ? Option.some(unsafeFormatIso(duration)) : Option.none()
+}
+
+/**
+ * Parses an ISO8601 duration string into a `Duration`.
+ *
+ * Months are assumed to be 30 days and years are assumed to be 365 days.
+ *
+ * @example
+ * ```ts
+ * import { Duration, Option } from "effect"
+ *
+ * Duration.fromIso("P1D") // => Option.some(Duration.days(1))
+ * Duration.fromIso("PT1H") // => Option.some(Duration.hours(1))
+ * Duration.fromIso("PT1M") // => Option.some(Duration.minutes(1))
+ * Duration.fromIso("PT1.5S") // => Option.some(Duration.seconds(1.5))
+ * ```
+ *
+ * @since 3.13.0
+ * @category conversions
+ */
+export const fromIso = (iso: string): Option.Option<Duration> => {
+  const result = DURATION_ISO_REGEX.exec(iso)
+  if (result == null) {
+    return Option.none()
+  }
+
+  const [years, months, weeks, days, hours, mins, secs] = result.slice(1, 8).map((_) => _ ? Number(_) : 0)
+  const value = years * 365 * 24 * 60 * 60 +
+    months * 30 * 24 * 60 * 60 +
+    weeks * 7 * 24 * 60 * 60 +
+    days * 24 * 60 * 60 +
+    hours * 60 * 60 +
+    mins * 60 +
+    secs
+
+  return Option.some(seconds(value))
+}
+
+const DURATION_ISO_REGEX =
+  /^P(?!$)(?:(\d+)Y)?(?:(\d+)M)?(?:(\d+)W)?(?:(\d+)D)?(?:T(?!$)(?:(\d+)H)?(?:(\d+)M)?(?:(\d+(?:\.\d+)?)S)?)?$/