Last chance! 50% off unlimited learning
Sale ends in
Modifies a date-time object by adding a specific amount of time units.
stri_datetime_add(
time,
value = 1L,
units = "seconds",
tz = NULL,
locale = NULL
)stri_datetime_add(time, units = "seconds", tz = NULL, locale = NULL) <- value
Both functions return an object of class POSIXct.
The replacement version of stri_datetime_add modifies
the state of the time object.
an object of class POSIXct
(as.POSIXct will be called on character vectors
and objects of class POSIXlt, Date, and factor)
integer vector; signed number of units to add to time
single string; one of 'years', 'months',
'weeks', 'days', 'hours', 'minutes',
'seconds', or 'milliseconds'
NULL or '' for the default time zone
or a single string with a timezone identifier,
NULL or '' for default locale,
or a single string with locale identifier; a non-Gregorian calendar
may be specified by setting the @calendar=name keyword
Marek Gagolewski and other contributors
Vectorized over time and value.
Note that, e.g., January, 31 + 1 month = February, 28 or 29.
Calendar Classes - ICU User Guide, https://unicode-org.github.io/icu/userguide/datetime/calendar/
The official online manual of stringi at https://stringi.gagolewski.com/
Gagolewski M., stringi: Fast and portable character string processing in R, Journal of Statistical Software 103(2), 2022, 1-59, tools:::Rd_expr_doi("10.18637/jss.v103.i02")
Other datetime:
stri_datetime_create(),
stri_datetime_fields(),
stri_datetime_format(),
stri_datetime_fstr(),
stri_datetime_now(),
stri_datetime_symbols(),
stri_timezone_get(),
stri_timezone_info(),
stri_timezone_list()
x <- stri_datetime_now()
stri_datetime_add(x, units='months') <- 2
print(x)
stri_datetime_add(x, -2, units='months')
stri_datetime_add(stri_datetime_create(2014, 4, 20), 1, units='years')
stri_datetime_add(stri_datetime_create(2014, 4, 20), 1, units='years', locale='@calendar=hebrew')
stri_datetime_add(stri_datetime_create(2016, 1, 31), 1, units='months')
Run the code above in your browser using DataLab