postgres-interval 4.0.2 → 4.1.0

package/index.d.ts

@@ -61,6 +61,24 @@ declare namespace PostgresInterval {
      * ```
      */
     toISOStringShort(): string;
+    /**
+     * Returns a [`Temporal.Duration`](https://tc39.es/proposal-temporal/docs/duration.html) representing the interval.
+     *
+     * Requires `globalThis.Temporal` (Node 26+, or a polyfill assigned to the global). Throws otherwise.
+     *
+     * Postgres mixed-sign intervals (e.g. `1 mon -1 days`) throw a `RangeError`, because `Temporal.Duration` requires a single sign across all fields.
+     *
+     * The `Temporal` types are not yet in the default TypeScript lib. For this signature to resolve, your project needs Temporal lib types (the TypeScript lib once available, or `@js-temporal/polyfill` types).
+     *
+     * ```js
+     * var parse = require('postgres-interval')
+     * var interval = parse('01:02:03')
+     * // => { hours: 1, minutes: 2, seconds: 3 }
+     * interval.toTemporalDuration().toString()
+     * // PT1H2M3S
+     * ```
+     */
+    toTemporalDuration(): Temporal.Duration;
   }
 }
 

package/index.js

@@ -93,6 +93,25 @@ PostgresInterval.prototype.toISOStringShort = function () {
   return toISOString.call(this, { short: true })
 }
 
+PostgresInterval.prototype.toTemporalDuration = function () {
+  if (typeof globalThis.Temporal === 'undefined') {
+    throw new Error('Temporal is not available. It ships unflagged in Node 26+. On older runtimes, install a polyfill (e.g. @js-temporal/polyfill) and assign it to globalThis.Temporal.')
+  }
+
+  const totalMicroseconds = Math.round(this.milliseconds * 1000)
+
+  return globalThis.Temporal.Duration.from({
+    years: this.years,
+    months: this.months,
+    days: this.days,
+    hours: this.hours,
+    minutes: this.minutes,
+    seconds: this.seconds,
+    milliseconds: Math.trunc(totalMicroseconds / 1000),
+    microseconds: totalMicroseconds % 1000
+  })
+}
+
 function toISOString ({ short }) {
   let datePart = ''
 
@@ -198,13 +217,7 @@ function parse (instance, interval) {
       nextNegative = -1
       position.value++
       continue
-    } else if (char === '+') {
-      position.value++
-      continue
-    } else if (char === ' ') {
-      position.value++
-      continue
-    } else if (char < '0' || char > '9') {
+    } else if (!(char >= '0' && char <= '9')) {
       position.value++
       continue
     } else {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "postgres-interval",
   "main": "index.js",
-  "version": "4.0.2",
+  "version": "4.1.0",
   "description": "Parse Postgres interval columns",
   "license": "MIT",
   "repository": "bendrucker/postgres-interval",

package/readme.md

@@ -57,6 +57,16 @@ Also available as `interval.toISO()` for backwards compatibility.
 
 Returns an [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#Durations) compliant string shortened to minimum length, for example `PT9M`.
 
+#### `interval.toTemporalDuration()` -> `Temporal.Duration`
+
+Returns a [`Temporal.Duration`](https://tc39.es/proposal-temporal/docs/duration.html) representing the interval.
+
+Requires `globalThis.Temporal`. It ships unflagged in Node 26+. On older runtimes, install a polyfill such as [`@js-temporal/polyfill`](https://www.npmjs.com/package/@js-temporal/polyfill) and assign it to `globalThis.Temporal`. The method throws if `Temporal` is unavailable.
+
+Postgres mixed-sign intervals (e.g. `1 mon -1 days`) throw a `RangeError`. `Temporal.Duration` requires all fields to share a single sign, which these intervals violate.
+
+The `Temporal` types are not yet in the default TypeScript lib. To resolve the return type, your project needs Temporal lib types: the TypeScript lib once available, or the `@js-temporal/polyfill` types. This package adds no type dependency.
+
 ## License
 
 MIT © [Ben Drucker](http://bendrucker.me)