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
69
70
71
72
73
74
75
76
|
% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/gregorian-year-day.R
\name{seq.clock_year_day}
\alias{seq.clock_year_day}
\title{Sequences: year-day}
\usage{
\method{seq}{clock_year_day}(from, to = NULL, by = NULL, length.out = NULL, along.with = NULL, ...)
}
\arguments{
\item{from}{\verb{[clock_year_day(1)]}
A \code{"year"} precision year-day to start the sequence from.
\code{from} is always included in the result.}
\item{to}{\verb{[clock_year_day(1) / NULL]}
A \code{"year"} precision year-day to stop the sequence at.
\code{to} is cast to the type of \code{from}.
\code{to} is only included in the result if the resulting sequence divides
the distance between \code{from} and \code{to} exactly.}
\item{by}{\verb{[integer(1) / clock_duration(1) / NULL]}
The unit to increment the sequence by.
If \code{by} is an integer, it is transformed into a duration with the
precision of \code{from}.
If \code{by} is a duration, it is cast to the type of \code{from}.}
\item{length.out}{\verb{[positive integer(1) / NULL]}
The length of the resulting sequence.
If specified, \code{along.with} must be \code{NULL}.}
\item{along.with}{\verb{[vector / NULL]}
A vector who's length determines the length of the resulting sequence.
Equivalent to \code{length.out = vec_size(along.with)}.
If specified, \code{length.out} must be \code{NULL}.}
\item{...}{These dots are for future extensions and must be empty.}
}
\value{
A sequence with the type of \code{from}.
}
\description{
This is a year-day method for the \code{\link[=seq]{seq()}} generic.
Sequences can only be generated for \code{"year"} precision year-day vectors.
When calling \code{seq()}, exactly two of the following must be specified:
\itemize{
\item \code{to}
\item \code{by}
\item Either \code{length.out} or \code{along.with}
}
}
\examples{
# Yearly sequence
x <- seq(year_day(2020), year_day(2040), by = 2)
x
# Which we can then set the day of to get a sequence of end-of-year values
set_day(x, "last")
# Daily sequences are not allowed. Use a naive-time for this instead.
try(seq(year_day(2019, 1), by = 2, length.out = 2))
as_year_day(seq(as_naive_time(year_day(2019, 1)), by = 2, length.out = 2))
}
|
