% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/shared__helpers.R
\name{configure_temporal}
\alias{configure_temporal}
\title{Configure Temporal Filtering for Search}
\usage{
configure_temporal(time_filter = NULL)
}
\arguments{
\item{time_filter}{DuckDuckGo time filter: "d" (day), "w" (week),
"m" (month), "y" (year), or NULL/NA/"none" to clear}
}
\value{
Invisibly returns the previous time filter setting
}
\description{
Sets or clears temporal filtering on the DuckDuckGo search tool.
This affects all subsequent searches until changed or cleared.
}
\details{
This function modifies the search tool's time parameter, which is
passed to DuckDuckGo as the \code{df} parameter. The filter restricts
results to content indexed within the specified time period.

Note: This only affects DuckDuckGo searches. For Wikidata queries
with temporal filtering, use \code{asa_enumerate()} with its
\code{temporal} parameter.
}
\section{Time Filter Values}{

\itemize{
  \item "d": Past 24 hours (day)
  \item "w": Past 7 days (week)
  \item "m": Past 30 days (month)
  \item "y": Past 365 days (year)
  \item NULL, NA, or "none": No time restriction (default)
}
}

\examples{
\dontrun{
# Restrict to past year
configure_temporal("y")
result <- run_task("Find recent AI breakthroughs", agent = agent)

# Clear temporal filter
configure_temporal(NULL)

# Past week only
configure_temporal("w")
}

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