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