chronokinesis 5.0.2 → 6.0.0

package/README.md

@@ -13,11 +13,12 @@ Mock time and date for traveling and freezing. Inspired and borrowed from [timek
   - [`defrost()`](#defrost)
   - [`reset()`](#reset)
   - [`isKeepingTime()`](#iskeepingtime)
-  - [`timezone(timeZone)`](#timezonetimezone)
-    - [timezone `freeze([...args])`](#timezone-freezeargs)
-    - [timezone `travel([...args])`](#timezone-travelargs)
-    - [timezone `reset()`](#timezone-reset)
-    - [timezone `defrost()`](#timezone-defrost)
+  - [`timezone(timeZone[, ...args])`](#timezonetimezone-args)
+  - [`new TimeZoneTraveller(timeZone)`](#new-timezonetravellertimezone)
+    - [`timezone.freeze([...args])`](#timezonefreezeargs)
+    - [`timezone.travel([...args])`](#timezonetravelargs)
+    - [`timezone.reset()`](#timezonereset)
+    - [`timezone.defrost()`](#timezonedefrost)
 - [Distributions](#distributions)
   - [Nodejs require](#nodejs-require)
   - [Browser (UMD)](#browser-umd)
@@ -167,31 +168,51 @@ ck.travel(1893448800000);
 console.log(ck.isKeepingTime() ? 'Is' : 'Not', 'keeping time');
 ```
 
-## `timezone(timeZone)`
+## `timezone(timeZone[, ...args])`
 
-Freeze and travel in different time zones.
+Travel to time zone.
+
+- `timeZone`: IANA time zone string
+- `...args`: Optional travel to date arguments
+
+Returns [`TimeZoneTraveller` api](#new-timezonetravellertimezone)
 
 ```javascript
 import * as ck from 'chronokinesis';
 
 const tz = ck.timezone('Asia/Shanghai');
 
+// Now in Shanghai
+console.log(new Date())
+
 tz.freeze();
 ```
 
-### timezone `freeze([...args])`
+## `new TimeZoneTraveller(timeZone)`
+
+Time zone traveller api.
+
+```javascript
+import {TimeZoneTraveller} from 'chronokinesis';
+
+const timezone = new TimeZoneTraveller('Asia/Shanghai');
+
+timezone.freeze();
+```
+
+### `timezone.freeze([...args])`
 
 Freeze at the specific timezone.
 
-### timezone `travel([...args])`
+### `timezone.travel([...args])`
 
 Start traveling in the specific timezone.
 
-### timezone `reset()`
+### `timezone.reset()`
 
 Same as [#reset](#reset)
 
-### timezone `defrost()`
+### `timezone.defrost()`
 
 Same as [#defrost](#defrost)
 

package/dist/chronokinesis.cjs

@@ -33,7 +33,7 @@
         const curr = nativeGetTimezoneOffset.call(this);
         if (!iana) return curr;
 
-        const tz = timezone(iana).getTime(this);
+        const tz = new TimeZoneTraveller(iana).getTime(this);
         return Math.round((tz - this.getTime()) / 60000) + curr;
       },
     });
@@ -46,7 +46,7 @@
 
   FakeDate.prototype = NativeDate.prototype;
 
-  FakeDate.now = function() {
+  FakeDate.now = function fakeNow() {
     if (freezedAt) return freezedAt.getTime();
     return time();
   };
@@ -95,7 +95,8 @@
     return Date === FakeDate;
   }
 
-  function timezone(timeZone) {
+  function TimeZoneTraveller(timeZone) {
+    this.timeZone = timeZone;
     const options = {
       year: 'numeric',
       month: 'numeric',
@@ -105,44 +106,43 @@
       second: 'numeric',
       hour12: false,
     };
-
-    const current = Intl.DateTimeFormat('UTC', options);
-    const formatter = Intl.DateTimeFormat('UTC', {
-      timeZone: timeZone,
+    this.localFormatter = Intl.DateTimeFormat('UTC', options);
+    this.timeZoneFormatter = Intl.DateTimeFormat('UTC', {
+      timeZone,
       ...options,
     });
+  }
 
-    return {
-      timeZone,
-      defrost,
-      reset,
-      isKeepingTime,
-      getTime,
-      freeze: freezeInTimezone,
-      travel: travelInTimezone,
-    };
+  TimeZoneTraveller.prototype.defrost = defrost;
+  TimeZoneTraveller.prototype.reset = reset;
+  TimeZoneTraveller.prototype.isKeepingTime = isKeepingTime;
 
-    function freezeInTimezone(...args) {
-      if (!args.length && iana === timeZone) return freeze();
-      iana = timeZone;
-      return freeze(getTime(...args));
-    }
+  TimeZoneTraveller.prototype.getTime = function timeZoneGetTime(...args) {
+    const realDate = instantiate(Date, args);
+    const tz = new NativeDate(toUTC(this.timeZoneFormatter, realDate));
 
-    function travelInTimezone(...args) {
-      if (!args.length && iana === timeZone) return travel();
-      iana = timeZone;
-      return travel(getTime(...args));
-    }
+    if (!args.length) return tz.getTime();
+    const currentTz = new NativeDate(toUTC(this.localFormatter, realDate));
+
+    return realDate.getTime() + currentTz.getTime() - tz.getTime();
+  };
 
-    function getTime(...args) {
-      const realDate = instantiate(Date, args);
-      const tz = new NativeDate(toUTC(formatter, realDate));
+  TimeZoneTraveller.prototype.freeze = function freezeInTimezone(...args) {
+    if (!args.length && iana === this.timeZone) return freeze();
+    iana = this.timeZone;
+    return freeze(this.getTime(...args));
+  };
 
-      if (!args.length) return tz.getTime();
-      const currentTz = new NativeDate(toUTC(current, realDate));
+  TimeZoneTraveller.prototype.travel = function timeZoneTravel(...args) {
+    if (!args.length && iana === this.timeZone) return travel();
+    iana = this.timeZone;
+    return travel(this.getTime(...args));
+  };
 
-      return realDate.getTime() + currentTz.getTime() - tz.getTime();
-    }
+  function timezone(timeZone, ...args) {
+    const tz = new TimeZoneTraveller(timeZone);
+    tz.travel(...args);
+    return tz;
   }
 
   function useFakeDate() {
@@ -192,6 +192,7 @@
     return NativeDate.UTC(year, month, day, hour, minute, second, dt.getMilliseconds());
   }
 
+  exports.TimeZoneTraveller = TimeZoneTraveller;
   exports.defrost = defrost;
   exports.freeze = freeze;
   exports.isKeepingTime = isKeepingTime;

package/dist/index.cjs

@@ -29,7 +29,7 @@ function FakeDate(...args) {
       const curr = nativeGetTimezoneOffset.call(this);
       if (!iana) return curr;
 
-      const tz = timezone(iana).getTime(this);
+      const tz = new TimeZoneTraveller(iana).getTime(this);
       return Math.round((tz - this.getTime()) / 60000) + curr;
     },
   });
@@ -42,7 +42,7 @@ FakeDate.parse = NativeDate.parse;
 
 FakeDate.prototype = NativeDate.prototype;
 
-FakeDate.now = function() {
+FakeDate.now = function fakeNow() {
   if (freezedAt) return freezedAt.getTime();
   return time();
 };
@@ -91,7 +91,8 @@ function isKeepingTime() {
   return Date === FakeDate;
 }
 
-function timezone(timeZone) {
+function TimeZoneTraveller(timeZone) {
+  this.timeZone = timeZone;
   const options = {
     year: 'numeric',
     month: 'numeric',
@@ -101,44 +102,43 @@ function timezone(timeZone) {
     second: 'numeric',
     hour12: false,
   };
-
-  const current = Intl.DateTimeFormat('UTC', options);
-  const formatter = Intl.DateTimeFormat('UTC', {
-    timeZone: timeZone,
+  this.localFormatter = Intl.DateTimeFormat('UTC', options);
+  this.timeZoneFormatter = Intl.DateTimeFormat('UTC', {
+    timeZone,
     ...options,
   });
+}
 
-  return {
-    timeZone,
-    defrost,
-    reset,
-    isKeepingTime,
-    getTime,
-    freeze: freezeInTimezone,
-    travel: travelInTimezone,
-  };
+TimeZoneTraveller.prototype.defrost = defrost;
+TimeZoneTraveller.prototype.reset = reset;
+TimeZoneTraveller.prototype.isKeepingTime = isKeepingTime;
 
-  function freezeInTimezone(...args) {
-    if (!args.length && iana === timeZone) return freeze();
-    iana = timeZone;
-    return freeze(getTime(...args));
-  }
+TimeZoneTraveller.prototype.getTime = function timeZoneGetTime(...args) {
+  const realDate = instantiate(Date, args);
+  const tz = new NativeDate(toUTC(this.timeZoneFormatter, realDate));
 
-  function travelInTimezone(...args) {
-    if (!args.length && iana === timeZone) return travel();
-    iana = timeZone;
-    return travel(getTime(...args));
-  }
+  if (!args.length) return tz.getTime();
+  const currentTz = new NativeDate(toUTC(this.localFormatter, realDate));
+
+  return realDate.getTime() + currentTz.getTime() - tz.getTime();
+};
 
-  function getTime(...args) {
-    const realDate = instantiate(Date, args);
-    const tz = new NativeDate(toUTC(formatter, realDate));
+TimeZoneTraveller.prototype.freeze = function freezeInTimezone(...args) {
+  if (!args.length && iana === this.timeZone) return freeze();
+  iana = this.timeZone;
+  return freeze(this.getTime(...args));
+};
 
-    if (!args.length) return tz.getTime();
-    const currentTz = new NativeDate(toUTC(current, realDate));
+TimeZoneTraveller.prototype.travel = function timeZoneTravel(...args) {
+  if (!args.length && iana === this.timeZone) return travel();
+  iana = this.timeZone;
+  return travel(this.getTime(...args));
+};
 
-    return realDate.getTime() + currentTz.getTime() - tz.getTime();
-  }
+function timezone(timeZone, ...args) {
+  const tz = new TimeZoneTraveller(timeZone);
+  tz.travel(...args);
+  return tz;
 }
 
 function useFakeDate() {
@@ -188,6 +188,7 @@ function toUTC(formatter, dt) {
   return NativeDate.UTC(year, month, day, hour, minute, second, dt.getMilliseconds());
 }
 
+exports.TimeZoneTraveller = TimeZoneTraveller;
 exports.defrost = defrost;
 exports.freeze = freeze;
 exports.isKeepingTime = isKeepingTime;

package/index.d.ts

@@ -25,8 +25,13 @@ export function isKeepingTime(): boolean;
 /**
  * Timezone traveling
  */
-interface TimezoneTraveling {
-  /** Timezone */
+export class TimeZoneTraveller {
+  /**
+   *
+   * @param timeZone IANA time zone
+   */
+  constructor(timeZone: string);
+  /** IANA time zone */
   readonly timeZone: string;
   defrost: typeof defrost;
   reset: typeof reset;
@@ -38,11 +43,12 @@ interface TimezoneTraveling {
    * @param args Same arguments as Date constructor.
    * @returns number of milliseconds since the epoch (January 1, 1970, UTC)
    */
-  getTime: (...args: any[]) => number;
+  getTime(...args: any[]): number;
 }
 
 /**
- * Freeze and travel in different time zones.
- * @param timeZone
+ * Travel to time zone.
+ * @param timeZone IANA time zone
+ * @param args Optional travel to date arguments
  */
-export function timezone(timeZone: string): TimezoneTraveling;
+export function timezone(timeZone: string, ...args: any[]): TimeZoneTraveller;

package/index.js

@@ -27,7 +27,7 @@ function FakeDate(...args) {
       const curr = nativeGetTimezoneOffset.call(this);
       if (!iana) return curr;
 
-      const tz = timezone(iana).getTime(this);
+      const tz = new TimeZoneTraveller(iana).getTime(this);
       return Math.round((tz - this.getTime()) / 60000) + curr;
     },
   });
@@ -40,7 +40,7 @@ FakeDate.parse = NativeDate.parse;
 
 FakeDate.prototype = NativeDate.prototype;
 
-FakeDate.now = function() {
+FakeDate.now = function fakeNow() {
   if (freezedAt) return freezedAt.getTime();
   return time();
 };
@@ -89,7 +89,8 @@ export function isKeepingTime() {
   return Date === FakeDate;
 }
 
-export function timezone(timeZone) {
+export function TimeZoneTraveller(timeZone) {
+  this.timeZone = timeZone;
   const options = {
     year: 'numeric',
     month: 'numeric',
@@ -99,44 +100,43 @@ export function timezone(timeZone) {
     second: 'numeric',
     hour12: false,
   };
-
-  const current = Intl.DateTimeFormat('UTC', options);
-  const formatter = Intl.DateTimeFormat('UTC', {
-    timeZone: timeZone,
+  this.localFormatter = Intl.DateTimeFormat('UTC', options);
+  this.timeZoneFormatter = Intl.DateTimeFormat('UTC', {
+    timeZone,
     ...options,
   });
+}
 
-  return {
-    timeZone,
-    defrost,
-    reset,
-    isKeepingTime,
-    getTime,
-    freeze: freezeInTimezone,
-    travel: travelInTimezone,
-  };
+TimeZoneTraveller.prototype.defrost = defrost;
+TimeZoneTraveller.prototype.reset = reset;
+TimeZoneTraveller.prototype.isKeepingTime = isKeepingTime;
 
-  function freezeInTimezone(...args) {
-    if (!args.length && iana === timeZone) return freeze();
-    iana = timeZone;
-    return freeze(getTime(...args));
-  }
+TimeZoneTraveller.prototype.getTime = function timeZoneGetTime(...args) {
+  const realDate = instantiate(Date, args);
+  const tz = new NativeDate(toUTC(this.timeZoneFormatter, realDate));
 
-  function travelInTimezone(...args) {
-    if (!args.length && iana === timeZone) return travel();
-    iana = timeZone;
-    return travel(getTime(...args));
-  }
+  if (!args.length) return tz.getTime();
+  const currentTz = new NativeDate(toUTC(this.localFormatter, realDate));
+
+  return realDate.getTime() + currentTz.getTime() - tz.getTime();
+};
 
-  function getTime(...args) {
-    const realDate = instantiate(Date, args);
-    const tz = new NativeDate(toUTC(formatter, realDate));
+TimeZoneTraveller.prototype.freeze = function freezeInTimezone(...args) {
+  if (!args.length && iana === this.timeZone) return freeze();
+  iana = this.timeZone;
+  return freeze(this.getTime(...args));
+};
 
-    if (!args.length) return tz.getTime();
-    const currentTz = new NativeDate(toUTC(current, realDate));
+TimeZoneTraveller.prototype.travel = function timeZoneTravel(...args) {
+  if (!args.length && iana === this.timeZone) return travel();
+  iana = this.timeZone;
+  return travel(this.getTime(...args));
+};
 
-    return realDate.getTime() + currentTz.getTime() - tz.getTime();
-  }
+export function timezone(timeZone, ...args) {
+  const tz = new TimeZoneTraveller(timeZone);
+  tz.travel(...args);
+  return tz;
 }
 
 function useFakeDate() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chronokinesis",
-  "version": "5.0.2",
+  "version": "6.0.0",
   "description": "Module for testing time-dependent code",
   "author": {
     "name": "Pål Edman",
@@ -22,6 +22,7 @@
     "test": "mocha",
     "lint": "eslint . --cache",
     "test:lcov": "c8 -r lcov -r text mocha && npm run lint",
+    "cov:html": "c8 mocha -R dot && c8 report --reporter html",
     "posttest": "npm run lint && npm run dist",
     "prepack": "npm run dist",
     "dist": "npm run toc && rollup -c"
@@ -48,14 +49,14 @@
     "fake now"
   ],
   "devDependencies": {
-    "@rollup/plugin-commonjs": "^24.0.1",
-    "c8": "^7.12.0",
+    "@rollup/plugin-commonjs": "^25.0.3",
+    "c8": "^8.0.1",
     "chai": "^4.3.7",
-    "eslint": "^8.29.0",
+    "eslint": "^8.46.0",
     "lodash.clonedeep": "^4.5.0",
     "markdown-toc": "^1.2.0",
     "mocha": "^10.1.0",
     "moment": "^2.29.4",
-    "rollup": "^3.7.0"
+    "rollup": "^3.27.2"
   }
 }