cafe-utility 21.5.0 → 22.0.0

package/index.d.ts

@@ -240,7 +240,7 @@ declare function fromUtcString(string: string): Date;
 declare function fromMillis(millis: number): Date;
 declare function createTimeDigits(value: number): string;
 declare function humanizeTime(millis: number): string;
-interface TimestampTranslations {
+interface TimestampLabels {
     today: (hour: number, minute: number, pm: boolean) => string;
     yesterday: () => string;
     monday: () => string;
@@ -254,10 +254,10 @@ interface TimestampTranslations {
 }
 interface GetTimestampOptions {
     now?: number;
-    translations?: TimestampTranslations;
+    labels?: TimestampLabels;
 }
 declare function getTimestamp(date: Date | number, options?: GetTimestampOptions): string;
-interface AgoTranslations {
+interface TimeDeltaLabels {
     now: () => string;
     seconds: (value: number) => string;
     minutes: (value: number) => string;
@@ -265,11 +265,12 @@ interface AgoTranslations {
     days: (value: number) => string;
     weeks: (value: number) => string;
 }
-interface GetAgoOptions {
+interface TimeDeltaOptions {
     now?: number;
-    translations?: AgoTranslations;
+    labels?: TimeDeltaLabels;
 }
-declare function getAgo(date: Date | number, options?: GetAgoOptions): string;
+declare function getTimeDelta(date: Date | number, options?: TimeDeltaOptions): string;
+declare function secondsToHumanTime(seconds: number, labels?: TimeDeltaLabels): string;
 type CountCyclesOptions = {
     precision?: number;
     now?: number;
@@ -613,7 +614,8 @@ export declare const Promises: {
 };
 export declare const Dates: {
     getTimestamp: typeof getTimestamp;
-    getAgo: typeof getAgo;
+    getTimeDelta: typeof getTimeDelta;
+    secondsToHumanTime: typeof secondsToHumanTime;
     countCycles: typeof countCycles;
     isoDate: typeof isoDate;
     throttle: typeof throttle;

package/index.js

@@ -1296,7 +1296,7 @@ function humanizeTime(n) {
 function absoluteDays(n) {
     return Math.floor((isDate(n) ? n.getTime() : n) / 864e5)
 }
-const DefaultTimestampTranslations = {
+const DefaultTimestampLabels = {
     today: (n, t) => createTimeDigits(n) + ':' + createTimeDigits(t),
     yesterday: () => 'Yesterday',
     monday: () => 'Mon',
@@ -1310,7 +1310,7 @@ const DefaultTimestampTranslations = {
 }
 function getTimestamp(n, t) {
     const e = new Date(t?.now || Date.now()),
-        r = t?.translations || DefaultTimestampTranslations,
+        r = t?.labels || DefaultTimestampLabels,
         o = isDate(n) ? n : new Date(n)
     if (absoluteDays(e) === absoluteDays(o)) return r.today(o.getUTCHours(), o.getUTCMinutes(), o.getUTCHours() > 12)
     if (absoluteDays(e) - absoluteDays(o) === 1) return r.yesterday()
@@ -1319,30 +1319,34 @@ function getTimestamp(n, t) {
         ? r[i.day]()
         : r.weeks(Math.round((e.getTime() - o.getTime()) / 6048e5))
 }
-const DefaultAgoTranslations = {
-    now: () => 'A few seconds ago',
-    seconds: n => `${n} seconds ago`,
-    minutes: n => `${n} minutes ago`,
-    hours: n => `${n} hours ago`,
-    days: n => `${n} days ago`,
-    weeks: n => `${n} weeks ago`
-}
-function getAgo(n, t) {
-    const e = t?.now || Date.now(),
-        r = t?.translations || DefaultAgoTranslations,
-        o = exports.Types.isDate(n) ? n.getTime() : n
-    let i = (e - o) / 1e3
-    return i < 10
-        ? r.now()
-        : i < 120
-        ? r.seconds(Math.floor(i))
-        : ((i /= 60),
-          i < 120
-              ? r.minutes(Math.floor(i))
-              : ((i /= 60),
-                i < 48
-                    ? r.hours(Math.floor(i))
-                    : ((i /= 24), i < 14 ? r.days(Math.floor(i)) : ((i /= 7), r.weeks(Math.floor(i))))))
+const DefaultTimeDeltaLabels = {
+    now: () => 'A few seconds',
+    seconds: n => `${n} seconds`,
+    minutes: n => `${n} minutes`,
+    hours: n => `${n} hours`,
+    days: n => `${n} days`,
+    weeks: n => `${n} weeks`
+}
+function getTimeDelta(n, t) {
+    var e
+    const r = (e = t?.now) !== null && e !== void 0 ? e : Date.now(),
+        o = t?.labels || DefaultTimeDeltaLabels,
+        i = exports.Types.isDate(n) ? n.getTime() : n
+    let s = (r - i) / 1e3
+    return s < 10
+        ? o.now()
+        : s < 120
+        ? o.seconds(Math.floor(s))
+        : ((s /= 60),
+          s < 120
+              ? o.minutes(Math.floor(s))
+              : ((s /= 60),
+                s < 48
+                    ? o.hours(Math.floor(s))
+                    : ((s /= 24), s < 14 ? o.days(Math.floor(s)) : ((s /= 7), o.weeks(Math.floor(s))))))
+}
+function secondsToHumanTime(n, t = DefaultTimeDeltaLabels) {
+    return getTimeDelta(0, { now: n * 1e3, labels: t })
 }
 function countCycles(n, t, e) {
     var r, o, i
@@ -2401,7 +2405,8 @@ function raycastCircle(n, t, e) {
     (exports.Promises = { raceFulfilled, invert: invertPromise, runInParallelBatches, makeAsyncQueue }),
     (exports.Dates = {
         getTimestamp,
-        getAgo,
+        getTimeDelta,
+        secondsToHumanTime,
         countCycles,
         isoDate,
         throttle,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "cafe-utility",
-    "version": "21.5.0",
+    "version": "22.0.0",
     "description": "",
     "main": "index.js",
     "exports": {