chronal 0.0.9 → 0.0.12

package/README.md

@@ -324,9 +324,28 @@ Parses a date string into a Date object using an optional format pattern.
 - `dateString` (string) - The date string to parse
 - `format` (string, optional) - Format pattern (e.g., "YYYY-MM-DD",
   "DD/MM/YYYY")
+- `options` (object, optional) - Parsing options
+  - `tz` (string) - IANA timezone (e.g., 'America/Sao_Paulo')
 
 **Returns:** Date object
 
+**Timezone Behavior:**
+
+When parsing date strings, `parseDate` follows these rules:
+
+1. **Explicit timezone** (e.g., `Z` or `+03:00`) - Always respected, ignores `config.timezone`
+2. **No timezone** - Uses `config.timezone` or the `tz` option to interpret the string as local time in that timezone
+
+```typescript
+// With explicit UTC marker (Z) - always UTC
+parseDate("2026-01-12T02:59:59.999Z"); // UTC time, ignores config
+
+// Without timezone - uses config.timezone
+setChronalConfig({ timezone: "America/Sao_Paulo" });
+parseDate("2026-01-12T02:59:59.999"); // Interpreted as São Paulo time
+parseDate("2026-01-12"); // Midnight in São Paulo
+```
+
 **Supported Tokens:**
 
 - `YYYY` - 4-digit year
@@ -346,6 +365,9 @@ parseDate("2024-06-15"); // Date object
 parseDate("15/06/2024", "DD/MM/YYYY");
 parseDate("2024-06-15 14:30:00", "YYYY-MM-DD HH:mm:ss");
 parseDate("06/15/2024", "MM/DD/YYYY");
