@gobrand/tiempo 2.3.0 → 2.3.1

package/README.md

@@ -47,15 +47,24 @@ The Temporal API is powerful but requires understanding its various methods and
 ## Quick Start
 
 ```typescript
-import { toZonedTime, toUtcString } from '@gobrand/tiempo';
+import { toZonedTime, toUtcString, toUtc, toDate } from '@gobrand/tiempo';
 
-// Backend sends: "2025-01-20T20:00:00.000Z"
+// From ISO string (typical backend API)
 const zoned = toZonedTime("2025-01-20T20:00:00.000Z", "America/New_York");
 console.log(zoned.hour); // 15 (3 PM in New York)
 
-// Send back to backend:
-const utc = toUtcString(zoned);
-console.log(utc); // "2025-01-20T20:00:00Z"
+// From Date object (e.g., Drizzle ORM)
+const date = new Date("2025-01-20T20:00:00.000Z");
+const zonedFromDate = toZonedTime(date, "America/New_York");
+console.log(zonedFromDate.hour); // 15 (3 PM in New York)
+
+// Back to ISO string
+const utcString = toUtcString(zoned);
+console.log(utcString); // "2025-01-20T20:00:00Z"
+
+// Back to Date object (for Drizzle ORM)
+const backToDate = toDate(zoned);
+console.log(backToDate.toISOString()); // "2025-01-20T20:00:00.000Z"
 ```
 
 ## API
@@ -64,10 +73,10 @@ console.log(utc); // "2025-01-20T20:00:00Z"
 
 #### `toZonedTime(input, timezone)`
 
-Convert a UTC ISO string, Instant, or ZonedDateTime to a ZonedDateTime in the specified timezone.
+Convert a UTC ISO string, Date, Instant, or ZonedDateTime to a ZonedDateTime in the specified timezone.
 
 **Parameters:**
-- `input` (string | Temporal.Instant | Temporal.ZonedDateTime): A UTC ISO 8601 string, Temporal.Instant, or Temporal.ZonedDateTime
+- `input` (string | Date | Temporal.Instant | Temporal.ZonedDateTime): A UTC ISO 8601 string, Date object, Temporal.Instant, or Temporal.ZonedDateTime
 - `timezone` (string): An IANA timezone identifier (e.g., `"America/New_York"`, `"Europe/London"`)
 
 **Returns:** `Temporal.ZonedDateTime` - The same instant in the specified timezone
@@ -81,9 +90,14 @@ const zoned = toZonedTime("2025-01-20T20:00:00.000Z", "America/New_York");
 console.log(zoned.hour); // 15 (3 PM in New York)
 console.log(zoned.toString()); // "2025-01-20T15:00:00-05:00[America/New_York]"
 
+// From Date (e.g., from Drizzle ORM)
+const date = new Date("2025-01-20T20:00:00.000Z");
+const zoned2 = toZonedTime(date, "America/New_York");
+console.log(zoned2.hour); // 15 (3 PM in New York)
+
 // From Instant
 const instant = Temporal.Instant.from("2025-01-20T20:00:00Z");
-const zoned2 = toZonedTime(instant, "Asia/Tokyo");
+const zoned3 = toZonedTime(instant, "Asia/Tokyo");
 
 // From ZonedDateTime (convert to different timezone)
 const nyTime = Temporal.ZonedDateTime.from("2025-01-20T15:00:00-05:00[America/New_York]");
@@ -92,10 +106,10 @@ const tokyoTime = toZonedTime(nyTime, "Asia/Tokyo");
 
 #### `toUtc(input)`
 
-Convert a UTC ISO string or ZonedDateTime to a Temporal.Instant (UTC).
+Convert a UTC ISO string, Date, or ZonedDateTime to a Temporal.Instant (UTC).
 
 **Parameters:**
-- `input` (string | Temporal.ZonedDateTime): A UTC ISO 8601 string or Temporal.ZonedDateTime
+- `input` (string | Date | Temporal.ZonedDateTime): A UTC ISO 8601 string, Date object, or Temporal.ZonedDateTime
 
 **Returns:** `Temporal.Instant` - A Temporal.Instant representing the same moment in UTC
 
