C 日期和时间函数

学习C – C日期和时间函数

time.h标头声明产生时间和日期的函数。

获取时间值

返回时间值的最简单的函数具有以下原型：

clock_t clock(void);

这个函数返回一些参考点后的处理器时间。

在程序中的某些进程的开始和结束处，调用clock()函数。

返回值的类型为clock_t，它是在time.h中定义的整数类型。

clock()函数返回的值以时钟刻度来度量。

要将此值转换为秒，请将其除以由time.h中定义的宏CLOCKS_PER_SEC生成的值。

如果发生错误，clock()函数返回-1。

time()函数返回日历时间作为类型为time_t的值。

日历时间是当前时间，通常以特定日期的固定时间为单位，以秒为单位。

固定的时间和日期通常是1970年1月1日00:00:00 GMT，这是时间值的定义的典型。

time()函数的原型是:

time_t time(time_t *timer);

如果参数不为NULL，则当前日历时间也存储在定时器中。

类型time_t在头文件中定义，通常等同于long类型。

要计算time()返回的两个连续time_t值之间的经过时间（秒），可以使用具有此原型的difftime()函数：

double difftime(time_t T2, time_t T1);

该函数将以秒为单位的T2 – T1值返回double类型的值。

该值是在产生time_t值T1和T2的两个time()函数调用之间经过的时间。

例子

#include <stdio.h> 
#include <time.h> 
#include <math.h> 
#include <ctype.h> 

int main(void) { 
  time_t calendar_start = time(NULL);         // Initial calendar time 
  clock_t cpu_start = clock();                // Initial processor time 
  int count = 0;                              // Count of number of loops 
  const long long iterations = 1000000000LL;  // Loop iterations 
  char answer = "y"; 
  double x = 0.0; 
  printf("Initial clock time = %lld Initial calendar time = %lld\n", 
            (long long)cpu_start, (long long)calendar_start); 
  while(tolower(answer) == "y") { 
    for(long long i = 0LL ; i < iterations ; ++i) 
      x = sqrt(3.14159265); 

    printf("%lld square roots completed.\n", iterations*(++count)); 
    printf("Do you want to run some more(y or n)? \n"); 
    scanf("\n%c", &answer, sizeof(answer)); 
  } 

  clock_t cpu_end = clock();                  // Final cpu time 
  time_t calendar_end = time(NULL);           // Final calendar time 

  printf("Final clock time = %lld Final calendar time = %lld\n", 
     (long long)cpu_end, (long long)calendar_end); 
  printf("CPU time for %lld iterations is %.2lf seconds\n", 
     count*iterations, ((double)(cpu_end-cpu_start))/CLOCKS_PER_SEC); 
  printf("Elapsed calendar time to execute the program is %8.2lf seconds.\n", 
     difftime(calendar_end, calendar_start)); 
  return 0; 
} 

上面的代码生成以下结果。

获取日期

要将今天的日期作为字符串，请使用具有此原型的函数ctime()：

char *ctime(const time_t *timer);

该函数接受一个指向time_t变量的指针，作为包含由time()函数返回的日历时间值的参数。

它返回一个指向包含日期，日期，时间和年份的26个字符的字符串的指针，它由换行符’\ 0’终止。

返回的典型字符串可能如下所示：

"Mon Aug 21 11:45:56 2015\n\0" 

ctime()函数不知道分配用于存储结果的字符串长度。

有一个可选的更安全的版本的功能有这个原型：

errno_t ctime_s(char * str, rsize_t size, const time_t *timer);

您可以使用ctime_s()函数，如下所示:

char time_str[30] = {"\0"}; 
time_t calendar = time(NULL); 
if(!ctime_s(time_str, sizeof(time_str), &calendar)) 
   printf_s("%s", time_str); 
else 
   fprintf_s(stderr, "Error converting time_t value\n"); 
   

我们可以通过使用localtime()函数从日历时间值获取时间和日期的各个组件。这有原型：

struct tm *localtime(const time_t *timer);

此函数接受一个指向time_t值的指针，并返回一个指向tm类型的指针，该结构在time.h中定义。

如果定时器无法转换，则返回NULL。

可选版本有原型:

struct tm *localtime_s(const time_t * restrict timer, 
                            struct tm * restrict result); 

两个参数必须为non_NULL。

该结构至少包含下表中列出的成员。

所有的成员都是int类型。

这是一个代码片段，将从tm结构的成员输出日期和日期：

time_t calendar = time(NULL);                 // Current calendar time 
struct tm time_data; 
const char *days[] =   {"Sunday",   "Monday", "Tuesday", "Wednesday", 
                        "Thursday", "Friday", "Saturday"              }; 
