1Tcl_GetTime(3)              Tcl Library Procedures              Tcl_GetTime(3)
2
3
4
5______________________________________________________________________________
6

NAME

8       Tcl_GetTime - get date and time
9

SYNOPSIS

11       #include <tcl.h>
12
13       Tcl_GetTime( timePtr )
14

ARGUMENTS

16       Tcl_Time *   timePtr   (out)     Points to memory in which to store the
17                                        date and time information.
18_________________________________________________________________
19

DESCRIPTION

21       The Tcl_GetTime function retrieves  the  current  time  as  a  Tcl_Time
22       structure  in  memory the caller provides.  This structure has the fol‐
23       lowing definition:
24              typedef struct Tcl_Time {
25                  long sec;
26                  long usec;
27              } Tcl_Time;
28
29       On return, the sec member of the structure is filled in with the number
30       of seconds that have elapsed since the epoch: the epoch is the point in
31       time of 00:00 UTC, 1 January 1970.  This number  does  not  count  leap
32       seconds  -  an interval of one day advances it by 86400 seconds regard‐
33       less of whether a leap second has been inserted.
34
35       The usec member of the structure  is  filled  in  with  the  number  of
36       microseconds that have elapsed since the start of the second designated
37       by sec.  The Tcl library makes every effort to keep this number as pre‐
38       cise  as  possible,  subject to the limitations of the computer system.
39       On multiprocessor variants of Windows, this number may  be  limited  to
40       the 10- or 20-ms granularity of the system clock.  (On single-processor
41       Windows systems, the usec field is derived from a  performance  counter
42       and is highly precise.)
43

SEE ALSO

45       clock
46

KEYWORDS

48       date, time
49
50
51
52Tcl                                   8.4                       Tcl_GetTime(3)