@thi.ng/date 2.7.83 → 2.8.1

package/README.md

@@ -69,7 +69,7 @@ For Node.js REPL:
 const date = await import("@thi.ng/date");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 5.42 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 5.43 KB
 
 ## Dependencies
 
@@ -381,6 +381,7 @@ string literal, prefix the term with `\\`.
 | `/DM`  | Locale-specific day-month separator         |
 | `/MY`  | Locale-specific month-year separator        |
 | `/HM`  | Locale-specific hour-minute separator       |
+| `/MS`  | Locale-specific minute-second separator     |
 
 <small>(Format IDs somewhat based on Java's
 [SimpleDateFormat](https://docs.oracle.com/en/java/javase/12/docs/api/java.base/java/text/SimpleDateFormat.html))</small>

package/api.d.ts

@@ -92,6 +92,12 @@ export interface Locale {
      * @defaultValue ":"
      */
     sepHM: string;
+    /**
+     * Separator between minute & second
+     *
+     * @defaultValue ":"
+     */
+    sepMS: string;
     /**
      * Singular & plural versions of various date/time units.
      */
@@ -164,6 +170,10 @@ export type Period = Precision | "w" | "q";
  */
 export declare const PERIODS: Record<Period, number>;
 export type FormatFn = Fn2<Date, boolean, string>;
+/**
+ * A function returned by {@link defFormat}.
+ */
+export type Formatter = (x?: MaybeDate, utc?: boolean) => string;
 export type MaybeDate = DateTime | Date | number | string;
 /**
  * Date rounding function for {@link MaybeDate} inputs.

package/datetime.d.ts

@@ -118,5 +118,5 @@ export declare const ensureDateTime: (x: MaybeDate, prec?: Precision) => DateTim
  *
  * @param x -
  */
-export declare const maybeIsDate: (x: any) => x is string | number | DateTime | Date;
+export declare const maybeIsDate: (x: any) => x is string | number | Date | DateTime;
 //# sourceMappingURL=datetime.d.ts.map

package/format.d.ts

@@ -1,4 +1,4 @@
-import { type FormatFn, type MaybeDate, type Precision } from "./api.js";
+import { type FormatFn, type Formatter, type MaybeDate, type Precision } from "./api.js";
 export declare const FORMATTERS: Record<string, FormatFn>;
 /**
  * Returns a new date formatter for given array of format strings (or
@@ -32,94 +32,94 @@ 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)[]) => Formatter;
 /**
  * Format preset, e.g. `2020-09-19`
  */
-export declare const FMT_yyyyMMdd: (x?: MaybeDate, utc?: boolean) => string;
+export declare const FMT_yyyyMMdd: Formatter;
 /**
  * Format preset, e.g. `20200919`
  */
-export declare const FMT_yyyyMMdd_ALT: (x?: MaybeDate, utc?: boolean) => string;
+export declare const FMT_yyyyMMdd_ALT: Formatter;
 /**
  * Format preset, e.g. `9/19/2020`
  */
-export declare const FMT_Mdyyyy: (x?: MaybeDate, utc?: boolean) => string;
+export declare const FMT_Mdyyyy: Formatter;
 /**
  * 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: Formatter;
 /**
  * Format preset, e.g. `19.9.2020`
  */
-export declare const FMT_dMyyyy: (x?: MaybeDate, utc?: boolean) => string;
+export declare const FMT_dMyyyy: Formatter;
 /**
  * Format preset, e.g. `19 Sep 2020`
  */
-export declare const FMT_dMMMyyyy: (x?: MaybeDate, utc?: boolean) => string;
+export declare const FMT_dMMMyyyy: Formatter;
 /**
  * Format preset, e.g. `17:08`
  */
-export declare const FMT_HHmm: (x?: MaybeDate, utc?: boolean) => string;
+export declare const FMT_HHmm: Formatter;
 /**
  * Format preset, e.g. `5:08 PM`
  */
-export declare const FMT_hm: (x?: MaybeDate, utc?: boolean) => string;
+export declare const FMT_hm: Formatter;
 /**
  * Format preset, e.g. `17:08:01`
  */
-export declare const FMT_HHmmss: (x?: MaybeDate, utc?: boolean) => string;
+export declare const FMT_HHmmss: Formatter;
 /**
  * Format preset, e.g. `170801`
  */
-export declare const FMT_HHmmss_ALT: (x?: MaybeDate, utc?: boolean) => string;
+export declare const FMT_HHmmss_ALT: Formatter;
 /**
  * Format preset, e.g. `5:08:01 PM`
  */
-export declare const FMT_hms: (x?: MaybeDate, utc?: boolean) => string;
+export declare const FMT_hms: Formatter;
 /**
  * Format preset, e.g. `20200919-170801`
  */
-export declare const FMT_yyyyMMdd_HHmmss: (x?: MaybeDate, utc?: boolean) => string;
+export declare const FMT_yyyyMMdd_HHmmss: Formatter;
 /**
  * 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: Formatter;
 /**
  * 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: Formatter;
 /**
  * Format preset, 4-digit year only
  */
-export declare const FMT_yyyy: (x?: MaybeDate, utc?: boolean) => string;
+export declare const FMT_yyyy: Formatter;
 /**
  * Format preset, 2-digit month only
  */
-export declare const FMT_MM: (x?: MaybeDate, utc?: boolean) => string;
+export declare const FMT_MM: Formatter;
 /**
  * Format preset, 2-digit week in year only
  */
-export declare const FMT_ww: (x?: MaybeDate, utc?: boolean) => string;
+export declare const FMT_ww: Formatter;
 /**
  * Format preset, 2-digit day in month only
  */
-export declare const FMT_dd: (x?: MaybeDate, utc?: boolean) => string;
+export declare const FMT_dd: Formatter;
 /**
  * Format preset, 2-digit hour only
  */
-export declare const FMT_HH: (x?: MaybeDate, utc?: boolean) => string;
+export declare const FMT_HH: Formatter;
 /**
  * Format preset, 2-digit minute only
  */
-export declare const FMT_mm: (x?: MaybeDate, utc?: boolean) => string;
+export declare const FMT_mm: Formatter;
 /**
  * Format preset, 2-digit second only
  */
-export declare const FMT_ss: (x?: MaybeDate, utc?: boolean) => string;
+export declare const FMT_ss: Formatter;
 /**
  * Takes a `date` and optional reference `base` date and (also optional
  * `prec`ision, i.e. number of fractional digits, default: 0). Computes the

package/format.js

@@ -146,6 +146,10 @@ const FORMATTERS = {
    * Current {@link LOCALE}'s hour-minute separator.
    */
   "/HM": () => LOCALE.sepHM,
+  /**
+   * Current {@link LOCALE}'s minute-second separator.
+   */
+  "/MS": () => LOCALE.sepMS,
   /**
    * Current {@link LOCALE}'s month-year separator.
    */
@@ -162,13 +166,13 @@ const FMT_yyyyMMdd = defFormat(["yyyy", "-", "MM", "-", "dd"]);
 const FMT_yyyyMMdd_ALT = defFormat(["yyyy", "MM", "dd"]);
 const FMT_Mdyyyy = defFormat(["M", "/", "d", "/", "yyyy"]);
 const FMT_MMMdyyyy = defFormat(["MMM", " ", "d", " ", "yyyy"]);
-const FMT_dMyyyy = defFormat(["d", "~", "M", "~", "yyyy"]);
-const FMT_dMMMyyyy = defFormat(["d", "~~", "MMM", " ", "yyyy"]);
-const FMT_HHmm = defFormat(["HH", ":", "mm"]);
-const FMT_hm = defFormat(["h", ":", "mm", " ", "A"]);
-const FMT_HHmmss = defFormat(["HH", ":", "mm", ":", "ss"]);
+const FMT_dMyyyy = defFormat(["d", "/DM", "M", "/MY", "yyyy"]);
+const FMT_dMMMyyyy = defFormat(["d", "/DM", "MMM", " ", "yyyy"]);
+const FMT_HHmm = defFormat(["HH", "/HM", "mm"]);
+const FMT_hm = defFormat(["h", "/HM", "mm", " ", "A"]);
+const FMT_HHmmss = defFormat(["HH", "/HM", "mm", "/MS", "ss"]);
 const FMT_HHmmss_ALT = defFormat(["HH", "mm", "ss"]);
-const FMT_hms = defFormat(["h", ":", "mm", ":", "ss", " ", "A"]);
+const FMT_hms = defFormat(["h", "/HM", "mm", "/MS", "ss", " ", "A"]);
 const FMT_yyyyMMdd_HHmmss = defFormat(
   ["yyyy", "MM", "dd", "-", "HH", "mm", "ss"]
 );

package/i18n/en.js

@@ -14,7 +14,6 @@ const EN_SHORT = {
     "Dec"
   ],
   days: ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"],
-  sepHM: ".",
   date: ["dd", "/DM", "MM", "/MY", "yyyy"],
   time: ["h", "/HM", "mm", " ", "a"],
   units: {
@@ -57,7 +56,6 @@ const EN_LONG = {
   ],
   sepDM: " ",
   sepMY: " ",
-  sepHM: ".",
   time: ["h", "/HM", "mm", " ", "a"],
   units: {
     y: { s: "year", p: "years" },

package/i18n.js

@@ -6,6 +6,7 @@ const __prepLocale = (spec) => {
     sepDM: "/",
     sepMY: "/",
     sepHM: ":",
+    sepMS: ":",
     date: ["E", "/ED", "d", "/DM", "MMM", "/MY", "yyyy"],
     time: ["H", "/HM", "mm"],
     ...spec

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@thi.ng/date",
-	"version": "2.7.83",
+	"version": "2.8.1",
 	"description": "Datetime types, relative dates, math, iterators, composable formatters, locales",
 	"type": "module",
 	"module": "./index.js",
@@ -135,5 +135,5 @@
 	"thi.ng": {
 		"year": 2020
 	},
-	"gitHead": "8ddf86ea0a1e658ddbf19cc645b29d0c176e29c4\n"
+	"gitHead": "4eaee6aed1a23312217b85bbb1285c754ba1b446\n"
 }