一、头文件Timestamp.h完整注释语法解析// 1. 预处理指令防止头文件被重复包含现代编译器支持替代传统#ifndef/#define/#endif// 语法#pragma是编译器特定预处理指令once表示该文件仅被包含一次// 作用避免多次包含导致的类重复定义编译错误#pragmaonce// 2. 引入C标准库输入输出流头文件当前头文件未直接使用可移除或保留供后续扩展// 语法#include 头文件名 引入系统标准头文件尖括号用于系统库// 作用提供std::cout、std::endl等输入输出功能#includeiostream// 3. 引入C标准库字符串类头文件// 语法同上string是std::string类的定义所在头文件// 作用支持std::string类型的使用toString()返回值类型#includestring// 4. 定义Timestamp类类是C面向对象的核心封装数据和行为// 语法class 类名 { 成员声明 }; 类定义以分号结尾// 作用抽象时间戳概念封装时间戳的存储和操作逻辑classTimestamp{// 5. 公有访问控制符public// 语法public: 后续成员函数/变量可被类外部、派生类访问// 作用暴露类的对外接口构造函数、成员函数供外部调用public:// 6. 无参构造函数声明类内声明类外定义// 语法类名() 构造函数无返回值、与类名同名// 作用声明一个无参构造函数用于创建默认时间戳对象初始化为0// 注释补充默认构造函数若未手动定义编译器会自动生成但此处显式声明以明确初始化逻辑Timestamp();//默认构造函数创建时间戳对象默认初始化为 0// 7. 带参显式构造函数声明// 语法explicit 类名(参数类型 参数名) explicit禁止隐式类型转换// 作用声明接收int64_t类型微秒数的构造函数禁止int64_t隐式转为Timestamp对象// 符号解析explicit是C11关键字仅修饰单参数构造函数或无默认值的多参数构造函数explicitTimestamp(int64_tmicroSecondsSinceEpoch);// 显式构造函数防止隐式转换// 8. 静态成员函数声明// 语法static 返回值类型 函数名() static修饰类的静态成员函数// 作用声明一个无需创建对象即可调用的函数用于获取当前系统时间戳// 核心特性静态函数属于类而非对象无this指针不能访问非静态成员变量staticTimestampnow();// 静态成员函数获取当前时间戳无需对象// 9. 常成员函数声明// 语法返回值类型 函数名() const const修饰成员函数为常成员函数// 作用声明将时间戳转为字符串的函数const保证函数内不修改任何非mutable成员变量// 核心特性常对象const Timestamp ts只能调用常成员函数std::stringtoString()const;// 成员函数将时间戳转为字符串const 确保不修改对象// 10. 私有访问控制符private// 语法private: 后续成员仅能被类内部成员函数访问外部和派生类均不可访问// 作用隐藏类的内部数据保证数据封装性仅通过公有函数操作数据private:// 11. 私有成员变量声明// 语法数据类型 变量名_ 下划线结尾是C工程命名规范区分参数和成员变量// 作用存储自Unix纪元1970-01-01 00:00:00 UTC以来的微秒数// 类型解析int64_t是C11固定宽度整数类型64位有符号整数定义在cstdint需确保编译环境支持int64_tmicroSecondsSinceEpoch_;// 存储自 Unix 纪元的微秒数1970-01-01 00:00:00 UTC};二、源文件Timestamp.cpp完整注释语法解析// 1. 引入C标准库时间头文件// 语法#include time.h 引入C标准库头文件提供time()、localtime()、tm结构体等时间相关接口// 作用获取系统时间、解析时间戳为年月日时分秒#includetime.h// 2. 引入自定义头文件// 语法#include 头文件名.h 引入项目内自定义头文件双引号用于本地文件// 作用获取Timestamp类的声明否则类外定义成员函数会编译报错编译器不知道类的结构#includeTimestamp.h// 3. 无参构造函数类外定义// 语法类名::类名() : 成员变量(初始化值) { 函数体 }// 符号解析// - ::作用域解析符明确该构造函数属于Timestamp类类外定义必须加// - :成员初始化列表起始标记在构造函数体执行前初始化成员变量效率高于函数体赋值// - ()构造函数参数列表无参则为空// - _成员变量命名规范下划线结尾区分参数和成员变量// 作用创建Timestamp对象时将microSecondsSinceEpoch_初始化为0Timestamp::Timestamp():microSecondsSinceEpoch_(0){// 4. 空构造函数体// 语法{} 包裹函数执行逻辑此处为空表示无额外操作// 原因初始化工作已在成员初始化列表完成无需函数体赋值}// 5. 带参构造函数类外定义// 语法类名::类名(参数类型 参数名) : 成员变量(参数值) { 函数体 }// 符号解析// - int64_t64位有符号整数类型适配微秒级时间戳的大范围存储// - microSecondsSinceEpoch函数参数小驼峰命名接收外部传入的微秒数// - microSecondsSinceEpoch_类的私有成员变量存储微秒数// 作用根据传入的微秒数初始化Timestamp对象的成员变量Timestamp::Timestamp(int64_tmicroSecondsSinceEpoch):microSecondsSinceEpoch_(microSecondsSinceEpoch){// 6. 空构造函数体初始化工作已完成无额外逻辑}// 7. 静态成员函数now()类外定义// 语法返回值类型 类名::函数名() { 函数体 }// 核心规则静态成员函数类内声明加static类外定义时不加static// 符号解析// - Timestamp返回值类型为Timestamp对象// - ::作用域解析符定位到Timestamp类// 作用获取当前系统时间戳秒级转为Timestamp对象并返回TimestampTimestamp::now(){// 8. 函数体创建并返回当前时间的Timestamp对象// 语法解析// - time(NULL)C标准库函数返回time_t类型本质是long表示自Unix纪元以来的秒数// - Timestamp(time(NULL))调用带参构造函数创建临时Timestamp对象// - return返回语句将临时对象返回C会优化临时对象避免拷贝// 注意因构造函数加了explicit此处time_tlong隐式转int64_t后显式构造对象无隐式转换符合explicit设计returnTimestamp(time(NULL));}// 9. 常成员函数toString()类外定义// 语法返回值类型 类名::函数名() const { 函数体 }// 核心规则const修饰符类内声明和类外定义必须同时保留// 符号解析// - std::string返回值类型为std命名空间下的string类// - ::作用域解析符定位到std命名空间std::string和Timestamp类Timestamp::toString// - const保证函数内不修改任何非mutable成员变量// 作用将微秒级时间戳转为年/月/日 时:分:秒格式的字符串std::stringTimestamp::toString()const{// 10. 定义字符数组缓冲区// 语法char 数组名[长度] {0}; 栈上分配字符数组{0}初始化所有元素为0// 符号解析// - []数组长度定义符128表示数组可存储127个有效字符1个结束符\0// - {0}数组初始化规则第一个元素设为0其余自动初始化为0避免垃圾值// 作用存储格式化后的时间字符串charbuf[128]{0};// 11. 将微秒时间戳转为本地时间结构体// 语法解析// - localtime(const time_t* timer)C标准库函数接收秒级时间戳地址返回tm结构体指针本地时区// - microSecondsSinceEpoch_取地址符获取成员变量的内存地址// - tm*指向tm结构体的指针*表示指针类型存储变量地址// - 注意BUGmicroSecondsSinceEpoch_是微秒数需先转为秒数除以1e6否则时间解析错误tm*tm_timelocaltime(microSecondsSinceEpoch_);// 12. 格式化时间字符串到缓冲区// 语法解析// - snprintf(char* buf, size_t size, const char* format, ...)安全格式化函数避免缓冲区溢出// - 格式化符号%4d4位整数、%02d2位整数不足补0// - -指针成员访问符通过tm结构体指针访问成员如tm_time-tm_year// 字段解析// - tm_year 1900tm_year存储1900年以来的年数1900得到实际年份// - tm_mon 1tm_mon存储0-1101月1得到实际月份// - tm_mday当月日期1-31// - tm_hour小时0-23// - tm_min分钟0-59// - tm_sec秒0-6060为闰秒snprintf(buf,128,%4d/%02d/%02d %02d:%02d:%02d,tm_time-tm_year1900,tm_time-tm_mon1,tm_time-tm_mday,tm_time-tm_hour,tm_time-tm_min,tm_time-tm_sec);// 13. 返回格式化后的字符串// 语法解析// - return bufchar[]隐式转为const char*调用std::string的构造函数接收const char*返回string对象// 作用将字符数组转为std::string并返回returnbuf;}三、核心语法符号总结符号/语法作用出现位置#pragma once预处理指令防止头文件重复包含头文件开头#include预处理指令引入头文件系统库/自定义头文件/源文件开头class定义类封装数据和行为头文件Timestamp类定义public/private访问控制符控制成员的访问权限类内成员分组::作用域解析符定位类/命名空间的成员类外定义成员函数Timestamp::、std::string:成员初始化列表起始标记构造函数体执行前初始化成员变量构造函数定义()函数参数列表/函数调用/初始化值包裹构造函数、now()、toString(){}函数体/代码块/数组初始化包裹所有函数体、数组初始化explicit禁止构造函数的隐式类型转换带参构造函数声明static修饰静态成员函数属于类而非对象now()声明const修饰常成员函数保证不修改成员变量toString()声明/定义int64_tC11固定宽度整数类型64位有符号适配大范围时间戳存储成员变量、构造函数参数取地址符获取变量的内存地址localtime(microSecondsSinceEpoch_)*指针类型标记存储变量地址tm* tm_time-指针成员访问符通过指针访问结构体/类成员tm_time-tm_year[]数组长度定义/数组下标访问char buf[128]return函数返回语句返回指定类型的值/对象now()、toString()四、关键问题修正新手必看源文件中有2个核心BUG运行会导致时间显示错误需修正微秒转秒now()函数time(NULL)返回秒数需转为微秒数×1000000否则时间戳单位不匹配TimestampTimestamp::now(){// 秒转微秒适配成员变量的微秒单位int64_tmicro_secstatic_castint64_t(time(NULL))*1000000;returnTimestamp(micro_sec);}localtime传入微秒数toString()函数localtime需要秒数需将微秒数转为秒数后传入// 修正先转秒数再取地址int64_tsecmicroSecondsSinceEpoch_/1000000;tm*tm_timelocaltime(reinterpret_castconsttime_t*(sec));