S4 class that defines 'time interval' objects.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68  POSIXcti(start, end, timezone='UTC', ...)
as.POSIXcti(from, ...)
## S3 method for class 'POSIXcti'
x[i, ...]
## S3 replacement method for class 'POSIXcti'
x[i] < value
## S3 method for class 'POSIXcti'
c(...)
## S3 method for class 'POSIXcti'
split(x, f, drop=FALSE, ...)
## S3 method for class 'POSIXcti'
rep(x, ...)
## S3 method for class 'POSIXcti'
unique(x, incomparables=FALSE, ...)
## S3 method for class 'POSIXcti'
i1 %intersect% i2
## S3 method for class 'POSIXcti'
start(x, ...)
## S3 method for class 'POSIXcti'
end(x, ...)
## S4 method for signature 'POSIXcti'
duration(x, ...)
## S4 method for signature 'POSIXcti'
length(x)
## S3 method for class 'POSIXcti'
print(x, ...)
## S3 method for class 'POSIXcti'
format(x, format = "%Y%m%d %H:%M:%S", ...)
## S3 method for class 'POSIXcti'
summary(object, ...)
## S3 method for class 'POSIXcti'
head(x, ...)
## S3 method for class 'POSIXcti'
tail(x, ...)
## S4 method for signature 'POSIXcti'
show(object)
## S4 method for signature 'POSIXcti,POSIXcti'
match(x, table, nomatch = NA_integer_, incomparables=NULL)
## S4 method for signature 'POSIXcti,POSIXcti'
x %in% table
## S3 method for class 'POSIXcti'
e1 < e2
## S3 method for class 'POSIXcti'
e1 <= e2
## S3 method for class 'POSIXcti'
e1 != e2
## S3 method for class 'POSIXcti'
e1 == e2
## S3 method for class 'POSIXcti'
e1 >= e2
## S3 method for class 'POSIXcti'
e1 > e2
## S3 method for class 'POSIXcti'
i1 %included% i2
## S4 method for signature 'POSIXcti,POSIXctp'
e1 + e2
## S4 method for signature 'POSIXctp,POSIXcti'
e1 + e2
## S4 method for signature 'POSIXcti,POSIXctp'
e1  e2

start 

end 

timezone 

from 
Object to convert to a time interval (actually works only for

x 

i 
index ( 
value 
New 
f 

drop 
Argument specific to the split method. See 
format 

object 

table 
The values ( 
nomatch 
The value to be returned i nthe case when no match is found.
See 
incomparables 
A vector of values that cannot be matched.
See 
e1 
For (<, <=, !=, ==, >=, >) 
e2 
For (<, <=, !=, ==, >=, >) 
i1 

i2 

... 
More arguments. 
Objects of this class represent time intervals. One object is actually a vector of time intervals and so can have a length of one for a single time interval or a length of ‘n’ for ‘n’ time intervals.
start
:Object of class "POSIXct"
corresponding to the
beginning of the interval.
duration
:integer indicating in seconds the duration of intervals.
A POSIXcti has several properties. Because a POSIXcti is a vector of
time intervals, the class has a length
function. Other
properties are time properties : start
, end
and duration
allow to access to the corresponding properties.
The duration
of a time interval is the number of seconds for which
the interval last.
Manipulating POSIXcti
means acting on POSIXcti
s like on classical
vectors. Methods available for this task allow to extract or replace parts of
a POSIXcti
(with the usual '[' operator), and to
concatenate (c
) or split POSIXcti
(split
). A unique
and a rep
method are defined to uniquify or repeat elements of a POSIXcti
.
match
and %in%
methods have also been
defined to find POSIXctp
objects among others.
Last, the %intersect%
method allow to intersect two
POSIXcti
.
To represent a POSIXcti
available functions are print
,
summary
, head
,
tail
, show
and format
.
The five first functions work the same way that their generic definition.
POSIXcti
are formatted by pasting the character strings
representing both start and end of each intervals.
Start and end's format can be specified with the format
argument according to the basic format.POSIXct function.
To test two POSIXcti the differents operators of comparison are used. One
more is defined : %included%
. If the POSIXcti
compared
have a different length, the shorter is recycled over the longer so the
resulting vector (a logical vector) has length equal to the longer object.
Comparisons are made element by element. The result for a single comparison is given there :
TRUE if end(e1) <= start(e2)
.
TRUE if start(e1) <= start(e2) & end(e1) <= end(e2)
.
TRUE if start(e1) != start(e2)  duration(e1) != duration(e2)
.
TRUE if start(e1) == start(e2) & duration(e1) == duration(e2)
.
TRUE if start(e1) >= start(e2) & end(e1) >= end(e2)
.
TRUE if end(e1) >= start(e2)
.
TRUE if start(i1) >= start(i2) & end(i1) <= end(i2)
.
‘Mathematical’ operations are actually ‘time lagging’ for
POSIXcti
. A
time period
is added/removed to both start and end
of intervals. The available operations are :
POSIXcti + POSIXctp
POSIXctp + POISXcti
POSIXcti  POSIXctp
POSIXct
, TimeIntervalDataFrame
,
POSIXst
, POSIXctp
1 2 3 4 5 6 7 8 9 10 11 12 13 
Questions? Problems? Suggestions? Tweet to @rdrrHQ or email at ian@mutexlabs.com.
All documentation is copyright its authors; we didn't write any of that.