C 库函数 - strftime()

描述

C 库函数 size_t strftime(char str, size_t maxsize, const char format, const struct tm *timeptr) 根据 format 中定义的格式化规则，格式化结构 timeptr 表示的时间，并把它存储在 str 中。

声明

下面是 strftime() 函数的声明。

  1. size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr)

参数

  • str — 这是指向目标数组的指针，用来复制产生的 C 字符串。
  • maxsize — 这是被复制到 str 的最大字符数。

  • format — 这是 C 字符串，包含了普通字符和特殊格式说明符的任何组合。这些格式说明符由函数替换为表示 tm 中所指定时间的相对应值。格式说明符是：

    说明符替换为实例
    %a缩写的星期几名称 Sun
    %A完整的星期几名称 Sunday
    %b缩写的月份名称 Mar
    %B完整的月份名称 March
    %c日期和时间表示法 Sun Aug 19 02:56:02 2012
    %d一月中的第几天（01-31）19
    %H24 小时格式的小时（00-23）14
    %I12 小时格式的小时（01-12）05
    %j一年中的第几天（001-366）231
    %m十进制数表示的月份（01-12）08
    %M分（00-59）55
    %pAM 或 PM 名称PM
    %S秒（00-61）02
    %U一年中的第几周，以第一个星期日作为第一周的第一天（00-53）33
    %w十进制数表示的星期几，星期日表示为 0（0-6）4
    %W一年中的第几周，以第一个星期一作为第一周的第一天（00-53）34
    %x日期表示法08/19/12
    %X时间表示法02:50:06
    %y年份，最后两个数字（00-99）01
    %Y年份2012
    %Z时区的名称或缩写CDT
    %%一个 % 符号%

  • timeptr — 这是指向 tm 结构的指针，该结构包含了一个呗分解为以下各部分的日历时间：

  1. struct tm {
  2.    int tm_sec;         /* 秒，范围从 0 到 59                */
  3.    int tm_min;         /* 分，范围从 0 到 59                */
  4.    int tm_hour;        /* 小时，范围从 0 到 23                */
  5.    int tm_mday;        /* 一月中的第几天，范围从 1 到 31                    */
  6.    int tm_mon;         /* 月份，范围从 0 到 11                */
  7.    int tm_year;        /* 自 1900 起的年数                */
  8.    int tm_wday;        /* 一周中的第几天，范围从 0 到 6                */
  9.    int tm_yday;        /* 一年中的第几天，范围从 0 到 365                    */
  10.    int tm_isdst;       /* 夏令时                        */    
  11. };

返回值

如果产生的 C 字符串小于 size 个字符（包括空结束字符），则会返回复制到 str 中的字符总数（不包括空结束字符），否则返回零。

实例

下面的实例演示了 strftime() 函数的用法。

  1. #include <stdio.h>
  2. #include <time.h>
  4. int main ()
  5. {
  6.    time_t rawtime;
  7.    struct tm *info;
  8.    char buffer[80];
  10.    time( &rawtime );
  12.    info = localtime( &rawtime );
  14.    strftime(buffer, 80, "%Y-%m-%d %H:%M:%S", info);
  15.    printf("格式化的日期 & 时间 : |%s|\n", buffer );
  17.    return(0);
  18. }

让我们编译并运行上面的程序，这将产生以下结果：

  1. 格式化的日期 & 时间 : |2018-09-19 08:59:07|