\Header{cut.POSIXt}{Convert a Date-Time Object to a Factor}
\keyword{manip}{cut.POSIXt}
\keyword{chron}{cut.POSIXt}
\begin{Description}\relax
Method for \code{\Link{cut}} applied to date-time objects.\end{Description}
\begin{Usage}
\begin{verbatim}
cut(x, breaks, labels=NULL, start.on.monday=TRUE, ...)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{x}] an object inheriting from class \code{"POSIXt"}.
\item[\code{breaks}] a vector of cut points \emph{or} number giving the number of
intervals which \code{x} is to be cut into \emph{or} an
interval specification, one of \code{"secs"}, \code{"mins"},
\code{"hours"}, \code{"days"}, \code{"weeks"}, \code{"months"}
or \code{"years"}.

\item[\code{labels}] labels for the levels of the resulting category.  By default,
labels are constructed using \code{"(a,b]"} interval notation. If
\code{labels = FALSE}, simple integer codes are returned instead
of a factor.

\item[\code{start.on.monday}] logical. If \code{breaks = "weeks"}, should the
week start on Mondays or Sundays?
\item[\code{...}] arguments to be passed to or from other methods.
\end{ldescription}
\end{Arguments}
\begin{Value}
A factor is returned, unless \code{labels = FALSE} which returns
the integer level codes.\end{Value}
\begin{SeeAlso}\relax
\code{\Link{seq.POSIXt}}, \code{\Link{cut}}\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
## random dates in a 10-week period
cut(ISOdate(2001, 1, 1) + 70*86400*runif(100), "weeks")
\end{ExampleCode}
\end{Examples}

