cut.dates
Create a Factor from a Chron or Dates Object
Divide the range of a chron or dates object x
into intervals
and code the values in x
according to which interval they fall.
- Keywords
- chron
Usage
# S3 method for dates
cut(x, breaks, labels, start.on.monday = TRUE, …)
Arguments
- x
chron or dates object (see
chron
), character dates such as"10/04/91"
or Julian dates).- breaks
either a vector of break points (a
dates
vector, character dates such as"10/04/91"
or Julian dates), a constant specifying number of equally spaced intervals extending frommin(x)-1
tomax(x)+1
, or one of the strings inc("days", "weeks", "months", "year")
specifying a time period.- labels
character labels for intervals.
- start.on.monday
should weeks be assumed to start on Mondays? Default is
TRUE
. Set toFALSE
if weeks start on Sundays; for other days of the week specify the corresponding number: Sunday == 0, Monday == 1, Tuesday == 2, …, Saturday == 6.- …
further arguments to be passed to or from methods.
Value
an ordered factor whose levels represent the various time intervals.
See Also
Examples
# NOT RUN {
# days from 07/01/92 thru 07/15/92 fell into 3 Monday-started weeks
cut(dates("07/01/92") + 0:14, "weeks")
# [1] week 1 week 1 week 1 week 1 week 1 week 2 week 2 week 2
# [9] week 2 week 2 week 2 week 2 week 3 week 3 week 3
dts <- dates(c("02/27/92", "02/27/92", "01/14/92",
"02/28/92", "02/01/92"))
cut(dts, "months")
# [1] Feb 92 Feb 92 Jan 92 Feb 92 Feb 92
boxplot(runif(5) ~ cut(dts, "months"))
# }