@thi.ng/date 2.1.5 → 2.2.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2022-03-11T12:13:49Z
+- **Last updated**: 2022-05-18T12:59:20Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,18 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [2.2.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/date@2.2.0) (2022-05-18)
+
+#### 🚀 Features
+
+- use current time as default for all formatters ([ee536db](https://github.com/thi-ng/umbrella/commit/ee536db))
+
+### [2.1.6](https://github.com/thi-ng/umbrella/tree/@thi.ng/date@2.1.6) (2022-04-07)
+
+#### ♻️ Refactoring
+
+- replace deprecated .substr() w/ .substring() ([0710509](https://github.com/thi-ng/umbrella/commit/0710509))
+
 ## [2.1.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/date@2.1.0) (2021-11-17)
 
 #### 🚀 Features

package/format.d.ts

@@ -7,6 +7,9 @@ export declare const FORMATTERS: Record<string, FormatFn>;
  * instead of local time (default).
  *
  * @remarks
+ * If no date is given to the returned formatter, `Date.now()` will be used by
+ * default.
+ *
  * See {@link FORMATTERS} for available date component format IDs. To escape a
  * formatter and use as a string literal, prefix the term with `\\`.
  *
@@ -23,56 +26,56 @@ export declare const FORMATTERS: Record<string, FormatFn>;
  *
  * @param fmt -
  */
-export declare const defFormat: (fmt: (string | FormatFn)[]) => (x: MaybeDate, utc?: boolean) => string;
+export declare const defFormat: (fmt: (string | FormatFn)[]) => (x?: MaybeDate, utc?: boolean) => string;
 /**
  * Format preset, e.g. `2020-09-19`
  */
-export declare const FMT_yyyyMMdd: (x: MaybeDate, utc?: boolean) => string;
+export declare const FMT_yyyyMMdd: (x?: MaybeDate, utc?: boolean) => string;
 /**
  * Format preset, e.g. `9/19/2020`
  */
-export declare const FMT_Mdyyyy: (x: MaybeDate, utc?: boolean) => string;
+export declare const FMT_Mdyyyy: (x?: MaybeDate, utc?: boolean) => string;
 /**
  * Format preset, e.g. `Sep 19 2020`. Uses current `LOCALE`, see
  * {@link setLocale}.
  */
-export declare const FMT_MMMdyyyy: (x: MaybeDate, utc?: boolean) => string;
+export declare const FMT_MMMdyyyy: (x?: MaybeDate, utc?: boolean) => string;
 /**
  * Format preset, e.g. `19.9.2020`
  */
-export declare const FMT_dMyyyy: (x: MaybeDate, utc?: boolean) => string;
+export declare const FMT_dMyyyy: (x?: MaybeDate, utc?: boolean) => string;
 /**
  * Format preset, e.g. `19 Sep 2020`
  */
-export declare const FMT_dMMMyyyy: (x: MaybeDate, utc?: boolean) => string;
+export declare const FMT_dMMMyyyy: (x?: MaybeDate, utc?: boolean) => string;
 /**
  * Format preset, e.g. `17:08`
  */
-export declare const FMT_HHmm: (x: MaybeDate, utc?: boolean) => string;
+export declare const FMT_HHmm: (x?: MaybeDate, utc?: boolean) => string;
 /**
  * Format preset, e.g. `5:08 PM`
  */
-export declare const FMT_hm: (x: MaybeDate, utc?: boolean) => string;
+export declare const FMT_hm: (x?: MaybeDate, utc?: boolean) => string;
 /**
  * Format preset, e.g. `17:08:01`
  */
-export declare const FMT_HHmmss: (x: MaybeDate, utc?: boolean) => string;
+export declare const FMT_HHmmss: (x?: MaybeDate, utc?: boolean) => string;
 /**
  * Format preset, e.g. `5:08:01 PM`
  */
-export declare const FMT_hms: (x: MaybeDate, utc?: boolean) => string;
+export declare const FMT_hms: (x?: MaybeDate, utc?: boolean) => string;
 /**
  * Format preset, e.g. `20200919-170801`
  */
-export declare const FMT_yyyyMMdd_HHmmss: (x: MaybeDate, utc?: boolean) => string;
+export declare const FMT_yyyyMMdd_HHmmss: (x?: MaybeDate, utc?: boolean) => string;
 /**
  * ISO8601 format preset (without millisecond term), e.g.
  * `2020-09-19T17:08:01Z`
  */
-export declare const FMT_ISO_SHORT: (x: MaybeDate, utc?: boolean) => string;
+export declare const FMT_ISO_SHORT: (x?: MaybeDate, utc?: boolean) => string;
 /**
  * ISO8601 format preset (with millisecond term), e.g.
  * `2020-09-19T17:08:01.123Z`
  */
-export declare const FMT_ISO: (x: MaybeDate, utc?: boolean) => string;
+export declare const FMT_ISO: (x?: MaybeDate, utc?: boolean) => string;
 //# sourceMappingURL=format.d.ts.map

package/format.js

@@ -148,6 +148,9 @@ export const FORMATTERS = {
  * instead of local time (default).
  *
  * @remarks
+ * If no date is given to the returned formatter, `Date.now()` will be used by
+ * default.
+ *
  * See {@link FORMATTERS} for available date component format IDs. To escape a
  * formatter and use as a string literal, prefix the term with `\\`.
  *
@@ -164,7 +167,7 @@ export const FORMATTERS = {
  *
  * @param fmt -
  */
-export const defFormat = (fmt) => (x, utc = false) => {
+export const defFormat = (fmt) => (x = Date.now(), utc = false) => {
     let d = ensureDate(x);
     utc && (d = new Date(d.getTime() + d.getTimezoneOffset() * MINUTE));
     return fmt
@@ -172,7 +175,7 @@ export const defFormat = (fmt) => (x, utc = false) => {
         let fn;
         return isString(x)
             ? x.startsWith("\\")
-                ? x.substr(1)
+                ? x.substring(1)
                 : (fn = FORMATTERS[x])
                     ? fn(d, utc)
                     : x

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/date",
-  "version": "2.1.5",
+  "version": "2.2.0",
   "description": "Datetime types, relative dates, math, iterators, composable formatters, locales",
   "type": "module",
   "module": "./index.js",
@@ -34,17 +34,17 @@
     "test": "testament test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.3.4",
-    "@thi.ng/checks": "^3.1.4",
-    "@thi.ng/strings": "^3.3.2"
+    "@thi.ng/api": "^8.3.6",
+    "@thi.ng/checks": "^3.1.6",
+    "@thi.ng/strings": "^3.3.4"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.19.4",
-    "@thi.ng/testament": "^0.2.4",
+    "@microsoft/api-extractor": "^7.23.1",
+    "@thi.ng/testament": "^0.2.6",
     "rimraf": "^3.0.2",
     "tools": "^0.0.1",
-    "typedoc": "^0.22.13",
-    "typescript": "^4.6.2"
+    "typedoc": "^0.22.15",
+    "typescript": "^4.6.4"
   },
   "keywords": [
     "datastructure",
@@ -78,56 +78,56 @@
   ],
   "exports": {
     ".": {
-      "import": "./index.js"
+      "default": "./index.js"
     },
     "./api": {
-      "import": "./api.js"
+      "default": "./api.js"
     },
     "./checks": {
-      "import": "./checks.js"
+      "default": "./checks.js"
     },
     "./datetime": {
-      "import": "./datetime.js"
+      "default": "./datetime.js"
     },
     "./format": {
-      "import": "./format.js"
+      "default": "./format.js"
     },
     "./i18n/de": {
-      "import": "./i18n/de.js"
+      "default": "./i18n/de.js"
     },
     "./i18n/en": {
-      "import": "./i18n/en.js"
+      "default": "./i18n/en.js"
     },
     "./i18n/es": {
-      "import": "./i18n/es.js"
+      "default": "./i18n/es.js"
     },
     "./i18n/fr": {
-      "import": "./i18n/fr.js"
+      "default": "./i18n/fr.js"
     },
     "./i18n/it": {
-      "import": "./i18n/it.js"
+      "default": "./i18n/it.js"
     },
     "./i18n": {
-      "import": "./i18n.js"
+      "default": "./i18n.js"
     },
     "./iterators": {
-      "import": "./iterators.js"
+      "default": "./iterators.js"
     },
     "./relative": {
-      "import": "./relative.js"
+      "default": "./relative.js"
     },
     "./round": {
-      "import": "./round.js"
+      "default": "./round.js"
     },
     "./timecode": {
-      "import": "./timecode.js"
+      "default": "./timecode.js"
     },
     "./units": {
-      "import": "./units.js"
+      "default": "./units.js"
     }
   },
   "thi.ng": {
     "year": 2020
   },
-  "gitHead": "0fc692a3225c068aacafdc4cb6140cf603c67ad8\n"
+  "gitHead": "f696c94665a3adef4fa475d99dd2e18ceb15863f\n"
 }

package/relative.js

@@ -77,7 +77,7 @@ const parseNum = (x, past) => (x === "next " || x === "a " || x === "an " ? 1 :
 const parsePeriod = (x) => {
     x =
         x !== "s" && x !== "ms" && x.endsWith("s")
-            ? x.substr(0, x.length - 1)
+            ? x.substring(0, x.length - 1)
             : x;
     return {
         ms: "t",