@@ -106,10 +120,14 @@ import { toUtc } from '@gobrand/tiempo';
 // From ISO string
 const instant = toUtc("2025-01-20T20:00:00.000Z");
 
+// From Date (e.g., from Drizzle ORM)
+const date = new Date("2025-01-20T20:00:00.000Z");
+const instant2 = toUtc(date);
+
 // From ZonedDateTime
 const zoned = Temporal.ZonedDateTime.from("2025-01-20T15:00:00-05:00[America/New_York]");
-const instant2 = toUtc(zoned);
-// Both represent the same UTC moment: 2025-01-20T20:00:00Z
+const instant3 = toUtc(zoned);
+// All represent the same UTC moment: 2025-01-20T20:00:00Z
 ```
 
 #### `toUtcString(input)`
@@ -136,6 +154,35 @@ const iso2 = toUtcString(instant);
 console.log(iso2); // "2025-01-20T20:00:00Z"
 ```
 
+#### `toDate(input)`
+
+Convert a Temporal.Instant or ZonedDateTime to a Date object.
+
+**Parameters:**
+- `input` (Temporal.Instant | Temporal.ZonedDateTime): A Temporal.Instant or Temporal.ZonedDateTime
+
+**Returns:** `Date` - A Date object representing the same moment in time
+
+**Example:**
+```typescript
+import { toDate } from '@gobrand/tiempo';
+
+// From Instant
+const instant = Temporal.Instant.from("2025-01-20T20:00:00Z");
+const date = toDate(instant);
+console.log(date.toISOString()); // "2025-01-20T20:00:00.000Z"
+
+// From ZonedDateTime
+const zoned = Temporal.ZonedDateTime.from("2025-01-20T15:00:00-05:00[America/New_York]");
+const date2 = toDate(zoned);
+console.log(date2.toISOString()); // "2025-01-20T20:00:00.000Z"
+
+// Use with Drizzle ORM (for storing back to database)
+const instant = Temporal.Instant.from("2025-01-20T20:00:00Z");
+const dateForDb = toDate(instant);
+await db.update(posts).set({ publishedAt: dateForDb });
+```
+
 ### Formatting
 
 #### `intlFormatDistance(laterDate, earlierDate, options?)`
