time
From cppreference.com
                    
                                        
                    
                    
                                                            
                    |   Defined in header  
<time.h>
  | 
||
Returns the current calendar time encoded as a time_t object.
Contents | 
[edit] Parameters
| time | - | pointer to a time_t object to store the time in or NULL | 
[edit] Return value
Current calendar time encoded as time_t object on success, (time_t)(-1) on error. If the argument is not NULL, the return value is equal to the value stored in the object pointed to by the argument.
[edit] Notes
The encoding of calendar time in time_t is unspecified, but most systems conform to POSIX specification and return a value of integral type holding the number of seconds since the Epoch. Implementations in which time_t is a 32-bit signed integer (many historical implementations) fail in the year 2038.
[edit] Example
| This section is incomplete Reason: no example  | 
[edit] See also
|    converts time since epoch to calendar time expressed as local time  (function)  | 
|
|    converts time since epoch to calendar time expressed as Universal Coordinated Time  (function)  | 
|