runjags: timestring – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

timestring

Calculate the Elapsed Time in Sensible Units

Description

Function to calculate the elapsed time between 2 time periods (in seconds), or to calculate a number of seconds into a time measurement in more sensible units.

Usage

timestring(time1, time2 = NA, units = NA, show.units = TRUE)

Arguments

`time1`	either the time index (from Sys.time()) at the start of the time period, a length of time in seconds, or an object of class 'difftime'.
`time2`	either the time index (from Sys.time()) at the end of the time period, or missing data if converting a single length of time. Default NA.
`units`	either missing, in which case a sensible time unit is chosen automatically, or one of 's', 'm', 'h', 'd', 'w', 'y' to force a specific unit. Default NA.
`show.units`	if TRUE, then the time is returned with units, if FALSE then just an integer is returned. Default TRUE.

Value

A time measurement, with or without units.

Examples

# Time how long it takes to complete a task:

pre.time <- Sys.time()
Sys.sleep(2)  # PROCESS TO TIME
post.time <- Sys.time()
timestring(pre.time, post.time)

# Convert 4687 seconds into hours:

timestring(4687, units='hours', show.units=FALSE)

runjags

Interface Utilities, Model Templates, Parallel Computing Methods and Additional Distributions for MCMC Models in JAGS

v2.2.0-2

GPL-2

Authors

Matthew Denwood [aut, cre], Martyn Plummer [cph] (Copyright holder of the code in src/distributions/DPar1.*, configure.ac, R/rjags_functions.R, and original copyright holder of some modified code where indicated)

Initial release

2021-03-01