seqaPosix#

Purpose#

Creates a sequence of dates.

Format#

dt_vec = seqaPosix(dt_start, inc, unit, n)#
Parameters:

  • dt_start (string or scalar) –

    contains the starting date as a string, date, or in POSIX date/time format (seconds since Jan 1, 1970).

    If string, 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 for each of the n increments.

  • unit (string) –

    indicating 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 dataframe) – starting at dt_start and increasing by inc units. The dt_vec will be in same date format as dt_start.

Examples#

// Create a sequence of 10 dates separated by 4 years
dt_vec = seqaPosix("1980-01-20", 4, "years", 10);

The above code will set dt_vec equal to:

1980-01-20
1984-01-20
1988-01-20
1992-01-20
1996-01-20
2000-01-20
2004-01-20
2008-01-20
2012-01-20
2016-01-20

// Create a sequence of 6 dates separated by 30 minutes
dt_vec = seqaPosix("2003-03-17 05:30:00", 30, "minutes", 6);

The above code will set dt_vec equal to:

2003-03-17 05:30:00
2003-03-17 06:00:00
2003-03-17 06:30:00
2003-03-17 07:00:00
2003-03-17 07:30:00
2003-03-17 08:00:00

// Convert string date in a different format to
// a GAUSS date.
dt_start = strcToPosix("01/20/1980", "%m/%d/%Y");

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

In the above example, dt_start is:

01/20/1980

This will set dt_vec equal to:

01/20/1980
01/20/1984
01/20/1988
01/20/1992
01/20/1996
01/20/2000
01/20/2004
01/20/2008
01/20/2012
01/20/2016

See also

Functions timeDeltaDT(), timeDiffDT(), seqaDT(), timeDiffPosix()

On this page