moderator-toolbox-nxg-for-reddit / util/data/time
util/data/time¶
Functions¶
coerceEpochSeconds()¶
coerceEpochSeconds(
time):number
Defined in: extension/data/util/data/time.ts:83
Coerces a timestamp that is meant to be in epoch seconds back to seconds,
repairing values that were mistakenly stored in milliseconds (e.g. a note
written with Date.now() instead of nowInSeconds). Values already in
the plausible-seconds range pass through untouched, so this is idempotent and
safe to apply to every timestamp on read.
Parameters¶
time¶
number
A timestamp that should be in epoch seconds but may be in milliseconds.
Returns¶
number
The timestamp in epoch seconds.
daysToMilliseconds()¶
daysToMilliseconds(
days):number
Defined in: extension/data/util/data/time.ts:93
Converts days to milliseconds.
Parameters¶
days¶
number
Returns¶
number
formatRelativeTime()¶
formatRelativeTime(
date):string
Defined in: extension/data/util/data/time.ts:13
Returns a human-readable relative time string for a given date (e.g. “3 hours ago”).
Parameters¶
date¶
Date
Returns¶
string
getTime()¶
getTime():
number
Defined in: extension/data/util/data/time.ts:53
Returns the current time in milliseconds.
Returns¶
number
millisecondsToDays()¶
millisecondsToDays(
milliseconds):number
Defined in: extension/data/util/data/time.ts:98
Converts milliseconds to days.
Parameters¶
milliseconds¶
number
Returns¶
number
minutesToMilliseconds()¶
minutesToMilliseconds(
mins):number
Defined in: extension/data/util/data/time.ts:88
Converts minutes to milliseconds, with a minimum of one minute.
Parameters¶
mins¶
number
Returns¶
number
niceDateDiff()¶
niceDateDiff(
origdate,newdate?):string
Defined in: extension/data/util/data/time.ts:103
Returns the difference between two dates in a human-readable format like “1 year, 2 months”.
Parameters¶
origdate¶
Date
newdate?¶
Date = ...
Returns¶
string
nowInSeconds()¶
nowInSeconds():
number
Defined in: extension/data/util/data/time.ts:62
The current time in whole epoch seconds - the unit Toolbox uses for its wiki
timestamps (usernotes, proposals, announcements). Truncates toward zero, which is
equivalent to flooring for the always-positive Date.now().
Returns¶
number
relativeTimeShort()¶
relativeTimeShort(
utcSeconds):string
Defined in: extension/data/util/data/time.ts:43
Formats a Unix timestamp (seconds) as a short relative time, e.g. “just now”, “5m ago”, “3h ago”, “2d ago”. Used by the mod-action history popups where space is tight; for full-width prose prefer formatRelativeTime.
Parameters¶
utcSeconds¶
number
Unix timestamp in seconds.
Returns¶
string
timeConverterRead()¶
timeConverterRead(
UNIX_timestamp):string
Defined in: extension/data/util/data/time.ts:194
Converts a Unix epoch timestamp to readable format: dd-mm-yyyy hh:mm:ss UTC
Parameters¶
UNIX_timestamp¶
number
Returns¶
string