Duration: add toSeconds

.changeset/odd-bears-swim.md

@@ -0,0 +1,5 @@
+---
+"@effect/data": patch
+---
+
+Duration: add toSeconds, closes #503

docs/modules/Duration.ts.md

@@ -27,6 +27,7 @@ Added in v1.0.0
   - [toHrTime](#tohrtime)
   - [toMillis](#tomillis)
   - [toNanos](#tonanos)
+  - [toSeconds](#toseconds)
   - [unsafeToNanos](#unsafetonanos)
 - [guards](#guards)
   - [isDuration](#isduration)
@@ -199,6 +200,16 @@ export declare const toNanos: (self: DurationInput) => Option.Option<bigint>
 
 Added in v1.0.0
 
+## toSeconds
+
+**Signature**
+
+```ts
+export declare const toSeconds: (self: DurationInput) => number
+```
+
+Added in v1.0.0
+
 ## unsafeToNanos
 
 Get the duration in nanoseconds as a bigint.

src/Duration.ts

@@ -240,6 +240,12 @@ export const toMillis = (self: DurationInput): number => {
   }
 }
 
+/**
+ * @since 1.0.0
+ * @category getters
+ */
+export const toSeconds = (self: DurationInput): number => toMillis(self) / 1_000
+
 /**
  * Get the duration in nanoseconds as a bigint.
  *

test/Duration.ts

@@ -257,6 +257,16 @@ describe.concurrent("Duration", () => {
     expect(Duration.toMillis("1 millis")).toBe(1)
   })
 
+  it("toSeconds", () => {
+    expect(Duration.millis(1).pipe(Duration.toSeconds)).toBe(0.001)
+    expect(Duration.nanos(1n).pipe(Duration.toSeconds)).toBe(9.999999999999999e-10)
+    expect(Duration.infinity.pipe(Duration.toSeconds)).toBe(Infinity)
+
+    expect(Duration.toSeconds("1 seconds")).toBe(1)
+    expect(Duration.toSeconds("3 seconds")).toBe(3)
+    expect(Duration.toSeconds("3 minutes")).toBe(180)
+  })
+
   it("toNanos", () => {
     expect(Duration.nanos(1n).pipe(Duration.toNanos)).toEqual(Option.some(1n))
     expect(Duration.infinity.pipe(Duration.toNanos)).toEqual(Option.none())