splusTimeDate (version 1.5.0-72)

timeSeq: Sequences of Times

Description

Constructs a regularly-spaced timeDate object.

Usage

timeSeq(from, to, by = "days", length.out, k.by=1, align.by=FALSE,  
        extend=FALSE, week.align=NULL, holidays, exceptions, 
        additions, format, zone)

Arguments

from

the starting value of the sequence: a timeDate object (or number or character string representing one).

to

the ending value of the sequence: a timeDate object (or number or character string representing one).

by

the spacing between the successive values in the sequence. This can be a timeSpan, timeRelative, or numeric value, in which case k.by is ignored. Alternatively, it can be one of th

length.out

the length of the sequence before additions and exceptions are included.

k.by

a non-zero integer giving the width of the interval between consecutive values in the sequence in terms of the units given in by. Ignored if by is not a character string.

align.by

a logical value. If TRUE, adjusts the sequence so that each element is on a whole number of the by * k.by units. For example, if the units are 2 months, the sequence is on only the first of January, March, May, and

extend

a logical value. If TRUE and align.by is also TRUE, instead of making the entire sequence lie between from and to, make it extend just past from and to

week.align

if by is "weeks", you can supply a character string (or a number 0 to 6, with 0 being Sunday) to specify a weekday. The character string must be sufficient to make a unique case-insensitive match to the str

holidays

the holidays for business day sequences (ignored if by is not a character string).

exceptions

an event object giving any time periods when the sequence should have no values. These are applied after the sequence is created from from/to/by length.out.

additions

any additional times or dates to put in the sequence.

format

the time/date output format for printing.

zone

the time zone for the sequence.

Value

• returns a time/date object as defined by the arguments.

See Also

seq, timeAlign, timeSequence, format.timeDate, holidays, timeEvent

Examples

timeSeq("1/1/1992", "1/10/1992") 
timeSeq("1/1/1992", "12/1/1992", by = "months") 
timeSeq("1/3/1992", "12/5/1992", by = "months", align.by=TRUE) 
timeSeq("1/3/1992", "12/5/1992", by = "months", align.by=TRUE, extend=TRUE) 
timeSeq("1/1/1992", "1/31/1992", by = "weeks", align.by=TRUE,  
   week.align="Mon") 
timeSeq("1/1/1992", "12/31/1992", by="weekdays", exceptions=holidays(1992))
timeSeq("1/1/1992", "1/1/1995", by="months", exceptions=timeEvent("1/1/1993", "12/31/1993"))
## subtract one day from a first-of-month sequence to create
## an end-of-month sequence
timeSeq(from = "2/1/2003", to = "1/1/2004", by = "months" ) - 1