@thi.ng/date 2.7.2 → 2.7.4

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-02-28T14:23:30Z
+- **Last updated**: 2024-03-02T14:05:53Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/README.md

@@ -1,16 +1,5 @@
 <!-- This file is generated - DO NOT EDIT! -->
 <!-- Please see: https://github.com/thi-ng/umbrella/blob/develop/CONTRIBUTING.md#changes-to-readme-files -->
-> [!IMPORTANT]
-> ‼️ Announcing the thi.ng user survey 2024 📋
->
-> [Please participate in the survey here!](https://forms.gle/XacbSDEmQMPZg8197)\
-> (open until end of February)
->
-> **To achieve a better sample size, I'd highly appreciate if you could
-> circulate the link to this survey in your own networks.**
->
-> [Discussion](https://github.com/thi-ng/umbrella/discussions/447)
-
 # ![@thi.ng/date](https://media.thi.ng/umbrella/banners-20230807/thing-date.svg?954b4ac2)
 
 [![npm version](https://img.shields.io/npm/v/@thi.ng/date.svg)](https://www.npmjs.com/package/@thi.ng/date)
@@ -22,7 +11,7 @@
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >
-> 🚀 Help me to work full-time on these projects by [sponsoring me on
+> 🚀 Please help me to work full-time on these projects by [sponsoring me on
 > GitHub](https://github.com/sponsors/postspectacular). Thank you! ❤️
 
 - [About](#about)
@@ -120,6 +109,8 @@ Note: `DateTime` instances also define the above keys as properties, plus
 getters for week-in-year (`.w`) and quarter (`.q`).
 
 ```ts
+import { dateTime } from "@thi.ng/date";
+
 // create w/ current date (or pass epoch, string, Date or DateTime instances)
 const a = dateTime();
 // DateTime { y: 2020, M: 8, d: 19, h: 12, m: 17, s: 16, t: 884 }
@@ -164,6 +155,8 @@ offset period. Period identifiers are any `Precision` ID (see above) or `w`
 (week, aka 7 days) or `q` (quarter, aka 3 months):
 
 ```ts
+import { dateTime, difference, absDifference, asDays } from "@thi.ng/date";
+
 const a = dateTime();
 // DateTime { y: 2020, M: 8, d: 19, h: 12, m: 17, s: 16, t: 884 }
 
@@ -226,6 +219,8 @@ purposes (i.e. as axis tick label generators for
 - `milliseconds()`
 
 ```ts
+import { months, FMT_yyyyMMdd } from "@thi.ng/date";
+
 [...months("2021-01-03", "2021-07-16")]
 // [
 //   1609459200000,
@@ -257,6 +252,8 @@ Relative dates can be obtained via
 or [`relative()`](https://docs.thi.ng/umbrella/date/functions/relative.html).
 
 ```ts
+import { dateTime, parseRelative } from "@thi.ng/date";
+
 const now = dateTime();
 // DateTime { y: 2021, M: 2, d: 21, h: 14, m: 26, s: 0, t: 661 }
 
@@ -284,6 +281,12 @@ Both functions use the currently active [locale](#locales) and accept an
 optional reference date (default: `now()`).
 
 ```ts
+import {
+    setLocale, withLocale, DE_LONG, EN_LONG,
+    formatRelative, formatRelativeParts, formatDuration,
+    decomposeDifference
+} from "@thi.ng/date";
+
 setLocale(EN_LONG);
 
 formatRelative("2020-06-01", "2021-07-01")
@@ -418,15 +421,17 @@ part is non-zero. The 4 separators between each field can be customized via 2nd
 arg (default: all `:`).
 
 ```ts
-a = defTimecode(30);
+import { defTimecode, DAY, HOUR, MINUTE, SECOND } from "@thi.ng/date";
+
+const a = defTimecode(30);
 a(1*HOUR + 2*MINUTE + 3*SECOND + 4*1000/30)
 // "01:02:03:04"
 
 a(DAY);
 // "01:00:00:00:00"
 
-b = defTimecode(30, ["d ", "h ", "' ", '" ']);
-b(Day + HOUR + 2*MINUTE + 3*SECOND + 999)
+const b = defTimecode(30, ["d ", "h ", "' ", '" ']);
+b(DAY + HOUR + 2*MINUTE + 3*SECOND + 999)
 // "01d 01h 02' 03" 29"
 ```
 
@@ -449,9 +454,14 @@ by the current `LOCALE` (default: `EN_SHORT`) and can be set/changed via the
 `setLocale()` function:
 
 ```ts
+import {
+    dateTime, defFormat, setLocale,
+    EN_SHORT, EN_LONG
+} from "@thi.ng/date";
+
 const fmt = defFormat(["E", " ", "d", " ", "MMM", " ", "yyyy"]);
 
-setLocale(EN_SHORT); // default
+setLocale(EN_SHORT); // also the default
 // {
 //   months: [
 //     'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',
@@ -474,6 +484,8 @@ to only temporarily set a locale and execute a function with it, then
 automatically restoring the currently active locale.
 
 ```ts
+import { dateTime, withLocale, FR_LONG } from "@thi.ng/date";
+
 fmt(dateTime());
 // 'Fri 16 Jul 2021'
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/date",
-  "version": "2.7.2",
+  "version": "2.7.4",
   "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.26",
-    "@thi.ng/checks": "^3.5.0",
-    "@thi.ng/strings": "^3.7.18"
+    "@thi.ng/api": "^8.9.27",
+    "@thi.ng/checks": "^3.5.1",
+    "@thi.ng/strings": "^3.7.20"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.40.1",
@@ -132,5 +132,5 @@
   "thi.ng": {
     "year": 2020
   },
-  "gitHead": "190d68e7f7524631b333cfdbf32c6a23be27c166\n"
+  "gitHead": "df9e312af741d87e6b450afcfea6a6e381662b1e\n"
 }