@@ -700,6 +747,36 @@ const instant2 = Temporal.Instant.from('2025-01-20T23:00:00Z');
 isSameDay(instant1, instant2); // true (both Jan 20 in UTC)
 ```
 
+## Drizzle ORM Integration
+
+tiempo seamlessly integrates with Drizzle ORM for database datetime operations. When using Drizzle with PostgreSQL `timestamptz` columns and `mode: 'date'`, tiempo provides utilities to convert between Date objects and Temporal.
+
+```typescript
+import { toZonedTime, toUtc, toDate } from '@gobrand/tiempo';
+
+// 1. Reading from database (Drizzle returns Date with mode: 'date')
+const post = await db.query.posts.findFirst();
+const publishedAt = post.publishedAt; // Date object
+
+// 2. Convert to user's timezone for display
+const userTimezone = "America/New_York";
+const zonedTime = toZonedTime(publishedAt, userTimezone);
+console.log(zonedTime.hour); // Local hour in user's timezone
+
+// 3. User reschedules post to tomorrow at 3 PM their time
+const rescheduled = zonedTime.add({ days: 1 }).with({ hour: 15, minute: 0 });
+
+// 4. Convert back to Date for database storage
+const dateForDb = toDate(rescheduled);
+await db.update(posts).set({ publishedAt: dateForDb }).where(eq(posts.id, post.id));
+```
+
+**Why this works:**
+- Drizzle's `mode: 'date'` returns JavaScript `Date` objects (timestamps)
+- `toZonedTime(date, tz)` converts the Date to a timezone-aware Temporal object
+- Work with Temporal's powerful API for date arithmetic and manipulation
+- `toDate(temporal)` converts back to Date for Drizzle storage
+
 ## Real World Examples
 
 ### Example 1: Social Media Post Scheduler

package/dist/{chunk-KD5GEHUA.js → chunk-2MP3ESL7.js}

@@ -4,6 +4,9 @@ function toZonedTime(input, timezone) {
   if (typeof input === "string") {
     return Temporal.Instant.from(input).toZonedDateTimeISO(timezone);
   }
+  if (input instanceof Date) {
+    return Temporal.Instant.from(input.toISOString()).toZonedDateTimeISO(timezone);
+  }
   if (input instanceof Temporal.Instant) {
     return input.toZonedDateTimeISO(timezone);
   }
@@ -13,4 +16,4 @@ function toZonedTime(input, timezone) {
 export {
   toZonedTime
 };
-//# sourceMappingURL=chunk-KD5GEHUA.js.map
+//# sourceMappingURL=chunk-2MP3ESL7.js.map

package/dist/chunk-2MP3ESL7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/toZonedTime.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\n\n/**\n * Convert a UTC ISO string, Date, Instant, or ZonedDateTime to a ZonedDateTime in the specified timezone.\n *\n * @param input - A UTC ISO 8601 string, Date object, Temporal.Instant, or Temporal.ZonedDateTime\n * @param timezone - IANA timezone identifier (e.g., \"America/New_York\", \"Europe/London\")\n * @returns A Temporal.ZonedDateTime in the specified timezone\n *\n * @example\n * ```typescript\n * // From ISO string\n * const zoned = toZonedTime(\"2025-01-20T20:00:00.000Z\", \"America/New_York\");\n * // zoned.hour === 15 (3 PM in New York)\n *\n * // From Date (e.g., from Drizzle ORM)\n * const date = new Date(\"2025-01-20T20:00:00.000Z\");\n * const zoned2 = toZonedTime(date, \"America/New_York\");\n *\n * // From Instant\n * const instant = Temporal.Instant.from(\"2025-01-20T20:00:00Z\");\n * const zoned3 = toZonedTime(instant, \"Asia/Tokyo\");\n *\n * // From ZonedDateTime (convert to different timezone)\n * const nyTime = Temporal.ZonedDateTime.from(\"2025-01-20T15:00:00-05:00[America/New_York]\");\n * const tokyoTime = toZonedTime(nyTime, \"Asia/Tokyo\");\n * ```\n */\nexport function toZonedTime(\n  input: string | Date | Temporal.Instant | Temporal.ZonedDateTime,\n  timezone: string\n): Temporal.ZonedDateTime {\n  if (typeof input === 'string') {\n    return Temporal.Instant.from(input).toZonedDateTimeISO(timezone);\n  }\n\n  if (input instanceof Date) {\n    return Temporal.Instant.from(input.toISOString()).toZonedDateTimeISO(timezone);\n  }\n\n  if (input instanceof Temporal.Instant) {\n    return input.toZonedDateTimeISO(timezone);\n  }\n\n  return input.toInstant().toZonedDateTimeISO(timezone);\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AA4BlB,SAAS,YACd,OACA,UACwB;AACxB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,SAAS,QAAQ,KAAK,KAAK,EAAE,mBAAmB,QAAQ;AAAA,EACjE;AAEA,MAAI,iBAAiB,MAAM;AACzB,WAAO,SAAS,QAAQ,KAAK,MAAM,YAAY,CAAC,EAAE,mBAAmB,QAAQ;AAAA,EAC/E;AAEA,MAAI,iBAAiB,SAAS,SAAS;AACrC,WAAO,MAAM,mBAAmB,QAAQ;AAAA,EAC1C;AAEA,SAAO,MAAM,UAAU,EAAE,mBAAmB,QAAQ;AACtD;","names":[]}

package/dist/{chunk-GPAFAHKJ.js → chunk-BW5SFCKS.js}

@@ -4,10 +4,13 @@ function toUtc(input) {
   if (typeof input === "string") {
     return Temporal.Instant.from(input);
   }
+  if (input instanceof Date) {
+    return Temporal.Instant.from(input.toISOString());
+  }
   return input.toInstant();
 }
 
 export {
   toUtc
 };
