Creates a mixtime time vector at a specific time point, with a specified
chronon and optional cycle. The chronon defines the smallest indivisible
time unit for the time vector, while the cycle allows for cyclical time
representations (e.g. day-of-week, month-of-year).
Usage
new_time(x = integer(), chronon = NULL, cycle = NULL)Arguments
- x
A numeric vector of time points, integers for discrete time or doubles for continuous time.
- chronon
A time unit object representing the smallest indivisible time unit (chronon) for the time vector (e.g.
cal_gregorian$day(1L)).- cycle
An optional time unit object representing the cycle for cyclical time (e.g.
cal_gregorian$week(1L)for day-of-week). If not provided, the time vector will be treated as linear time.
Value
A mt_time vector representing the time points in x according to
the specified chronon and cycle.
Examples
# Create a continuous mixtime time vector for today
new_time(
as.double(Sys.Date()),
chronon = cal_gregorian$day(1L, tz = Sys.timezone())
)
#> <mt_linear[1]>
#> [1] 2026-04-08 0.0%
# Create a discrete mixtime time vector for the current date and time
new_time(
as.integer(Sys.time()),
chronon = cal_gregorian$second(1L, tz = Sys.timezone())
)
#> <mt_linear[1]>
#> [1] 2026-04-08 03:06:11
# Create a discrete mixtime time vector for the time of day (cyclical time)
new_time(
as.integer(Sys.time()),
chronon = cal_gregorian$second(1L, tz = Sys.timezone()),
cycle = cal_gregorian$day(1L, tz = Sys.timezone())
)
#> <mt_cyclical[1]>
#> [1] 03:06:11