stri_datetime_add: Date and Time Arithmetic¶
Description¶
Modifies a date-time object by adding a specific amount of time units.
Usage¶
stri_datetime_add(
time,
value = 1L,
units = "seconds",
tz = NULL,
locale = NULL
)
stri_datetime_add(time, units = "seconds", tz = NULL, locale = NULL) <- value
Arguments¶
|
an object of class |
|
integer vector; signed number of units to add to |
|
single string; one of |
|
|
|
|
Details¶
Vectorized over time
and value
.
Note that, e.g., January, 31 + 1 month = February, 28 or 29.
Value¶
Both functions return an object of class POSIXct
.
The replacement version of stri_datetime_add
modifies the state of the time
object.
References¶
Calendar Classes - ICU User Guide, http://userguide.icu-project.org/datetime/calendar
See Also¶
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()
Examples¶
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')