-//# sourceMappingURL=chunk-GPAFAHKJ.js.map
+//# sourceMappingURL=chunk-BW5SFCKS.js.map

package/dist/chunk-BW5SFCKS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/toUtc.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\n\n/**\n * Convert a UTC ISO string, Date, or ZonedDateTime to a Temporal.Instant (UTC).\n *\n * @param input - A UTC ISO 8601 string, Date object, or Temporal.ZonedDateTime\n * @returns A Temporal.Instant representing the same moment in UTC\n *\n * @example\n * ```typescript\n * // From ISO string\n * const instant = toUtc(\"2025-01-20T20:00:00.000Z\");\n *\n * // From Date (e.g., from Drizzle ORM)\n * const date = new Date(\"2025-01-20T20:00:00.000Z\");\n * const instant2 = toUtc(date);\n *\n * // From ZonedDateTime\n * const zoned = Temporal.ZonedDateTime.from(\"2025-01-20T15:00:00-05:00[America/New_York]\");\n * const instant3 = toUtc(zoned);\n * // All represent the same UTC moment: 2025-01-20T20:00:00Z\n * ```\n */\nexport function toUtc(\n  input: string | Date | Temporal.ZonedDateTime\n): Temporal.Instant {\n  if (typeof input === 'string') {\n    return Temporal.Instant.from(input);\n  }\n\n  if (input instanceof Date) {\n    return Temporal.Instant.from(input.toISOString());\n  }\n\n  return input.toInstant();\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAuBlB,SAAS,MACd,OACkB;AAClB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,SAAS,QAAQ,KAAK,KAAK;AAAA,EACpC;AAEA,MAAI,iBAAiB,MAAM;AACzB,WAAO,SAAS,QAAQ,KAAK,MAAM,YAAY,CAAC;AAAA,EAClD;AAEA,SAAO,MAAM,UAAU;AACzB;","names":[]}

package/dist/chunk-TGKWBQ7L.js

@@ -0,0 +1,13 @@
+// src/toDate.ts
+import { Temporal } from "@js-temporal/polyfill";
+function toDate(input) {
+  if (input instanceof Temporal.Instant) {
+    return new Date(input.toString());
+  }
+  return new Date(input.toInstant().toString());
+}
+
+export {
+  toDate
+};
+//# sourceMappingURL=chunk-TGKWBQ7L.js.map

package/dist/chunk-TGKWBQ7L.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/toDate.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\n\n/**\n * Convert a Temporal.Instant or ZonedDateTime to a Date object.\n *\n * @param input - A Temporal.Instant or Temporal.ZonedDateTime\n * @returns A Date object representing the same moment in time\n *\n * @example\n * ```typescript\n * // From Instant\n * const instant = Temporal.Instant.from(\"2025-01-20T20:00:00Z\");\n * const date = toDate(instant);\n * // date.toISOString() === \"2025-01-20T20:00:00.000Z\"\n *\n * // From ZonedDateTime\n * const zoned = Temporal.ZonedDateTime.from(\"2025-01-20T15:00:00-05:00[America/New_York]\");\n * const date2 = toDate(zoned);\n * // date2.toISOString() === \"2025-01-20T20:00:00.000Z\"\n *\n * // Use with Drizzle ORM (for storing back to database)\n * const instant = Temporal.Instant.from(\"2025-01-20T20:00:00Z\");\n * const date = toDate(instant);\n * await db.update(posts).set({ publishedAt: date });\n * ```\n */\nexport function toDate(\n  input: Temporal.Instant | Temporal.ZonedDateTime\n): Date {\n  if (input instanceof Temporal.Instant) {\n    return new Date(input.toString());\n  }\n\n  return new Date(input.toInstant().toString());\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AA0BlB,SAAS,OACd,OACM;AACN,MAAI,iBAAiB,SAAS,SAAS;AACrC,WAAO,IAAI,KAAK,MAAM,SAAS,CAAC;AAAA,EAClC;AAEA,SAAO,IAAI,KAAK,MAAM,UAAU,EAAE,SAAS,CAAC;AAC9C;","names":[]}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { toZonedTime } from './toZonedTime';
 export { toUtc } from './toUtc';
 export { toUtcString } from './toUtcString';
+export { toDate } from './toDate';
 export { format, type FormatOptions } from './format';
 export { today } from './today';
 export { now } from './now';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,12 +1,15 @@
+import {
+  toDate
+} from "./chunk-TGKWBQ7L.js";
 import {
   toUtc
-} from "./chunk-GPAFAHKJ.js";
+} from "./chunk-BW5SFCKS.js";
 import {
   toUtcString
 } from "./chunk-DMKGJY4N.js";
 import {
   toZonedTime
-} from "./chunk-KD5GEHUA.js";
+} from "./chunk-2MP3ESL7.js";
 import {
   today
 } from "./chunk-67QHALIG.js";
