Add DateTime.toEpochSeconds

.changeset/add-datetime-epoch-seconds.md

@@ -0,0 +1,5 @@
+---
+"effect": patch
+---
+
+Add `DateTime.toEpochSeconds` for whole Unix timestamps.

packages/effect/src/DateTime.ts

@@ -938,6 +938,14 @@ export const zonedOffsetIso: (self: Zoned) => string = Internal.zonedOffsetIso
  */
 export const toEpochMillis: (self: DateTime) => number = Internal.toEpochMillis
 
+/**
+ * Get the whole seconds since the Unix epoch of a `DateTime`.
+ *
+ * @since 3.22.0
+ * @category conversions
+ */
+export const toEpochSeconds: (self: DateTime) => number = Internal.toEpochSeconds
+
 /**
  * Remove the time aspect of a `DateTime`, first adjusting for the time
  * zone. It will return a `DateTime.Utc` only containing the date.

packages/effect/src/internal/dateTime.ts

@@ -613,6 +613,9 @@ export const zonedOffsetIso = (self: DateTime.Zoned): string => offsetToString(z
 /** @internal */
 export const toEpochMillis = (self: DateTime.DateTime): number => self.epochMillis
 
+/** @internal */
+export const toEpochSeconds = (self: DateTime.DateTime): number => Math.floor(self.epochMillis / 1000)
+
 /** @internal */
 export const removeTime = (self: DateTime.DateTime): DateTime.Utc =>
   withDate(self, (date) => {

packages/effect/test/DateTime.test.ts

@@ -368,6 +368,16 @@ describe("DateTime", () => {
       ))
   })
 
+  describe("toEpochSeconds", () => {
+    it("converts milliseconds to whole seconds", () => {
+      strictEqual(DateTime.toEpochSeconds(DateTime.unsafeMake(1_999)), 1)
+    })
+
+    it("floors timestamps before the Unix epoch", () => {
+      strictEqual(DateTime.toEpochSeconds(DateTime.unsafeMake(-1)), -1)
+    })
+  })
+
   describe("removeTime", () => {
     it("removes time", () => {
       const dt = DateTime.unsafeMakeZoned("2024-01-01T01:00:00Z", {