feat(smarttime.units): Add function to get human-readable time ago string from milliseconds.

changelog.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 2024-12-13 - 4.1.0 - feat(smarttime.units)
+Add function to get human-readable time ago string from milliseconds.
+
+- Introduced `getMilliSecondsAsHumanReadableAgoTime` to convert a timestamp to a human-readable text indicating time ago.
+
 ## 2024-12-13 - 4.0.9 - fix(dependencies)
 Updated dependencies in package.json and resolved cron function issues.
 

ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@push.rocks/smarttime',
-  version: '4.0.9',
+  version: '4.1.0',
   description: 'Provides utilities for advanced time handling including cron jobs, timestamps, intervals, and more.'
 }

ts/smarttime.units.ts

@@ -67,3 +67,7 @@ export let getMilliSecondsFromUnits = (combinationArg: IUnitCombinationArg) => {
 export const getMilliSecondsAsHumanReadableString = (milliSecondsArg: number): string => {
   return plugins.prettyMs(milliSecondsArg);
 };
+
+export const getMilliSecondsAsHumanReadableAgoTime = (timeStampArg: number): string => {
+  return plugins.dateFns.formatDistanceToNow(timeStampArg);
+}