@@ -233,6 +236,7 @@ export {
   subSeconds,
   subWeeks,
   subYears,
+  toDate,
   toUtc,
   toUtcString,
   toZonedTime,

package/dist/toDate.d.ts

@@ -0,0 +1,27 @@
+import { Temporal } from '@js-temporal/polyfill';
+/**
+ * Convert a Temporal.Instant or ZonedDateTime to a Date object.
+ *
+ * @param input - A Temporal.Instant or Temporal.ZonedDateTime
+ * @returns A Date object representing the same moment in time
+ *
+ * @example
+ * ```typescript
+ * // From Instant
+ * const instant = Temporal.Instant.from("2025-01-20T20:00:00Z");
+ * const date = toDate(instant);
+ * // date.toISOString() === "2025-01-20T20:00:00.000Z"
+ *
+ * // From ZonedDateTime
+ * const zoned = Temporal.ZonedDateTime.from("2025-01-20T15:00:00-05:00[America/New_York]");
+ * const date2 = toDate(zoned);
+ * // date2.toISOString() === "2025-01-20T20:00:00.000Z"
+ *
+ * // Use with Drizzle ORM (for storing back to database)
+ * const instant = Temporal.Instant.from("2025-01-20T20:00:00Z");
+ * const date = toDate(instant);
+ * await db.update(posts).set({ publishedAt: date });
+ * ```
+ */
+export declare function toDate(input: Temporal.Instant | Temporal.ZonedDateTime): Date;
+//# sourceMappingURL=toDate.d.ts.map

package/dist/toDate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toDate.d.ts","sourceRoot":"","sources":["../src/toDate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,MAAM,CACpB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,GAC/C,IAAI,CAMN"}

package/dist/toDate.js

@@ -0,0 +1,7 @@
+import {
+  toDate
+} from "./chunk-TGKWBQ7L.js";
+export {
+  toDate
+};
+//# sourceMappingURL=toDate.js.map

package/dist/toDate.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/toDate.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=toDate.test.d.ts.map

package/dist/toDate.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toDate.test.d.ts","sourceRoot":"","sources":["../src/toDate.test.ts"],"names":[],"mappings":""}

package/dist/toUtc.d.ts

@@ -1,8 +1,8 @@
 import { Temporal } from '@js-temporal/polyfill';
 /**
- * Convert a UTC ISO string or ZonedDateTime to a Temporal.Instant (UTC).
+ * Convert a UTC ISO string, Date, or ZonedDateTime to a Temporal.Instant (UTC).
  *
- * @param input - A UTC ISO 8601 string or Temporal.ZonedDateTime
+ * @param input - A UTC ISO 8601 string, Date object, or Temporal.ZonedDateTime
  * @returns A Temporal.Instant representing the same moment in UTC
  *
  * @example
@@ -10,11 +10,15 @@ import { Temporal } from '@js-temporal/polyfill';
  * // From ISO string
  * const instant = toUtc("2025-01-20T20:00:00.000Z");
  *
+ * // From Date (e.g., from Drizzle ORM)
+ * const date = new Date("2025-01-20T20:00:00.000Z");
+ * const instant2 = toUtc(date);
+ *
  * // From ZonedDateTime
  * const zoned = Temporal.ZonedDateTime.from("2025-01-20T15:00:00-05:00[America/New_York]");
- * const instant2 = toUtc(zoned);
- * // Both represent the same UTC moment: 2025-01-20T20:00:00Z
+ * const instant3 = toUtc(zoned);
+ * // All represent the same UTC moment: 2025-01-20T20:00:00Z
  * ```
  */
-export declare function toUtc(input: string | Temporal.ZonedDateTime): Temporal.Instant;
+export declare function toUtc(input: string | Date | Temporal.ZonedDateTime): Temporal.Instant;
 //# sourceMappingURL=toUtc.d.ts.map

package/dist/toUtc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toUtc.d.ts","sourceRoot":"","sources":["../src/toUtc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,KAAK,CACnB,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,aAAa,GACrC,QAAQ,CAAC,OAAO,CAMlB"}
+{"version":3,"file":"toUtc.d.ts","sourceRoot":"","sources":["../src/toUtc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,KAAK,CACnB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAC,aAAa,GAC5C,QAAQ,CAAC,OAAO,CAUlB"}

package/dist/toUtc.js

@@ -1,6 +1,6 @@
 import {
   toUtc
-} from "./chunk-GPAFAHKJ.js";
+} from "./chunk-BW5SFCKS.js";
 export {
   toUtc
 };

package/dist/toZonedTime.d.ts

@@ -1,8 +1,8 @@
 import { Temporal } from '@js-temporal/polyfill';
 /**
- * Convert a UTC ISO string, Instant, or ZonedDateTime to a ZonedDateTime in the specified timezone.
+ * Convert a UTC ISO string, Date, Instant, or ZonedDateTime to a ZonedDateTime in the specified timezone.
  *
- * @param input - A UTC ISO 8601 string, Temporal.Instant, or Temporal.ZonedDateTime
+ * @param input - A UTC ISO 8601 string, Date object, Temporal.Instant, or Temporal.ZonedDateTime
  * @param timezone - IANA timezone identifier (e.g., "America/New_York", "Europe/London")
  * @returns A Temporal.ZonedDateTime in the specified timezone
  *
@@ -12,14 +12,18 @@ import { Temporal } from '@js-temporal/polyfill';
  * const zoned = toZonedTime("2025-01-20T20:00:00.000Z", "America/New_York");
  * // zoned.hour === 15 (3 PM in New York)
  *
+ * // From Date (e.g., from Drizzle ORM)
+ * const date = new Date("2025-01-20T20:00:00.000Z");
+ * const zoned2 = toZonedTime(date, "America/New_York");
+ *
  * // From Instant
  * const instant = Temporal.Instant.from("2025-01-20T20:00:00Z");
- * const zoned2 = toZonedTime(instant, "Asia/Tokyo");
+ * const zoned3 = toZonedTime(instant, "Asia/Tokyo");
  *
  * // From ZonedDateTime (convert to different timezone)
  * const nyTime = Temporal.ZonedDateTime.from("2025-01-20T15:00:00-05:00[America/New_York]");
  * const tokyoTime = toZonedTime(nyTime, "Asia/Tokyo");
  * ```
  */
-export declare function toZonedTime(input: string | Temporal.Instant | Temporal.ZonedDateTime, timezone: string): Temporal.ZonedDateTime;
+export declare function toZonedTime(input: string | Date | Temporal.Instant | Temporal.ZonedDateTime, timezone: string): Temporal.ZonedDateTime;
 //# sourceMappingURL=toZonedTime.d.ts.map

package/dist/toZonedTime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toZonedTime.d.ts","sourceRoot":"","sources":["../src/toZonedTime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EACzD,QAAQ,EAAE,MAAM,GACf,QAAQ,CAAC,aAAa,CAUxB"}
+{"version":3,"file":"toZonedTime.d.ts","sourceRoot":"","sources":["../src/toZonedTime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChE,QAAQ,EAAE,MAAM,GACf,QAAQ,CAAC,aAAa,CAcxB"}

package/dist/toZonedTime.js

@@ -1,6 +1,6 @@
 import {
   toZonedTime
-} from "./chunk-KD5GEHUA.js";
+} from "./chunk-2MP3ESL7.js";
 export {
   toZonedTime
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gobrand/tiempo",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "Lightweight utility functions for converting between UTC and timezone-aware datetimes using the Temporal API",
   "private": false,
   "publishConfig": {

package/dist/chunk-GPAFAHKJ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/toUtc.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\n\n/**\n * Convert a UTC ISO string or ZonedDateTime to a Temporal.Instant (UTC).\n *\n * @param input - A UTC ISO 8601 string or Temporal.ZonedDateTime\n * @returns A Temporal.Instant representing the same moment in UTC\n *\n * @example\n * ```typescript\n * // From ISO string\n * const instant = toUtc(\"2025-01-20T20:00:00.000Z\");\n *\n * // From ZonedDateTime\n * const zoned = Temporal.ZonedDateTime.from(\"2025-01-20T15:00:00-05:00[America/New_York]\");\n * const instant2 = toUtc(zoned);\n * // Both represent the same UTC moment: 2025-01-20T20:00:00Z\n * ```\n */\nexport function toUtc(\n  input: string | Temporal.ZonedDateTime\n): Temporal.Instant {\n  if (typeof input === 'string') {\n    return Temporal.Instant.from(input);\n  }\n\n  return input.toInstant();\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAmBlB,SAAS,MACd,OACkB;AAClB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,SAAS,QAAQ,KAAK,KAAK;AAAA,EACpC;AAEA,SAAO,MAAM,UAAU;AACzB;","names":[]}

package/dist/chunk-KD5GEHUA.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/toZonedTime.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\n\n/**\n * Convert a UTC ISO string, Instant, or ZonedDateTime to a ZonedDateTime in the specified timezone.\n *\n * @param input - A UTC ISO 8601 string, Temporal.Instant, or Temporal.ZonedDateTime\n * @param timezone - IANA timezone identifier (e.g., \"America/New_York\", \"Europe/London\")\n * @returns A Temporal.ZonedDateTime in the specified timezone\n *\n * @example\n * ```typescript\n * // From ISO string\n * const zoned = toZonedTime(\"2025-01-20T20:00:00.000Z\", \"America/New_York\");\n * // zoned.hour === 15 (3 PM in New York)\n *\n * // From Instant\n * const instant = Temporal.Instant.from(\"2025-01-20T20:00:00Z\");\n * const zoned2 = toZonedTime(instant, \"Asia/Tokyo\");\n *\n * // From ZonedDateTime (convert to different timezone)\n * const nyTime = Temporal.ZonedDateTime.from(\"2025-01-20T15:00:00-05:00[America/New_York]\");\n * const tokyoTime = toZonedTime(nyTime, \"Asia/Tokyo\");\n * ```\n */\nexport function toZonedTime(\n  input: string | Temporal.Instant | Temporal.ZonedDateTime,\n  timezone: string\n): Temporal.ZonedDateTime {\n  if (typeof input === 'string') {\n    return Temporal.Instant.from(input).toZonedDateTimeISO(timezone);\n  }\n\n  if (input instanceof Temporal.Instant) {\n    return input.toZonedDateTimeISO(timezone);\n  }\n\n  return input.toInstant().toZonedDateTimeISO(timezone);\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAwBlB,SAAS,YACd,OACA,UACwB;AACxB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,SAAS,QAAQ,KAAK,KAAK,EAAE,mBAAmB,QAAQ;AAAA,EACjE;AAEA,MAAI,iBAAiB,SAAS,SAAS;AACrC,WAAO,MAAM,mBAAmB,QAAQ;AAAA,EAC1C;AAEA,SAAO,MAAM,UAAU,EAAE,mBAAmB,QAAQ;AACtD;","names":[]}