@thi.ng/date 2.6.0 → 2.7.1

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-02-22T11:59:16Z
+- **Last updated**: 2024-02-25T14:07:53Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,12 @@ 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.7.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/date@2.7.0) (2024-02-22)
+
+#### 🚀 Features
+
+- add single component formatter presets ([661a4b7](https://github.com/thi-ng/umbrella/commit/661a4b7))
+
 ## [2.6.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/date@2.6.0) (2024-02-22)
 
 #### 🚀 Features

package/README.md

@@ -73,7 +73,7 @@ For Node.js REPL:
 const date = await import("@thi.ng/date");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 5.38 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 5.43 KB
 
 ## Dependencies
 

package/duration.d.ts

@@ -12,6 +12,8 @@ export declare const decomposeDuration: (dur: number) => number[];
  *
  * @example
  * ```ts
+ * import { composeDuration } from "@thi.ng/date";
+ *
  * composeDuration({ h: 12, m: 34, s: 56 })
  * // 45296000
  * ```
@@ -24,6 +26,7 @@ export declare const composeDuration: (parts: Partial<Record<Precision, number>>
  *
  * @example
  * ```ts
+ * import { durationAs } from "@thi.ng/date";
  * durationAs("d", difference("2023-02-01T12:00:00Z", "2023-01-01"))
  * // 31.5
  * ```

package/format.d.ts

@@ -15,6 +15,8 @@ export declare const FORMATTERS: Record<string, FormatFn>;
  *
  * @example
  * ```ts
+ * import { defFormat } from "@thi.ng/date";
+ *
  * const fmt = defFormat(["yyyy", "-", "MM", "-", "dd"]);
  *
  * fmt(new Date(2015, 3, 23))
@@ -65,7 +67,7 @@ export declare const FMT_hm: (x?: MaybeDate, utc?: boolean) => string;
  */
 export declare const FMT_HHmmss: (x?: MaybeDate, utc?: boolean) => string;
 /**
- * Format preset, e.g. `17:08:01`
+ * Format preset, e.g. `170801`
  */
 export declare const FMT_HHmmss_ALT: (x?: MaybeDate, utc?: boolean) => string;
 /**
@@ -86,6 +88,34 @@ export declare const FMT_ISO_SHORT: (x?: MaybeDate, utc?: boolean) => string;
  * `2020-09-19T17:08:01.123Z`
  */
 export declare const FMT_ISO: (x?: MaybeDate, utc?: boolean) => string;
+/**
+ * Format preset, 4-digit year only
+ */
+export declare const FMT_yyyy: (x?: MaybeDate, utc?: boolean) => string;
+/**
+ * Format preset, 2-digit month only
+ */
+export declare const FMT_MM: (x?: MaybeDate, utc?: boolean) => string;
+/**
+ * Format preset, 2-digit week in year only
+ */
+export declare const FMT_ww: (x?: MaybeDate, utc?: boolean) => string;
+/**
+ * Format preset, 2-digit day in month only
+ */
+export declare const FMT_dd: (x?: MaybeDate, utc?: boolean) => string;
+/**
+ * Format preset, 2-digit hour only
+ */
+export declare const FMT_HH: (x?: MaybeDate, utc?: boolean) => string;
+/**
+ * Format preset, 2-digit minute only
+ */
+export declare const FMT_mm: (x?: MaybeDate, utc?: boolean) => string;
+/**
+ * Format preset, 2-digit second only
+ */
+export declare const FMT_ss: (x?: MaybeDate, utc?: boolean) => string;
 /**
  * Takes a `date` and optional reference `base` date and (also optional
  * `prec`ision, i.e. number of fractional digits, default: 0). Computes the
@@ -100,6 +130,8 @@ export declare const FMT_ISO: (x?: MaybeDate, utc?: boolean) => string;
  *
  * @example
  * ```ts
+ * import { formatRelative } from "@thi.ng/date";
+ *
  * formatRelative("2020-06-01", "2021-07-01")
  * // "1 year ago"
  *
@@ -132,6 +164,8 @@ export declare const formatRelative: (date: MaybeDate, base?: MaybeDate, prec?:
  *
  * @example
  * ```ts
+ * import { formatRelativeParts } from "@thi.ng/date";
+ *
  * // with default precision (seconds)
  * formatRelativeParts("2022-09-01 12:23:24", "2021-07-01 12:05")
  * // "in 1 year, 2 months, 21 hours, 18 minutes, 24 seconds"
@@ -156,6 +190,8 @@ export declare const formatRelativeParts: (date: MaybeDate, base?: MaybeDate, pr
  *
  * @example
  * ```ts
+ * import { formatDuration } from "@thi.ng/date";
+ *
  * formatDuration(45296000)
  * // "12 h, 34 min, 56 s"
  *

package/format.js

@@ -179,6 +179,13 @@ const FMT_ISO_SHORT = defFormat(
 const FMT_ISO = defFormat(
   ["yyyy", "-", "MM", "-", "dd", "T", "HH", ":", "mm", ":", "ss", ".", "SS", "ZZ"]
 );
+const FMT_yyyy = defFormat(["yyyy"]);
+const FMT_MM = defFormat(["MM"]);
+const FMT_ww = defFormat(["ww"]);
+const FMT_dd = defFormat(["dd"]);
+const FMT_HH = defFormat(["HH"]);
+const FMT_mm = defFormat(["mm"]);
+const FMT_ss = defFormat(["ss"]);
 const formatRelative = (date, base = /* @__PURE__ */ new Date(), prec = 0, eps = 100) => {
   const delta = difference(date, base);
   if (Math.abs(delta) < eps)
@@ -238,17 +245,24 @@ const formatDurationParts = (parts, prec = "s") => {
   }).filter((x) => !!x).join(", ");
 };
 export {
+  FMT_HH,
   FMT_HHmm,
   FMT_HHmmss,
   FMT_HHmmss_ALT,
   FMT_ISO,
   FMT_ISO_SHORT,
+  FMT_MM,
   FMT_MMMdyyyy,
   FMT_Mdyyyy,
   FMT_dMMMyyyy,
   FMT_dMyyyy,
+  FMT_dd,
   FMT_hm,
   FMT_hms,
+  FMT_mm,
+  FMT_ss,
+  FMT_ww,
+  FMT_yyyy,
   FMT_yyyyMMdd,
   FMT_yyyyMMdd_ALT,
   FMT_yyyyMMdd_HHmmss,

package/i18n.d.ts

@@ -38,6 +38,8 @@ export declare const monthNames: () => string[];
  *
  * @example
  * ```ts
+ * import { withLocale } from "@thi.ng/date";
+ *
  * withLocale(FR_LONG, () => units(1, "y"));
  * // "1 année"
  *
@@ -69,6 +71,8 @@ export declare const units: (x: number, unit: Precision | LocaleUnit, isDativ?:
  *
  * @example
  * ```ts
+ * import { withLocale } from "@thi.ng/date";
+ *
  * withLocale(DE_LONG, () => unitsLessThan(1, "y"));
  * // "weniger als 1 Jahr"
  * ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/date",
-  "version": "2.6.0",
+  "version": "2.7.1",
   "description": "Datetime types, relative dates, math, iterators, composable formatters, locales",
   "type": "module",
   "module": "./index.js",
@@ -35,9 +35,9 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.9.25",
+    "@thi.ng/api": "^8.9.26",
     "@thi.ng/checks": "^3.5.0",
-    "@thi.ng/strings": "^3.7.16"
+    "@thi.ng/strings": "^3.7.17"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.40.1",
@@ -132,5 +132,5 @@
   "thi.ng": {
     "year": 2020
   },
-  "gitHead": "4513a1c703bdbf0f0867f03e547e47692e415fac\n"
+  "gitHead": "6e20f80dd9df1c8055ffa3c1e4d6f7598add0c0b\n"
 }

package/timecode.d.ts

@@ -10,6 +10,8 @@
  *
  * @example
  * ```ts
+ * import { defTimecode } from "@thi.ng/date";
+ *
  * a = defTimecode(30);
  * a(HOUR + 2*MINUTE + 3*SECOND + 4*1000/30)
  * // "01:02:03:04"