C++ 函数 strftime 和时间格式示例详解

C++ 函数 strftime 详解

一、函数原型

#include <ctime>
size_t strftime(
    char* str,
    size_t maxsize,
    const char* format,
    const struct tm* timeptr
);

• str：指向存储结果的字符数组的指针。
• maxsize：字符数组的大小，即最多能存储的字符数（包括终止的空字符）。
• format：格式字符串，指定了日期和时间的格式。
• timeptr：指向包含日期和时间信息的 struct tm 结构体的指针。

二、功能描述

strftime 函数根据 format 字符串中指定的格式，将 timeptr 指向的 struct tm 结构体中的日期和时间信息格式化后存储到 str 指向的字符数组中。如果结果字符串的长度（不包括终止的空字符）小于 maxsize，则会在字符串末尾添加一个空字符作为终止符。如果结果字符串的长度等于或大于 maxsize，则结果会被截断，并且不会在末尾添加空字符。

三、格式字符串说明

格式字符串 format 可以包含转换说明符和普通字符。转换说明符以百分号（%）开始，后跟一个或多个字符，用于指定日期和时间的格式。常见的转换说明符包括：

%a：星期几的缩写（如 Sun）。
%A：星期几的全称（如 Sunday）。
%b：月份的缩写（如 Jan）。
%B：月份的全称（如 January）。
%c：本地相应的日期和时间表示。
%d：月份中的天数（01-31）。
%H：小时（24小时制，00-23）。
%I：小时（12小时制，01-12）。
%j：一年中的天数（001-366）。
%m：月份（01-12）。
%M：分钟（00-59）。
%p：本地 AM 或 PM 的相应符。
%S：秒（00-60，允许闰秒）。
%U：一年中的第几周（00-53，星期天为每周的第一天）。
%w：星期几（0-6，星期天为 0）。
%W：一年中的第几周（00-53，星期一为每周的第一天）。
%x：本地相应的日期表示。
%X：本地相应的时间表示。
%y：年份的最后两位数（00-99）。
%Y：完整年份。
%%：一个百分号。

四、返回值

strftime 函数返回存储在 str 中的字符数（不包括终止的空字符）。如果返回值等于 0，则表示出现了错误。

五、示例代码

#include <iostream>
#include <iomanip>
#include <ctime>
int main() {
    std::time_t t = std::time(nullptr);
    std::tm* now = std::localtime(&t);
    char buffer[100];
    std::strftime(buffer, sizeof(buffer), "%Y-%m-%d %H:%M:%S", now);
    std::cout << "Formatted time: " << buffer << std::endl;
    return 0;
}

这段代码将当前时间格式化为 YYYY-MM-DD HH:MM:SS 的形式，并输出到控制台。

strftime 是 C/C++ 标准库中用于格式化日期和时间的函数，定义在 <ctime> 头文件中。它将 tm 结构体中的时间信息转换为指定格式的字符串，是处理时间输出的核心工具。

到此这篇关于C++ 函数 strftime 和时间格式详解的文章就介绍到这了,更多相关C++ 函数 strftime内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！