time

Name

time - time a simple command or give resource usage

Library

libc.lib

Synopsis

#include <time.h>

time_t time (time_t *tloc);

Return values

On (success,, the, value, of, time, in, seconds, since, the, Epoch, is, returned., On, error,, ((time_t)-1), is, returned,, and, errno, is, set, appropriately.);

Detailed description

The time function returns the value of time in seconds since 0 hours, 0 minutes, 0 seconds, January 1, 1970, Coordinated Universal Time. If an error occurs, time returns the value (time_t-1).

The return value is also stored in * tloc, provided that tloc is non-null.

Examples

/**
* Detailed description : sample usage of time system call
**/
#include <time.h>
int main()
{
  time_t Time ;
  if(time(&Time) < 0 ) 
  {
    printf("Time system call failed \n") ;
    return -1 ;
  }
 printf("Time value is %u \n" , Time) ;
 return 0 ;
}

Output

should print time value since the Epoch (00:00:00 UTC, January 1, 1970),  measured in seconds.

Errors

The time function may fail for any of the reasons described in gettimeofday.

Bugs

Neither -isoC-99 nor -p1003.1-2001 requires time to set errno on failure; thus, it is impossible for an application to distinguish the valid time value -1 (representing the last UTC second of 1969) from the error return value.

Systems conforming to earlier versions of the C and POSIX standards (including older versions of ) did not set * tloc in the error case.

Feedback

For additional information or queries on this page send feedback