 Server : Apache/2 System : Linux server-15-235-50-60 5.15.0-164-generic #174-Ubuntu SMP Fri Nov 14 20:25:16 UTC 2025 x86_64 User : gositeme ( 1004) PHP Version : 8.2.29 Disable Function : exec,system,passthru,shell_exec,proc_close,proc_open,dl,popen,show_source,posix_kill,posix_mkfifo,posix_getpwuid,posix_setpgid,posix_setsid,posix_setuid,posix_setgid,posix_seteuid,posix_setegid,posix_uname Directory : /home/gositeme/domains/lavocat.quebec/private_html/node_modules/effect/src/ |
/**
* @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)?)?$/