unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

TIME(3V)                                                              TIME(3V)



NAME
       time, ftime - get date and time

SYNOPSIS
       #include <&lt;sys/types.h>&gt;
       #include <&lt;sys/time.h>&gt;

       time_t time(tloc)
       time_t *tloc;

       #include <&lt;sys/timeb.h>&gt;

       int ftime(tp)
       struct timeb *tp;

DESCRIPTION
       time()  returns  the time since 00:00:00 GMT, Jan. 1, 1970, measured in
       seconds.

       If tloc is non-NULL, the return value is also stored in the location to
       which tloc points.

       ftime()  fills  in  a  structure  pointed  to  by  tp,  as  defined  in
       <&lt;sys/timeb.h>&gt;:
              struct timeb
              {
                   time_t   time;
                   unsigned short millitm;
                   short    timezone;
                   short    dstflag;
              };

       The structure contains the time since the epoch in seconds, up to  1000
       milliseconds of more-precise interval, the local time zone (measured in
       minutes of time westward from Greenwich), and a flag that, if  nonzero,
       indicates  that  Daylight Saving time applies locally during the appro-
       priate part of the year.

RETURN VALUES
       time() returns the value of time on success.  On  failure,  it  returns
       (time_t) -1.

       On  success,  ftime()  returns no useful value.  On failure, it returns
       -1.

SEE ALSO
       date(1V), gettimeofday(2), ctime(3V)



                                21 January 1990                       TIME(3V)