\HeaderA{Sys.time}{Get Current Date, Time and Timezone}{Sys.time}
\aliasA{Sys.Date}{Sys.time}{Sys.Date}
\aliasA{Sys.timezone}{Sys.time}{Sys.timezone}
\keyword{utilities}{Sys.time}
\keyword{chron}{Sys.time}
\begin{Description}\relax
\code{Sys.time} and \code{Sys.Date} returns the system's idea of the
current date with and without time, and \code{Sys.timezone} returns
the current time zone.
\end{Description}
\begin{Usage}
\begin{verbatim}
Sys.time()
Sys.Date()
Sys.timezone()
\end{verbatim}
\end{Usage}
\begin{Details}\relax
\code{Sys.time} returns an absolute date-time value which can be
converted in various time zones and may return different days.

\code{Sys.Date} returns the day in the current timezone.
\end{Details}
\begin{Value}
\code{Sys.time} returns an object of class \code{"POSIXct"} (see
\LinkA{DateTimeClasses}{DateTimeClasses}).  On some systems it will have sub-second
accuracy, but on others it will increment in seconds.
On systems conforming to POSIX 1003.1-2001 the time will be reported
in microsecond increments.

\code{Sys.Date} returns an object of class \code{"Date"} (see \LinkA{Date}{Date}).

\code{Sys.timezone} returns an OS-specific character string, possibly
an empty string.
\end{Value}
\begin{SeeAlso}\relax
\code{\LinkA{date}{date}} for the system time in a fixed-format character
string; the elapsed time component of \code{\LinkA{proc.time}{proc.time}} 
for possibly finer resolution in changes in time.
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
Sys.time()
## print with possibly greater accuracy:
op <- options(digits.secs=6)
Sys.time()
options(op)

## locale-specific version of date()
format(Sys.time(), "%a %b %d %X %Y")

Sys.Date()

Sys.timezone()
\end{ExampleCode}
\end{Examples}