+
+// With timezone
+parseDate("2024-06-15", { tz: "America/Sao_Paulo" }); // Parse as São Paulo time
 ```
 
 ### Manipulation

package/esm/core/rtf.d.ts

@@ -0,0 +1,2 @@
+export declare function getRTF(locale: string, numeric: "auto" | "always"): Intl.RelativeTimeFormat;
+//# sourceMappingURL=rtf.d.ts.map

package/esm/core/rtf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtf.d.ts","sourceRoot":"","sources":["../../src/core/rtf.ts"],"names":[],"mappings":"AAEA,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,2BAQhE"}

package/esm/core/rtf.js

@@ -0,0 +1,10 @@
+const rtfCache = new Map();
+export function getRTF(locale, numeric) {
+    const key = `${locale}|${numeric}`;
+    let rtf = rtfCache.get(key);
+    if (!rtf) {
+        rtf = new Intl.RelativeTimeFormat(locale, { numeric });
+        rtfCache.set(key, rtf);
+    }
+    return rtf;
+}

package/esm/lib/from-now.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"from-now.d.ts","sourceRoot":"","sources":["../../src/lib/from-now.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,MAAsB,GAAG,MAAM,CAmC1E"}
+{"version":3,"file":"from-now.d.ts","sourceRoot":"","sources":["../../src/lib/from-now.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,MAAsB,GAAG,MAAM,CAyC1E"}

package/esm/lib/from-now.js

@@ -1,3 +1,4 @@
+import { getRTF } from "../core/rtf.js";
 import { config } from "./config.js";
 /**
  * Returns a string representing how long ago the date was from now.
@@ -25,21 +26,26 @@ export function fromNow(date, locale = config.locale) {
     const minutes = Math.floor(seconds / 60);
     const hours = Math.floor(minutes / 60);
     const days = Math.floor(hours / 24);
+    const weeks = Math.floor(days / 7);
     const months = Math.floor(days / 30);
     const years = Math.floor(days / 365);
-    const rtf = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
+    // Use auto for "now", always for everything else
     if (seconds < 60) {
-        return rtf.format(0, "second");
+        return getRTF(locale, "auto").format(0, "second");
     }
+    const rtf = getRTF(locale, "always");
     if (minutes < 60) {
         return rtf.format(diff < 0 ? minutes : -minutes, "minute");
     }
     if (hours < 24) {
         return rtf.format(diff < 0 ? hours : -hours, "hour");
     }
-    if (days < 30) {
+    if (days < 7) {
         return rtf.format(diff < 0 ? days : -days, "day");
     }
+    if (days < 30) {
+        return rtf.format(diff < 0 ? weeks : -weeks, "week");
+    }
     if (months < 12) {
         return rtf.format(diff < 0 ? months : -months, "month");
     }

package/esm/lib/parse-date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-date.d.ts","sourceRoot":"","sources":["../../src/lib/parse-date.ts"],"names":[],"mappings":"AAGA,KAAK,gBAAgB,GAAG;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GAAG,gBAAgB,GAClC,IAAI,CA0FN"}
+{"version":3,"file":"parse-date.d.ts","sourceRoot":"","sources":["../../src/lib/parse-date.ts"],"names":[],"mappings":"AAGA,KAAK,gBAAgB,GAAG;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GAAG,gBAAgB,GAClC,IAAI,CA6FN"}

package/esm/lib/parse-date.js

@@ -27,8 +27,10 @@ export function parseDate(dateString, options) {
         if (isNaN(date.getTime())) {
             throw new Error("Invalid date");
         }
-        // If timezone is not UTC, interpret the date string as local time in that timezone
-        if (timezone !== "UTC") {
+        // If the string has explicit timezone (Z or offset like +03:00), respect it
+        // Only apply config.timezone for date strings without timezone info
+        const hasExplicitTimezone = /Z|[+-]\d{2}:\d{2}$/.test(dateString);
+        if (!hasExplicitTimezone && timezone !== "UTC") {
             return parseDateInTimezone(date, timezone);
         }
         return date;

package/esm/lib/to-now.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"to-now.d.ts","sourceRoot":"","sources":["../../src/lib/to-now.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,MAAsB,GAAG,MAAM,CAmCxE"}
+{"version":3,"file":"to-now.d.ts","sourceRoot":"","sources":["../../src/lib/to-now.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,MAAsB,GAAG,MAAM,CAyCxE"}

package/esm/lib/to-now.js

@@ -1,3 +1,4 @@
+import { getRTF } from "../core/rtf.js";
 import { config } from "./config.js";
 /**
  * Returns a string representing the time from now to the date.
@@ -26,21 +27,26 @@ export function toNow(date, locale = config.locale) {
     const minutes = Math.floor(seconds / 60);
     const hours = Math.floor(minutes / 60);
     const days = Math.floor(hours / 24);
+    const weeks = Math.floor(days / 7);
     const months = Math.floor(days / 30);
     const years = Math.floor(days / 365);
-    const rtf = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
+    // Use auto for "now", always for everything else
     if (seconds < 60) {
-        return rtf.format(0, "second");
+        return getRTF(locale, "auto").format(0, "second");
     }
+    const rtf = getRTF(locale, "always");
     if (minutes < 60) {
         return rtf.format(diff > 0 ? minutes : -minutes, "minute");
     }
     if (hours < 24) {
         return rtf.format(diff > 0 ? hours : -hours, "hour");
     }
-    if (days < 30) {
+    if (days < 7) {
         return rtf.format(diff > 0 ? days : -days, "day");
     }
+    if (days < 30) {
+        return rtf.format(diff > 0 ? weeks : -weeks, "week");
+    }
     if (months < 12) {
         return rtf.format(diff > 0 ? months : -months, "month");
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chronal",
-  "version": "0.0.9",
+  "version": "0.0.12",
   "description": "A tiny and fast date utility library for modern JavaScript runtimes.",
   "keywords": [
     "date",

package/script/core/rtf.d.ts

@@ -0,0 +1,2 @@
+export declare function getRTF(locale: string, numeric: "auto" | "always"): Intl.RelativeTimeFormat;
+//# sourceMappingURL=rtf.d.ts.map

package/script/core/rtf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtf.d.ts","sourceRoot":"","sources":["../../src/core/rtf.ts"],"names":[],"mappings":"AAEA,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,2BAQhE"}

package/script/core/rtf.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRTF = getRTF;
+const rtfCache = new Map();
+function getRTF(locale, numeric) {
+    const key = `${locale}|${numeric}`;
+    let rtf = rtfCache.get(key);
+    if (!rtf) {
+        rtf = new Intl.RelativeTimeFormat(locale, { numeric });
+        rtfCache.set(key, rtf);
+    }
+    return rtf;
+}

package/script/lib/from-now.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"from-now.d.ts","sourceRoot":"","sources":["../../src/lib/from-now.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,MAAsB,GAAG,MAAM,CAmC1E"}
+{"version":3,"file":"from-now.d.ts","sourceRoot":"","sources":["../../src/lib/from-now.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,MAAsB,GAAG,MAAM,CAyC1E"}

package/script/lib/from-now.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fromNow = fromNow;
+const rtf_js_1 = require("../core/rtf.js");
 const config_js_1 = require("./config.js");
 /**
  * Returns a string representing how long ago the date was from now.
@@ -28,21 +29,26 @@ function fromNow(date, locale = config_js_1.config.locale) {
     const minutes = Math.floor(seconds / 60);
     const hours = Math.floor(minutes / 60);
     const days = Math.floor(hours / 24);
+    const weeks = Math.floor(days / 7);
     const months = Math.floor(days / 30);
     const years = Math.floor(days / 365);
-    const rtf = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
+    // Use auto for "now", always for everything else
     if (seconds < 60) {
-        return rtf.format(0, "second");
+        return (0, rtf_js_1.getRTF)(locale, "auto").format(0, "second");
     }
+    const rtf = (0, rtf_js_1.getRTF)(locale, "always");
     if (minutes < 60) {
         return rtf.format(diff < 0 ? minutes : -minutes, "minute");
     }
     if (hours < 24) {
         return rtf.format(diff < 0 ? hours : -hours, "hour");
     }
-    if (days < 30) {
+    if (days < 7) {
         return rtf.format(diff < 0 ? days : -days, "day");
     }
+    if (days < 30) {
+        return rtf.format(diff < 0 ? weeks : -weeks, "week");
+    }
     if (months < 12) {
         return rtf.format(diff < 0 ? months : -months, "month");
     }

package/script/lib/parse-date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-date.d.ts","sourceRoot":"","sources":["../../src/lib/parse-date.ts"],"names":[],"mappings":"AAGA,KAAK,gBAAgB,GAAG;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GAAG,gBAAgB,GAClC,IAAI,CA0FN"}
+{"version":3,"file":"parse-date.d.ts","sourceRoot":"","sources":["../../src/lib/parse-date.ts"],"names":[],"mappings":"AAGA,KAAK,gBAAgB,GAAG;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GAAG,gBAAgB,GAClC,IAAI,CA6FN"}

package/script/lib/parse-date.js

@@ -30,8 +30,10 @@ function parseDate(dateString, options) {
         if (isNaN(date.getTime())) {
             throw new Error("Invalid date");
         }
-        // If timezone is not UTC, interpret the date string as local time in that timezone
-        if (timezone !== "UTC") {
+        // If the string has explicit timezone (Z or offset like +03:00), respect it
+        // Only apply config.timezone for date strings without timezone info
+        const hasExplicitTimezone = /Z|[+-]\d{2}:\d{2}$/.test(dateString);
+        if (!hasExplicitTimezone && timezone !== "UTC") {
             return parseDateInTimezone(date, timezone);
         }
         return date;

package/script/lib/to-now.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"to-now.d.ts","sourceRoot":"","sources":["../../src/lib/to-now.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,MAAsB,GAAG,MAAM,CAmCxE"}
+{"version":3,"file":"to-now.d.ts","sourceRoot":"","sources":["../../src/lib/to-now.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,MAAsB,GAAG,MAAM,CAyCxE"}

package/script/lib/to-now.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toNow = toNow;
+const rtf_js_1 = require("../core/rtf.js");
 const config_js_1 = require("./config.js");
 /**
  * Returns a string representing the time from now to the date.
@@ -29,21 +30,26 @@ function toNow(date, locale = config_js_1.config.locale) {
     const minutes = Math.floor(seconds / 60);
     const hours = Math.floor(minutes / 60);
     const days = Math.floor(hours / 24);
+    const weeks = Math.floor(days / 7);
     const months = Math.floor(days / 30);
     const years = Math.floor(days / 365);
-    const rtf = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
+    // Use auto for "now", always for everything else
     if (seconds < 60) {
-        return rtf.format(0, "second");
+        return (0, rtf_js_1.getRTF)(locale, "auto").format(0, "second");
     }
+    const rtf = (0, rtf_js_1.getRTF)(locale, "always");
     if (minutes < 60) {
         return rtf.format(diff > 0 ? minutes : -minutes, "minute");
     }
     if (hours < 24) {
         return rtf.format(diff > 0 ? hours : -hours, "hour");
     }
-    if (days < 30) {
+    if (days < 7) {
         return rtf.format(diff > 0 ? days : -days, "day");
     }
+    if (days < 30) {
+        return rtf.format(diff > 0 ? weeks : -weeks, "week");
+    }
     if (months < 12) {
         return rtf.format(diff > 0 ? months : -months, "month");
     }