timeDeltaDT#

Purpose#

Adds (or subtracts) time to a DT scalar.

Format#

t_inc = timeDeltaDT(dt_start, inc, unit)#

Parameters:

dt_start (NxK matrix) – containing 1 or more DT scalars.
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 (Scalar) – dt_start, increased by inc units.

Examples#

// March 17, 1954 at 04:30:21
dt_start = 19540317043021;

// Increment by 60 years
dt_inc = timeDeltaDT(dt_start, 60, "years");

The above code will set dt_inc equal to:

20140317043021

// March 17, 2003 at 05:29:12
dt_start = 20030317052912;

// Increment by 18 months
dt_inc = timeDeltaDT(dt_start, 18, "months");

The above code will set dt_inc equal to:

20040917052912

// December 31, 1999 at 23:59:00
// December 31, 2000 at 23:59:00
dt_start = { 19991231235900, 20001231235900 };

// Increment by 1 minute
dt_inc_1 = timeDeltaDT(dt_start, 1, "minutes");

// Increment by 60 seconds
dt_inc_2 = timeDeltaDT(dt_start, 60, "seconds");

The above code will set dt_inc_1 and dt_inc_2 equal to:

20000101000000
20010101000000