Get the time that a target last ran successfully.
Usage
tar_timestamp_raw(
name = NULL,
format = NULL,
tz = NULL,
parse = NULL,
store = targets::tar_config_get("store")
)
Arguments
- name
Character of length 1, name of the target.
- format
Deprecated in
targets
version 0.6.0 (2021-07-21).- tz
Deprecated in
targets
version 0.6.0 (2021-07-21).- parse
Deprecated in
targets
version 0.6.0 (2021-07-21).- store
Character of length 1, path to the
targets
data store. Defaults totar_config_get("store")
, which in turn defaults to_targets/
. When you set this argument, the value oftar_config_get("store")
is temporarily changed for the current function call. Seetar_config_get()
andtar_config_set()
for details about how to set the data store path persistently for a project.
Value
If the target is not recorded in the metadata
or cannot be parsed correctly, then
tar_timestamp_raw()
returns a POSIXct
object at 1970-01-01 UTC
.
Details
tar_timestamp_raw()
is like tar_timestamp()
except
it accepts a character string for name
instead of a symbol.
tar_timestamp_raw()
checks the metadata in _targets/meta/meta
,
not the actual data. Time stamps are recorded only for targets that
run commands: just non-branching targets and individual dynamic
branches.
See also
Other time:
tar_newer()
,
tar_older()
,
tar_timestamp()
Examples
if (identical(Sys.getenv("TAR_EXAMPLES"), "true")) { # for CRAN
tar_dir({ # tar_dir() runs code from a temp dir for CRAN.
tar_script({
list(tar_target(x, 1))
}, ask = FALSE)
tar_make()
# Get the timestamp.
tar_timestamp_raw("x")
# We can use the timestamp to cancel the target
# if it already ran within the last hour.
# Be sure to set `cue = tar_cue(mode = "always")`
# if you want the target to always check the timestamp.
tar_script({
list(
tar_target(
x,
tar_cancel((Sys.time() - tar_timestamp_raw()) < 3600),
cue = tar_cue(mode = "always")
)
)}, ask = FALSE)
tar_make()
})
}