Standard C Library Functions                            ftime(3C)



NAME
     ftime - get date and time

SYNOPSIS
     #include 

     int ftime(struct timeb *tp);


DESCRIPTION
     The ftime() function sets the time and  millitm  members  of
     the  timeb  structure  pointed  to  by  tp. The structure is
     defined in  and contains the following members:

       timet           time;
       unsigned short   millitm;
       short            timezone;
       short            dstflag;



     The time and millitm members contain the  seconds  and  mil-
     liseconds  portions,  respectively,  of  the current time in
     seconds since 00:00:00  UTC  (Coordinated  Universal  Time),
     January 1, 1970.


     The timezone  member  contains  the  local  time  zone.  The
     dstflag  member contains a flag that, if non-zero, indicates
     that  Daylight  Saving  time  applies  locally  during   the
     appropriate part of the year.


     The contents of the timezone and dstflag members of tp after
     a call to ftime() are unspecified.

RETURN VALUES
     Upon successful completion, the ftime() function returns  0.
     Otherwise -1 is returned.

ERORS
     No errors are defined.

USAGE
     For portability to  implementations  conforming  to  earlier
     versions  of  this  document, time(2) is preferred over this
     function.


     The millisecond value usually has a granularity greater than
     one due to the resolution of the system clock.  Depending on
     any granularity (particularly a granularity of one)  renders



SunOS 5.11          Last change: 24 Jul 2002                    1






Standard C Library Functions                            ftime(3C)



     code non-portable.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
     ATRIBUTE TYPE               ATRIBUTE VALUE             
    
     Interface Stability          Standard                    
    


SEE ALSO
     date(1), time(2), ctime(3C), gettimeofday(3C),  timezone(4),
     attributes(5), standards(5)





































SunOS 5.11          Last change: 24 Jul 2002                    2