const char *months[] = {"January", "February", "March", 
                        "April",    "May",     "June", 
                        "July",    "August",   "September", 
                        "October", "November", "December"  }; 

if(localtime_s(&calendar, &time_data)) 
  printf_s("Today is %s %s %d %d\n", 
                    days[time_data.tm_wday], months[time_data.tm_mon], 
                    time_data.tm_mday,       time_data.tm_year+1900); 

asctime()及其可选的更安全的伙伴asctime_s()生成一个tm结构的字符串表示形式。

它们的原型是:

  
char *asctime(const struct tm *time_data); 
errno_t asctime_s(char *str, rsize_t size, const struct tm *time_data); 

asctime_s()将字符串存储在str中，它必须是至少有26个元素的数组; size是str中元素的数量。

成功时，该函数返回0，失败时返回非零整数。

该函数适用​​于年均1000到9999的tm结构。

结果的字符串与ctime()生成的字符串格式相同。

#include <stdio.h> 
#include <time.h> 

int main(void) 
{ 
  const char *day[7] = { 
                   "Sunday"  , "Monday", "Tuesday", "Wednesday", 
                   "Thursday", "Friday", "Saturday" 
                       }; 
  const char *month[12] = { 
                     "January",   "February", "March",    "April", 
                     "May",       "June",     "July",     "August", 
                     "September", "October",  "November", "December" 
                          }; 
  const char *suffix[] = { "st", "nd", "rd", "th" }; 
  enum sufindex { st, nd, rd, th } sufsel = th;       // Suffix selector 

  struct tm ourT;                                     // The time structure 
  time_t tVal = time(NULL);                           // Calendar time 

  if(!localtime_s(&tVal, &ourT))                      // Populate time structure 
  { 
    fprintf(stderr, "Failed to populate tm struct.\n"); 
    return -1; 
  } 
  switch(ourT.tm_mday) 
  { 
    case 1: case 21: case 31: 
      sufsel= st; 
      break; 
    case 2: case 22: 
      sufsel= nd; 
      break; 
    case 3: case 23: 
      sufsel= rd; 
      break; 
    default: 
      sufsel= th; 
      break; 
  } 

  printf("Today is %s the %d%s %s %d. ", 
      day[ourT.tm_wday], 
      ourT.tm_mday, 
      suffix[sufsel], 
      month[ourT.tm_mon], 
      1900 + ourT.tm_year); 
  printf("The time is %d : %d : %d.\n", 
      ourT.tm_hour, ourT.tm_min, ourT.tm_sec ); 
  return 0; 
}

上面的代码生成以下结果。

获取日期的星期几

您可以使用mktime()函数确定给定日期的星期几。

该函数具有原型:

time_t mktime(struct tm *ptime);

#include <stdio.h> 
#include <time.h> 

int main(void) 
{ 
  const char *day[7] = { 
                   "Sunday"  , "Monday", "Tuesday", "Wednesday", 
                   "Thursday", "Friday", "Saturday" 
                       }; 
  const char *month[12] = { 
                     "January",   "February", "March",    "April", 
                     "May",       "June",     "July",     "August", 
                     "September", "October",  "November", "December" 
                          }; 
  const char *suffix[] = { "st", "nd", "rd", "th" }; 
  enum sufindex { st, nd, rd, th } sufsel = th;  // Suffix selector 

  struct tm birthday = {0};                      // A birthday time structure 
  char name[30] = {"C"}; 

  printf("Enter the birthday as day month year integers separated by spaces." 
             "\ne.g. Enter 1st February 1985 as 1 2 1985 : "); 
  scanf(" %d %d %d", &birthday.tm_mday, &birthday.tm_mon, &birthday.tm_year); 

  birthday.tm_mon -= 1;                          // Month zero-based 
  birthday.tm_year -= 1900;                      // Year relative to 1900 

  if(mktime(&birthday) == - 1) 
  { 
    fprintf_s(stderr, "Operation failed.\n"); 
    return -1; 
  } 

  switch(birthday.tm_mday) 
  { 
    case 1: case 21: case 31: 
      sufsel= st; 
      break; 
    case 2: case 22: 
      sufsel= nd; 
      break; 
    case 3: case 23: 
      sufsel= rd; 
      break; 
    default: 
      sufsel= th; 
      break; 
  } 
  printf("born on the %d%s %s %d, which was a %s.\n", 
                 birthday.tm_mday, suffix[sufsel], month[birthday.tm_mon], 
                            1900 + birthday.tm_year, day[birthday.tm_wday]); 
  return 0; 
} 

上面的代码生成以下结果。