timeDeltaPosix¶
Purpose¶
Adds (or subtracts) time to (from) a date-time.
Format¶
-
t_inc =
timeDeltaPosix(dt_start, inc, unit)¶ - Parameters:
dt_start (NxK string array, dataframe, or matrix) –
contains 1 more dates as a string array, dates, or in POSIX date/time format (seconds since Jan 1, 1970).
If using strings, valid formats include:
"YYYY-MM-DD HH:MI:SS""YYYY-MM-DD HH:MI""YYYY-MM-DD HH""YYYY-MM-DD""YYYY-MM""YYYY"
inc (scalar) – the number of units to increment dt_start.
unit (string) –
indicating the units for the increments in inc.
Valid unit options:
"years""months""days""hours""seconds"
- Returns:
t_inc (NxK dataframe or matrix) – dt_start, increased by inc units, in same date format as dt_start.
Examples¶
// January 1, 1970 at 00:00:00
dt_start = "1970-01-01";
// Increment by 15 years
dt_inc = timeDeltaPosix(dt_start, 15, "years");
The above code will set dt_inc equal to:
1985-01-01
// January 1, 1985 11:30:00
dt_start = "1985-01-01 11:30:00";
// Increment by 9 hours
dt_inc = timeDeltaPosix(dt_start, 9, "hours");
The above code will set dt_inc equal to:
1985-01-01 20:30:00
// January 1, 1985 at 09:00:00
// January 1, 1985 at 11:00:00
dt_start = "1985-01-01 09:00:00"$|"1985-01-01 11:00:00";
// Increment by 45 seconds
dt_inc = timeDeltaPosix(dt_start, 45, "seconds");
The above code will set dt_inc equal to:
1985-01-01 09:00:45
1985-01-01 11:00:45
See also
Functions timeDeltaDT(), seqadt(), seqaposix(), timediffPosix(), timediffDT()