ftime(3)

ftime3

Get date and time

Usage

#include <sys/timeb.h>

int

ftime(struct timeb *tp);

Overview

This interface is obsoleted by gettimeofday(2).

The ftime() routine fills in a structure pointed to by its argument, as defined by ⟨sys/timeb.h⟩:

/*
 * Structure returned by ftime system call
 */
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.

Legacy synopsis

#include <sys/types.h> #include <sys/timeb.h>

The include file ⟨sys/types.h⟩ is necessary.

Releases

153 releases since Mac OS X 10.0; the text changed 2 times.

  1. 10.0–10.2.8
  2. 10.4–10.4.11
  3. 10.5–26.5

History

The ftime function appeared in 4.2BSD.

From Libc 1752.120.2 in macOS 26.5. Parsed by carta from the page's mdoc source.