% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/duration.R
\name{duration}
\alias{duration}
\title{Duration vectors}
\usage{
duration(data, chronon = time_chronon(data), calendar = time_calendar(data))
}
\arguments{
\item{data}{A time vector of duration magnitudes.}

\item{chronon}{A time granule expression representing the chronon, evaluated
in the context of \code{calendar}. Use unquoted expressions like \code{month(1L)} or
\code{day(1L)}. Chronons from a specific calendar can also be used (e.g.
\code{cal_gregorian$month(1L)}). Defaults to the time chronon of the input
\code{data} (\code{time_chronon(data)}).}

\item{calendar}{Calendar system used to evaluate \code{chronon}. Defaults to
\code{time_calendar(data)} for existing time objects. Common options include
\link{cal_gregorian} and \link{cal_isoweek}.}
}
\value{
A \code{mixtime} vector containing an \code{mt_duration} vector.
}
\description{
\code{duration()} creates a vector of durations with a specified chronon.
Durations represent a fixed span of time measured in a given time granule
(e.g., 3 months, 5 days), without reference to a specific point in time.
}
\examples{
# A duration of 3 months
duration(3L, cal_gregorian$month(1L))

# A vector of durations in days
duration(1:7, cal_gregorian$day(1L))

}
\seealso{
\itemize{
\item \code{\link[=new_duration_fn]{new_duration_fn()}} for creating reusable duration functions
\item \link{cal_gregorian}, \link{cal_isoweek} for calendar systems
}
}
