ftime(3)

ftime3

Get date and time

Usage

#include <sys/types.h>

#include <sys/timeb.h>

int

ftime(struct timeb *tp);

Library

System Utilities Library (libutil, -lutil)

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 kernel no longer maintains the timezone and dstflag info, so 0 is always returned for these fields.

Releases

87 releases since FreeBSD 2.0.5-RELEASE; the text changed 42 times.

  1. 2.0.5
  2. 2.1.5–2.1.7.1
  3. 2.2.2–3.5.1
  4. 4.0–4.2
  5. 4.3
  6. 4.4
  7. 4.5–4.11
  8. 5.0–5.1
  9. 5.2–6.3
  10. 6.4
  11. 7.0
  12. 7.1
  13. 7.2
  14. 7.3
  15. 7.4
  16. 8.0
  17. 8.1
  18. 8.2
  19. 8.3
  20. 8.4
  21. 9.0
  22. 9.1
  23. 9.2
  24. 9.3
  25. 10.0
  26. 10.1
  27. 10.2
  28. 10.3
  29. 10.4
  30. 11.0
  31. 11.1
  32. 11.2
  33. 11.3
  34. 11.4
  35. 12.0
  36. 12.1
  37. 12.2
  38. 12.3
  39. 12.4
  40. 13.0–13.2
  41. 13.3–14.1
  42. 14.2–14.5
  43. 15.0–16.0

History

The ftime function appeared in Version 7 AT&T UNIX.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.