[unix-history] / usr / man / cat3 / ftime.0



TIME(3C)	    UNIX Programmer's Manual		 TIME(3C)


N\bNA\bAM\bME\bE
     time, ftime - get date and time

S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
     l\blo\bon\bng\bg t\bti\bim\bme\be(\b(0\b0)\b)

     l\blo\bon\bng\bg t\bti\bim\bme\be(\b(t\btl\blo\boc\bc)\b)
     l\blo\bon\bng\bg *\b*t\btl\blo\boc\bc;\b;

     #\b#i\bin\bnc\bcl\blu\bud\bde\be <\b<s\bsy\bys\bs/\b/t\bty\byp\bpe\bes\bs.\b.h\bh>\b>
     #\b#i\bin\bnc\bcl\blu\bud\bde\be <\b<s\bsy\bys\bs/\b/t\bti\bim\bme\beb\bb.\b.h\bh>\b>
     f\bft\bti\bim\bme\be(\b(t\btp\bp)\b)
     s\bst\btr\bru\buc\bct\bt t\bti\bim\bme\beb\bb *\b*t\btp\bp;\b;

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
     T\bTh\bhe\bes\bse\be i\bin\bnt\bte\ber\brf\bfa\bac\bce\bes\bs a\bar\bre\be o\bob\bbs\bso\bol\ble\bet\bte\bed\bd b\bby\by g\bge\bet\btt\bti\bim\bme\beo\bof\bfd\bda\bay\by(\b(2\b2)\b).\b.

     _\bT_\bi_\bm_\be returns the time since 00:00:00 GMT, Jan. 1, 1970,
     measured in seconds.

     If _\bt_\bl_\bo_\bc is nonnull, the return value is also stored in the
     place to which _\bt_\bl_\bo_\bc points.

     The _\bf_\bt_\bi_\bm_\be entry fills in a structure pointed to by its argu-
     ment, as defined by <_\bs_\by_\bs/_\bt_\bi_\bm_\be_\bb._\bh>:

     /*
      * Copyright (c) 1982, 1986 Regents of the University of California.
      * All rights reserved.  The Berkeley software License Agreement
      * specifies the terms and conditions for redistribution.
      *
      *   @(#)timeb.h7.1 (Berkeley) 6/4/86
      */

     /*
      * 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 Day-
     light Saving time applies locally during the appropriate
     part of the year.


Printed 7/9/88		   May 9, 1985				1


TIME(3C)	    UNIX Programmer's Manual		 TIME(3C)


S\bSE\bEE\bE A\bAL\bLS\bSO\bO
     date(1), gettimeofday(2), settimeofday(2), ctime(3)


Printed 7/9/88		   May 9, 1985				2
Commit	Line	Data
ca67e7b4 C	1
	2
	3
	4	TIME(3C) UNIX Programmer's Manual TIME(3C)
	5
	6
	7
	8	N\bNA\bAM\bME\bE
	9	time, ftime - get date and time
	10
	11	S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
	12	l\blo\bon\bng\bg t\bti\bim\bme\be(\b(0\b0)\b)
	13
	14	l\blo\bon\bng\bg t\bti\bim\bme\be(\b(t\btl\blo\boc\bc)\b)
	15	l\blo\bon\bng\bg \bt\btl\blo\boc\bc;\b;
	16
	17	#\b#i\bin\bnc\bcl\blu\bud\bde\be <\b<s\bsy\bys\bs/\b/t\bty\byp\bpe\bes\bs.\b.h\bh>\b>
	18	#\b#i\bin\bnc\bcl\blu\bud\bde\be <\b<s\bsy\bys\bs/\b/t\bti\bim\bme\beb\bb.\b.h\bh>\b>
	19	f\bft\bti\bim\bme\be(\b(t\btp\bp)\b)
	20	s\bst\btr\bru\buc\bct\bt t\bti\bim\bme\beb\bb \bt\btp\bp;\b;
	21
	22	D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
	23	T\bTh\bhe\bes\bse\be i\bin\bnt\bte\ber\brf\bfa\bac\bce\bes\bs a\bar\bre\be o\bob\bbs\bso\bol\ble\bet\bte\bed\bd b\bby\by g\bge\bet\btt\bti\bim\bme\beo\bof\bfd\bda\bay\by(\b(2\b2)\b).\b.
	24
	25	_\bT_\bi_\bm_\be returns the time since 00:00:00 GMT, Jan. 1, 1970,
	26	measured in seconds.
	27
	28	If _\bt_\bl_\bo_\bc is nonnull, the return value is also stored in the
	29	place to which _\bt_\bl_\bo_\bc points.
	30
	31	The _\bf_\bt_\bi_\bm_\be entry fills in a structure pointed to by its argu-
	32	ment, as defined by <_\bs_\by_\bs/_\bt_\bi_\bm_\be_\bb._\bh>:
	33
	34	/*
	35	* Copyright (c) 1982, 1986 Regents of the University of California.
	36	* All rights reserved. The Berkeley software License Agreement
	37	* specifies the terms and conditions for redistribution.
	38	*
	39	* @(#)timeb.h7.1 (Berkeley) 6/4/86
	40	*/
	41
	42	/*
	43	* Structure returned by ftime system call
	44	*/
	45	struct timeb
	46	{
	47	time_t time;
	48	unsigned short millitm;
	49	short timezone;
	50	short dstflag;
	51	};
	52
	53	The structure contains the time since the epoch in seconds,
	54	up to 1000 milliseconds of more-precise interval, the local
	55	time zone (measured in minutes of time westward from
	56	Greenwich), and a flag that, if nonzero, indicates that Day-
	57	light Saving time applies locally during the appropriate
	58	part of the year.
	59
	60
	61
	62
	63	Printed 7/9/88 May 9, 1985 1
	64
65
66
67
68
69
70	TIME(3C) UNIX Programmer's Manual TIME(3C)
71
72
73
74	S\bSE\bEE\bE A\bAL\bLS\bSO\bO
75	date(1), gettimeofday(2), settimeofday(2), ctime(3)
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129	Printed 7/9/88 May 9, 1985 2
130
131
132