Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

date(1)

gettimeofday(2)

settimeofday(2)

ctime(3)

time(3)

NAME

time, ftime − get date and time

SYNTAX

time_t time((long *)0)

time_t time(tloc)
time_t *tloc;

#include <sys/types.h>
#include <sys/timeb.h>
ftime(tp)
struct timeb *tp;

DESCRIPTION

The time subroutine returns the time since 00:00:00 GMT, Jan. 1, 1970, measured in seconds.

If tloc is nonnull, the return value is also stored in the place to which tloc points. 

The ftime entry fills in a structure pointed to by its argument, as defined by < sys/timeb.h >:

 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 appropriate part of the year. 

ENVIRONMENT

When your program is compiled using the System V environment, the return value and parameter are of type long. 

SEE ALSO

date(1), gettimeofday(2), settimeofday(2), ctime(3)

Subroutines

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026