Tcl_GetTime(3) Tcl Library Procedures Tcl_GetTime(3)______________________________________________________________________________NAMETcl_GetTime - get date and time
SYNOPSIS
#include <tcl.h>
Tcl_GetTime( timePtr )
ARGUMENTS
Tcl_Time * timePtr (out) Points to memory in which to store the
date and time information.
_________________________________________________________________DESCRIPTION
The Tcl_GetTime function retrieves the current time as a Tcl_Time
structure in memory the caller provides. This structure has the fol‐
lowing definition:
typedef struct Tcl_Time {
long sec;
long usec;
} Tcl_Time;
On return, the sec member of the structure is filled in with the number
of seconds that have elapsed since the epoch: the epoch is the point in
time of 00:00 UTC, 1 January 1970. This number does not count leap
seconds - an interval of one day advances it by 86400 seconds regard‐
less of whether a leap second has been inserted.
The usec member of the structure is filled in with the number of
microseconds that have elapsed since the start of the second designated
by sec. The Tcl library makes every effort to keep this number as pre‐
cise as possible, subject to the limitations of the computer system.
On multiprocessor variants of Windows, this number may be limited to
the 10- or 20-ms granularity of the system clock. (On single-processor
Windows systems, the usec field is derived from a performance counter
and is highly precise.)
SEE ALSO
clock
KEYWORDS
date, time
Tcl 8.4 Tcl_GetTime(3)
