% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/public__s3_methods.R
\name{temporal_options}
\alias{temporal_options}
\title{Create Temporal Filtering Options}
\usage{
temporal_options(
  time_filter = NULL,
  after = NULL,
  before = NULL,
  strictness = "best_effort",
  use_wayback = FALSE
)
}
\arguments{
\item{time_filter}{DuckDuckGo time filter: "d" (day), "w" (week),
"m" (month), "y" (year), or NULL for no filter}

\item{after}{ISO 8601 date string (e.g., "2020-01-01") - results after this date}

\item{before}{ISO 8601 date string (e.g., "2024-01-01") - results before this date}

\item{strictness}{Verification level: "best_effort" (default) or "strict"}

\item{use_wayback}{Use Wayback Machine for strict pre-date guarantees}
}
\value{
An object of class \code{asa_temporal}
}
\description{
Creates a temporal filtering configuration for constraining search results
by date. Supports DuckDuckGo time filters, date ranges, and strict
verification modes.
}
\details{
Temporal filtering can operate at different levels:
\itemize{
  \item \strong{time_filter}: DuckDuckGo native filter (fast, approximate)
  \item \strong{after/before}: Date hints appended to prompts
  \item \strong{strict}: Post-hoc verification of result dates
  \item \strong{use_wayback}: Uses Internet Archive for guaranteed historical data
}
}
\examples{
\dontrun{
# Past year only
temporal <- temporal_options(time_filter = "y")

# Specific date range
temporal <- temporal_options(
  after = "2020-01-01",
  before = "2024-01-01"
)

# Strict historical verification
temporal <- temporal_options(
  before = "2015-01-01",
  strictness = "strict",
  use_wayback = TRUE
)
}

}
\seealso{
\code{\link{asa_config}}, \code{\link{run_task}}
}
