Linux time functions

Source: Internet
Author: User
Tags ranges time and date

Asctime
Ctime
Gettimeofday
Gmtime
Localtime
Mktime
Settimeofday
Time

Asctime (represents the time and date in string format)
Related functions Time, ctime, gmtime, localtime
Header file # Include <time. h>
Define functions Char * asctime (const struct TM * timeptr );
Function Description Asctime () converts the information in the TM structure referred to by the timeptr parameter to the time and date representation method used in the real world, and then returns the result in string form. This function has been converted from the time zone to the local time. The string format is "wed Jun 30 21:49:08 1993/N"
Return Value If you call the related time and date functions again, this string may be damaged. The difference between this function and ctime is that the input parameters are different structures.
Additional instructions Returns a string representing the current local time and date.
Example # Include <time. h>
Main ()
{
Time_t timep;
Time (& timep );
Printf ("% s", asctime (gmtime (& timep )));
}
Run Sat Oct 28 02:10:06 2000
 




Ctime (Representation of time and date in string format)
Related functions Time, asctime, gmtime, localtime
Header file # Include <time. h>
Define functions Char * ctime (const time_t * timep );
Function Description Ctime () converts the information in the time_t structure referred to by the timep parameter to the time and date representation method used in the real world, and then returns the result in string form. This function has been converted from the time zone to the local time. The string format is "wed Jun 30 21: 49: 08 1993/N ". If you call the related time and date functions again, this string may be damaged.
Return Value Returns a string representing the current local time and date.
Example # Include <time. h>
Main ()
{
Time_t timep;
Time (& timep );
Printf ("% s", ctime (& timep ));
}
Run Sat Oct 28 10: 12: 05 2000
 




Gettimeofday (get current time)
Related functions Time, ctime, ftime, settimeofday
Header file # Include <sys/time. h>
# Include <unistd. h>
Define functions Int gettimeofday (struct timeval * TV, struct timezone * tz)
Function Description Gettimeofday () will return the current time with the structure indicated by TV, and put the information of the local time zone in the structure indicated by tz.
The timeval structure is defined:
Struct timeval {
Long TV _sec;/* seconds */
Long TV _usec;/* microseconds */
};
The timezone structure is defined:
Struct timezone {
Int tz_minuteswest;/* the time difference between Greenwich and */
Int tz_dsttime;/* state of daylight saving time */
};
The above two structures are defined in/usr/include/sys/time. h. The status of tz_dsttime is as follows:
Dst_none/* not used */
Dst_usa/* United States */
Dst_aust/* Australia */
Dst_wet/* Western Europe */
Dst_met/* Central Europe */
Dst_eet/* Eastern Europe */
Dst_can/* Canada */
Dst_gb/* Great Britain */
Dst_rum/* Romania */
Dst_tur/* Turkey */
Dst_austalt/* Australia (after January 1, 1986 )*/
Return Value If the call succeeds, 0 is returned. If the call fails,-1 is returned. The error code is stored in errno. Note that the memory space specified by the efault pointer TV and TZ exceeds the access permission.
Example # Include <sys/time. h>
# Include <unistd. h>
Main (){
Struct timeval TV;
Struct timezone TZ;
Gettimeofday (& TV, & Tz );
Printf ("TV _sec; % d/N", TV,. TV _sec );
Printf ("TV _usec; % d/N", TV. TV _usec );
Printf ("tz_minuteswest; % d/N", tz. tz_minuteswest );
Printf ("tz_dsttime, % d/N", tz. tz_dsttime );
}
Run TV _sec: 974857339
TV _usec: 136996
Tz_minuteswest:-540
Tz_dsttime: 0
 




Gmtime (get current time and date)
Related functions Time, asctime, ctime, localtime
Header file # Include <time. h>
Define functions Struct TM * gmtime (const time_t * timep );
Function Description Gmtime () converts the information in the time_t structure referred to by the timep parameter to the time and date representation method used in the real world, and then returns the result from the structure TM.
The structure TM is defined
Struct TM
{
Int tm_sec;
Int tm_min;
Int tm_hour;
Int tm_mday;
Int tm_mon;
Int tm_year;
Int tm_wday;
Int tm_yday;
Int tm_isdst;
};
Int tm_sec indicates the current number of seconds. The normal range is 0-59, but the value can be 61 seconds.
Int tm_min indicates the current score, range: 0-59
Int tm_hour, which is counted from midnight, ranges from 0 to 23.
The number of days in the current month of int tm_mday, ranging from 01 to 31.
Int tm_mon indicates the current month. The value ranges from 0 to 11 from January 1, January.
Int tm_year: The number of years since January 1, 1900
The number of days in a week for int tm_wday. The value ranges from 0 to 6 from Monday.
Int tm_yday indicates the number of days since January 1, January 1 this year. The value range is 0-365.
Int tm_isdst time saving flag
The time and date returned by this function are not converted by the time zone, but UTC time.
Return Value The returned structure TM indicates the current UTC time.
Example # Include <time. h>
Main (){
Char * wday [] = {"sun", "mon", "Tue", "wed", "Thu", "fri", "sat "};
Time_t timep;
Struct TM * P;
Time (& timep );
P = gmtime (& timep );
Printf ("% d", (1900 + P-> tm_year), (1 + P-> tm_mon), p-> tm_mday );
Printf ("% S % d; % d/N", wday [p-> tm_wday], p-> tm_hour, p-> tm_min, p-> tm_sec );
}
Run 2000/10/28 sat 8:15:38
 




