Function relativeTimeLabel

  • relativeTimeLabel(timestamp, now?): string

  • Produce a human-friendly label describing how long ago timestamp was relative to now (defaults to Date.now()).

    Examples:

    • "just now" (< 60 s)
    • "5 minutes ago" (< 1 h)
    • "2 hours ago" (< today boundary, but > 1 h)
    • "earlier today" (same calendar day, > 1 h)
    • "yesterday" (previous calendar day)
    • "last Tuesday" (2-6 days ago, uses day name)
    • "3 days ago" (2-6 days ago, alternative when day name would be confusing)
    • "last week" (7-13 days)
    • "2 weeks ago" (14-20 days)
    • "3 weeks ago" (21-27 days)
    • "last month" (28-59 days)
    • "2 months ago" (60-89 days)
    • "N months ago" (90-364 days)
    • "last year" (365-729 days)
    • "N years ago" (730+ days)

    Future timestamps return "in the future".

    Parameters

    • timestamp: number

      Unix ms timestamp to describe.

    • Optional now: number

      Reference timestamp (defaults to Date.now()).

    Returns string

    Human-friendly relative time string.

Settings

Member Visibility

Theme