Extract an index of date or datetime from time series objects, models, forecastsSource:
Extract an index of date or datetime from time series objects, models, forecasts
A time-based tibble, time-series object, time-series model, or
TRUEa timetk time-based index attribute is attempted to be returned. If
FALSEthe default index is returned. See discussion below for further details.
Used to toggle printing of messages and warnings.
tk_index() is used to extract the date or datetime index from various
time series objects, models and forecasts.
The method can be used on
The method can additionally be used on
forecast objects and a number of
objects generated by modeling functions such as
classes to get the index of the underlying data.
timetk_idx argument is applicable to regularized time series objects
zooreg classes that have both a regularized index and potentially
a "timetk index" (a time-based attribute).
When set to
FALSE the regularized index is returned.
When set to
TRUE the time-based timetk index is returned if present.
has_timetk_idx() is used to determine if the object has a "timetk index" attribute
and can thus benefit from the
tk_index(timetk_idx = TRUE).
TRUE indicates the "timetk index" attribute is present.
FALSE indicates the "timetk index" attribute is not present.
tk_index() function will return the default index for the data type.
Important Note: To gain the benefit of
timetk_idx the time series
must have a timetk index.
has_timetk_idx to determine if the object has a timetk index.
This is particularly important for
ts objects, which
by default do not contain a time-based index and therefore must be coerced from time-based
objects such as
zoo using the
tk_ts() function in order
to get the "timetk index" attribute.
tk_ts() for creating persistent date / datetime index
during coercion to
library(timetk) # Create time-based tibble data_tbl <- tibble::tibble( date = seq.Date(from = as.Date("2000-01-01"), by = 1, length.out = 5), x = rnorm(5) * 10, y = 5:1 ) tk_index(data_tbl) # Returns time-based index vector #>  "2000-01-01" "2000-01-02" "2000-01-03" "2000-01-04" "2000-01-05" # Coerce to ts using tk_ts(): Preserves time-basis data_ts <- tk_ts(data_tbl) #> Warning: Non-numeric columns being dropped: date tk_index(data_ts, timetk_idx = FALSE) # Returns regularized index #>  1 2 3 4 5 tk_index(data_ts, timetk_idx = TRUE) # Returns original time-based index vector #>  "2000-01-01" "2000-01-02" "2000-01-03" "2000-01-04" "2000-01-05" # Coercing back to tbl tk_tbl(data_ts, timetk_idx = FALSE) # Returns regularized tbl #> Warning: Warning: No index to preserve. Object otherwise converted to tibble successfully. #> # A tibble: 5 × 2 #> x y #> <dbl> <dbl> #> 1 -16.0 5 #> 2 -13.5 4 #> 3 -14.7 3 #> 4 -25.2 2 #> 5 2.14 1 tk_tbl(data_ts, timetk_idx = TRUE) # Returns time-based tbl #> # A tibble: 5 × 3 #> index x y #> <date> <dbl> <dbl> #> 1 2000-01-01 -16.0 5 #> 2 2000-01-02 -13.5 4 #> 3 2000-01-03 -14.7 3 #> 4 2000-01-04 -25.2 2 #> 5 2000-01-05 2.14 1