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()