Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tree: 91bd4ee969
Fetching contributors…

Cannot retrieve contributors at this time

48 lines (45 sloc) 1.164 kb
\name{ceiling_date}
\alias{ceiling_date}
\title{Round date-times up.}
\usage{
ceiling_date(x,
unit = c("second", "minute", "hour", "day", "week", "month", "year"))
}
\arguments{
\item{x}{a vector of date-time objects}
\item{unit}{a character string specifying the time unit
to be rounded to. Should be one of
"second","minute","hour","day", "week", "month", or
"year."}
}
\value{
x with the appropriate units rounded up
}
\description{
ceiling_date takes a date-time object and rounds it up to
the nearest integer value of the specified time unit.
Users can specify whether to round up to the nearest
second, minute, hour, day, week, month, or year.
}
\examples{
x <- as.POSIXct("2009-08-03 12:01:59.23")
ceiling_date(x, "second")
# "2009-08-03 12:02:00 CDT"
ceiling_date(x, "minute")
# "2009-08-03 12:02:00 CDT"
ceiling_date(x, "hour")
# "2009-08-03 13:00:00 CDT"
ceiling_date(x, "day")
# "2009-08-04 CDT"
ceiling_date(x, "week")
# "2009-08-09 CDT"
ceiling_date(x, "month")
# "2009-09-01 CDT"
ceiling_date(x, "year")
# "2010-01-01 CST"
}
\seealso{
\code{\link{floor_date}}, \code{\link{round_date}}
}
\keyword{chron}
\keyword{manip}
Jump to Line
Something went wrong with that request. Please try again.