seqaDT

Purpose

Creates a sequence of dates in DT scalar format.

Format

dt_vec = seqaDT(dt_start, inc, unit, n)
Parameters:
  • dt_start (scalar) – contains a date/time in DT scalar format.
  • inc (scalar) – the number of units for each of the n increments.
  • unit (string) –

    indicates the units for the increments in inc.

    Valid unit options:

    • "years"
    • "months"
    • "days"
    • "hours"
    • "seconds"
  • n (scalar) – the number of elements to create.
Returns:

dt_vec (nx1 vector) – starting at dt_start and increasing by inc units.

Examples

// Jan 20, 1980
dt_start = 19800120;

// Create a sequence of 10 dates separated by 4 years
dt_vec = seqaDT(dt_start, 4, "years", 10);

The above code will set dt_vec equal to:

19800120000000
19840120000000
19880120000000
19920120000000
19960120000000
20000120000000
20040120000000
20080120000000
20120120000000
20160120000000
// March 17, 2003 at 05:30:00
dt_start = 20030317053000;

// Create a sequence of 6 dates separated by 30 minutes
dt_vec = seqaDT(dt_start, 30, "minutes", 6);

The above code will set dt_vec equal to:

20030317053000
20030317060000
20030317063000
20030317070000
20030317073000
20030317080000

See also

Functions timeDeltaDT(), timeDiffDT(), seqaPosix(), timeDiffPosix()