Localtime (obtain the current local time and date)
Related functions Time, asctime, ctime, gmtime
Header file # Include <time. h>
Define functions Struct TM * localtime (const time_t * timep );
Function Description Localtime () converts the information in the time_t structure referred to by the timep parameter to the time and date representation method used in the real world, and then returns the result from the TM structure. For the definition of the structure TM, see gmtime (). The time date returned by this function has been converted to the local time zone.
Return Value The returned structure TM indicates the current local time.
Example # Include <time. h>
Main (){
Char * wday [] = {"Sun", "mon", "Tue", "wed", "Thu", "Fri", "sat "};
Time_t timep;
Struct TM * P;
Time (& timep );
P = localtime (& timep);/* obtain the local time */
Printf ("% d", (1900 + P-> tm_year), (L + P-> tm_mon), p-> tm_mday );
Printf ("% S % d: % d/N", wday [p-> tm_wday], p-> tm_hour, p-> tm_min, p-> tm_sec );
}
Run 2000/10/28 sat 11:12:22
 




Mktime (the number of seconds after the time structure data is converted)
Related functions Time, asctime, gmtime, localtime
Header file # Include <time. h>
Define functions Time_t mktime (strcut TM * timeptr );
Function Description Mktime () is used to convert the TM structure data referred to by the timeptr parameter to the number of seconds that have elapsed since 00:00:00, January 1, January 1, 1970 AD.
Return Value Returns the number of seconds that have elapsed.
Example /* Obtain the time (in seconds) with time (), and use localtime ()
Convert to struct TM and then use mktine () to convert struct TM to the original number of seconds */
# Include <time. h>
Main ()
{
Time_t timep;
Strcut TM * P;
Time (& timep );
Printf ("Time (): % d/N", timep );
P = localtime (& timep );
Timep = mktime (P );
Printf ("Time ()-> localtime ()-> mktime (): % d/N", timep );
}
Run Time (): 974943297
Time ()-> localtime ()-> mktime (): 974943297
 




Settimeofday (set the current time)
Related functions Time, ctime, ftime, gettimeofday
Header file # Include <sys/time. h>
# Include <unistd. h>
Define functions Int settimeofday (const struct timeval * TV, const struct timezone * tz );
Function Description Settimeofday () sets the current time to the structure information indicated by TV, and the local time zone information to the structure indicated by tz. For more information, see gettimeofday (). Note: Only the root permission can use this function to modify the time.
Return Value If the call succeeds, 0 is returned. If the call fails,-1 is returned. The error code is stored in errno.
Error Code The root permission of eperm is not enough to call settimeofday.
The einval time zone or data is incorrect and the time cannot be set correctly.
 




Time (obtain the current time)
Related functions Ctime, ftime, gettimeofday
Header file # Include <time. h>
Define functions Time_t time (time_t * t );
Function Description This function returns the number of seconds that have elapsed since January 1, 1970 ad utc time since 00:00:00. If t is not a null pointer, this function also saves the returned value to the memory indicated by T pointer.
Return Value The number of seconds is returned for success, and (time_t)-1) is returned for failure. The cause of the error is stored in errno.
Example # Include <time. h>
Mian ()
{
Int seconds = Time (time_t *) null );
Printf ("% d/N", seconds );
}
Run 9.73e + 08

 

Reference: http://hi.baidu.com/joshualmf1984/blog/item/2074d7ca70e51f43f21fe7de.html

Related Article

Contact Us

The content source of this page is from Internet, which doesn't represent Alibaba Cloud's opinion; products and services mentioned on that page don't have any relationship with Alibaba Cloud. If the content of the page makes you feel confusing, please write us an email, we will handle the problem within 5 days after receiving your email.

If you find any instances of plagiarism from the community, please send an email to: info-contact@alibabacloud.com and provide relevant evidence. A staff member will contact you within 5 working days.

A Free Trial That Lets You Build Big!

Start building with 50+ products and up to 12 months usage for Elastic Compute Service

  • Sales Support

    1 on 1 presale consultation

  • After-Sales Support

    24/7 Technical Support 6 Free Tickets per Quarter Faster Response

  • Alibaba Cloud offers highly flexible support services tailored to meet your exact needs.