Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
TIME(2)			      System Calls Manual		       TIME(2)

NAME
       time, ftime - get date and time

SYNOPSIS
       long time(0)

       long time(tloc)
       long *tloc;

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

DESCRIPTION
       Time  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 de-
       fined by	_sys/timeb.h_:

       /*-
	* SPDX-License-Identifier: BSD-3-Clause
	*
	* Copyright (c)	1991, 1993
	*   The	Regents	of the University of California.  All rights reserved.
	* (c) UNIX System Laboratories,	Inc.
	* All or some portions of this file are	derived	from material licensed
	* to the University of California by American Telephone	and Telegraph
	* Co. or Unix System Laboratories, Inc.	and are	reproduced herein with
	* the permission of UNIX System	Laboratories, Inc.
	*
	* Redistribution and use in source and binary forms, with or without
	* modification,	are permitted provided that the	following conditions
	* are met:
	* 1. Redistributions of	source code must retain	the above copyright
	*    notice, this list of conditions and the following disclaimer.
	* 2. Redistributions in	binary form must reproduce the above copyright
	*    notice, this list of conditions and the following disclaimer in the
	*    documentation and/or other	materials provided with	the distribution.
	* 3. Neither the name of the University	nor the	names of its contributors
	*    may be used to endorse or promote products	derived	from this software
	*    without specific prior written permission.
	*
	* THIS SOFTWARE	IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
	* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING,	BUT NOT	LIMITED	TO, THE
	* IMPLIED WARRANTIES OF	MERCHANTABILITY	AND FITNESS FOR	A PARTICULAR PURPOSE
	* ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
	* FOR ANY DIRECT, INDIRECT, INCIDENTAL,	SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
	* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
	* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
	* HOWEVER CAUSED AND ON	ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	* LIABILITY, OR	TORT (INCLUDING	NEGLIGENCE OR OTHERWISE) ARISING IN ANY	WAY
	* OUT OF THE USE OF THIS SOFTWARE, EVEN	IF ADVISED OF THE POSSIBILITY OF
	* SUCH DAMAGE.
	*
	*   @(#)timeb.h8.2 (Berkeley) 1/21/94
	* $FreeBSD$
	*/

       #ifndef _SYS_TIMEB_H_
       #define _SYS_TIMEB_H_

       #ifdef __GNUC__
       #warning	"this file includes <sys/timeb.h> which	is deprecated"
       #endif

       #include	<sys/_types.h>

       #ifndef _TIME_T_DECLARED
       typedef	     __time_ttime_t;
       #define	     _TIME_T_DECLARED
       #endif

       /* The ftime(2) system call structure --	deprecated. */
       struct timeb {
	    time_t   time;/* seconds since the Epoch */
	    unsigned short millitm;/* +	milliseconds since the Epoch */
	    short    timezone;/* minutes west of CUT */
	    short    dstflag;/*	DST == non-zero	*/
       };

       #ifndef _KERNEL
       #include	<sys/cdefs.h>

       __BEGIN_DECLS
       int ftime(struct	timeb *);
       __END_DECLS
       #endif /* _KERNEL */

       #endif /* !_SYS_TIMEB_H_	*/

       The structure contains the time since the epoch in seconds, up to  1000
       milliseconds  of	more-precise interval, the local timezone (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.

SEE ALSO
       date(1),	stime(2), ctime(3)

ASSEMBLER
       (ftime =	35.)
       sys ftime; bufptr

       (time = 13.; obsolete call)
       sys time
       (time since 1970	in r0-r1)

								       TIME(2)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | ASSEMBLER

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=time&sektion=2&manpath=Unix+Seventh+Edition>

home | help