@valkyriestudios/utils 7.1.0 → 7.2.0

package/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) and this project adheres to [Semantic
 Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [7.2.0] - 2023-06-11
+### Added
+- date/toUnix: Convert a date to its corresponding unix timestamp in seconds (1.000.000 ops in ~300ms)
+- date/diff (supports week,day,hour,minute,millisecond) (1.000.000 ops in ~650ms)
+
+### Improved
+- Dep: Upgrade @babel/cli to 7.22.5
+- Dep: Upgrade @babel/core to 7.22.5
+- Dep: Upgrade @babel/preset-env to 7.22.5
+- Dep: Upgrade @babel/register to 7.22.5
+- Dep: Upgrade eslint to 8.42.0
+
 ## [7.1.0] - 2023-05-13
 ### Added
 - date/addUTC (1.000.000 ops in ~750ms)

package/README.md

@@ -278,9 +278,26 @@ isDate(new Date('December 17, 1995 03:24:00'); // TRUE
 isDate('December 17, 1995 03:24:00'); // FALSE
 ```
 
+- **diff(val_a:Date, val_b:Date, key:String)**
+Take two incoming dates and return the difference between them in a certain unit. Possible key options(week,day,hour,minute,second,millisecond).
+
+Note: Does not touch the passed date objects, if no key is passed will default to millisecond
+```js
+diff(new Date("2022-10-05T13:12:11+02:00"), new Date("2022-11-05T13:12:11+06:00"), 'week'); // -4.404761904761905
+diff(new Date("2022-11-05T13:12:11+06:00"), new Date("2022-10-05T13:12:11+02:00"), 'day'); // 30.83333333333333332
+diff(new Date("2022-11-05T13:12:11+06:00"), new Date("2022-10-05T13:12:11+02:00"), 'hour'); // 740
+diff(new Date("2022-10-05T13:12:11+02:00"), new Date("2022-10-05T17:43:09.344+06:00"), 'minute'); // -30.9724
+diff(new Date("2022-10-05T13:12:11+02:00"), new Date("2022-10-05T17:43:09.344+06:00"), 'second'); // -1858.344
+diff(new Date("2022-10-05T13:12:11+02:00"), new Date("2022-10-05T17:43:09.344+06:00"), 'millisecond'); // -1858344
+diff(new Date("2022-11-05T13:12:11+06:00"), new Date("2022-10-05T13:25:43.898+02:00")); // 2663187102
+```
+
 - **toUTC(val:Date)**
 Takes the passed date object and returns a new date object set for utc
 
+- **toUnix(val:Date)**
+Takes the passed date object and returns its unix timestamp in seconds
+
 - **nowUnix()**
 Returns the current unix timestamp in seconds
 

package/date/diff.js

@@ -0,0 +1,41 @@
+'use strict';
+
+Object.defineProperty(exports, "__esModule", {
+  value: !0
+});
+exports["default"] = diff;
+var _is = _interopRequireDefault(require("./is"));
+var _isNotEmpty = _interopRequireDefault(require("../string/isNotEmpty"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+var SECOND_IN_MILLISECONDS = 1000;
+var MINUTE_IN_MILLISECONDS = SECOND_IN_MILLISECONDS * 60;
+var HOUR_IN_MILLISECONDS = MINUTE_IN_MILLISECONDS * 60;
+var DAY_IN_MILLISECONDS = HOUR_IN_MILLISECONDS * 24;
+var WEEK_IN_MILLISECONDS = DAY_IN_MILLISECONDS * 7;
+function diff(val_a, val_b) {
+  var key = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : !1;
+  if (!(0, _is["default"])(val_a) || !(0, _is["default"])(val_b)) throw new Error('Diff requires date objects for both values');
+  if (key !== !1 && !(0, _isNotEmpty["default"])(key)) throw new Error('Key needs to be a string or false');
+  var diff_in_ms = val_a.valueOf() - val_b.valueOf();
+  switch (key) {
+    case 'week':
+    case 'weeks':
+      return diff_in_ms / WEEK_IN_MILLISECONDS;
+    case 'day':
+    case 'days':
+      return diff_in_ms / DAY_IN_MILLISECONDS;
+    case 'hour':
+    case 'hours':
+      return diff_in_ms / HOUR_IN_MILLISECONDS;
+    case 'minute':
+    case 'minutes':
+      return diff_in_ms / MINUTE_IN_MILLISECONDS;
+    case 'second':
+    case 'seconds':
+      return diff_in_ms / SECOND_IN_MILLISECONDS;
+    case 'millisecond':
+    case 'milliseconds':
+    default:
+      return diff_in_ms;
+  }
+}

package/date/toUnix.js

@@ -0,0 +1,12 @@
+'use strict';
+
+Object.defineProperty(exports, "__esModule", {
+  value: !0
+});
+exports["default"] = toUnix;
+var _is = _interopRequireDefault(require("./is"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+function toUnix(val) {
+  if (!(0, _is["default"])(val)) throw new Error('toUnix requires a date object');
+  return Math.floor(val.valueOf() / 1000);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valkyriestudios/utils",
-  "version": "7.1.0",
+  "version": "7.2.0",
   "description": "A collection of single-function utilities for common tasks",
   "main": "index.js",
   "author": {
@@ -32,10 +32,10 @@
   },
   "homepage": "https://github.com/ValkyrieStudios/utils#readme",
   "devDependencies": {
-    "@babel/cli": "^7.21.5",
-    "@babel/core": "^7.21.8",
-    "@babel/preset-env": "^7.21.5",
-    "@babel/register": "^7.21.0",
+    "@babel/cli": "^7.22.5",
+    "@babel/core": "^7.22.5",
+    "@babel/preset-env": "^7.22.5",
+    "@babel/register": "^7.22.5",
     "babel-plugin-check-es2015-constants": "^6.22.0",
     "babel-plugin-transform-member-expression-literals": "^6.9.4",
     "babel-plugin-transform-minify-booleans": "^6.9.4",
@@ -44,7 +44,7 @@
     "chai": "^4.3.7",
     "chai-as-promised": "^7.1.1",
     "chai-spies": "^1.0.0",
-    "eslint": "^8.40.0",
+    "eslint": "^8.42.0",
     "mocha": "^10.2.0",
     "nyc": "^15.1.0"
   }