fwrite_plus_date {libbib} | R Documentation |
Write a file with a date appended to the file name.
Description
Takes a data.table
, a file name, and writes it with
data.table::fwrite
.
Usage
fwrite_plus_date(
DT,
fname,
from.attribute = TRUE,
allow.fallback.date = TRUE,
...
)
Arguments
DT |
a |
fname |
The file name to write the |
from.attribute |
A logical indicating whether the date should
be taken from the |
allow.fallback.date |
A logical indicating, if there is no
|
... |
Arbitrary arguments to pass to |
Details
The supplied file name will be modified to include an ISO 8601 date
(yyyy-mm-dd) between the file name and the file extension. Under the
default settings, the date used will be from the lb.date
attribute of the supplied data.table
. If there is no lb.date
attribute, the current date will be used, instead.
For example, if there is a data.table
with an lb.date
attribute of "2021-05-08", and you supply this function with the file
name "iris.csv", the file name actually written to disk will be
"iris-2021-05-08.csv". Under the default settings, if there is no
lb.date
attribute, but today's date is "2038-01-19", the file
name written to disk will be "iris-2038-01-19.csv".
The ISO 8601 date is sandwiched between the file name and the file extension. The file extension is considered to be anything after the first period in the base name. For example, if the file name given is "./my.data/iris.csv.gz", the extension is ".csv.gz". This means no period can be present in the base file name (after any directories) with the exception of the file extension.
Examples
## Not run:
set_lb_date(iris, "2021-05-08")
fwrite_plus_date(iris, "iris.csv.gz")
# "iris-2021-05-08.csv.gz" is now written to disk
## End(Not run)