R: Human readable format of the time interval since a time point

time_ago {prettyunits} | R Documentation

## Human readable format of the time interval since a time point

### Description

It calls `vague_dt` to do the actual formatting.

### Usage

    time_ago(date, format = c("default", "short", "terse"))

### Arguments

`date` | Date(s), `as.POSIXct` will be called on them.
`format` | Format, currently available formats are: ‘default’, ‘short’, ‘terse’. See examples below.

### Value

Character vector of the formatted time intervals.

### Examples

    now <- Sys.time()

    time_ago(now)
    time_ago(now - as.difftime(30, units = "secs"))
    time_ago(now - as.difftime(14, units = "mins"))
    time_ago(now - as.difftime(5, units = "hours"))
    time_ago(now - as.difftime(25, units = "hours"))
    time_ago(now - as.difftime(5, units = "days"))
    time_ago(now - as.difftime(30, units = "days"))
    time_ago(now - as.difftime(365, units = "days"))
    time_ago(now - as.difftime(365 * 10, units = "days"))

    ## Short format
    time_ago(format = "short", now)
    time_ago(format = "short", now - as.difftime(30, units = "secs"))
    time_ago(format = "short", now - as.difftime(14, units = "mins"))
    time_ago(format = "short", now - as.difftime(5, units = "hours"))
    time_ago(format = "short", now - as.difftime(25, units = "hours"))
    time_ago(format = "short", now - as.difftime(5, units = "days"))
    time_ago(format = "short", now - as.difftime(30, units = "days"))
    time_ago(format = "short", now - as.difftime(365, units = "days"))
    time_ago(format = "short", now - as.difftime(365 * 10, units = "days"))

    ## Even shorter, terse format, (almost always) exactly 3 characters wide
    time_ago(format = "terse", now)
    time_ago(format = "terse", now - as.difftime(30, units = "secs"))
    time_ago(format = "terse", now - as.difftime(14, units = "mins"))
    time_ago(format = "terse", now - as.difftime(5, units = "hours"))
    time_ago(format = "terse", now - as.difftime(25, units = "hours"))
    time_ago(format = "terse", now - as.difftime(5, units = "days"))
    time_ago(format = "terse", now - as.difftime(30, units = "days"))
    time_ago(format = "terse", now - as.difftime(365, units = "days"))
    time_ago(format = "terse", now - as.difftime(365 * 10, units = "days"))

[Package prettyunits version 1.0.2 Index]