1. ctime
如其他 C 库一样， 可以认为 C++ 版本的 header <ctime> 与 C 版本的 header <time.h> 相同。
std::time_t
是整数类型，数值等于自 00:00, Jan 1 1970 UTC (epoch) 以来的秒数
std::time_t time(std::time_t* arg)
- 返回当前时间，同时也会保存在 arg 所指的 std::time_t 中（如果 arg 非空
- 通常使用中 arg 都是空，即 std::time_t t = std::time(0)
std::tm* localtime(const std::time_t* time);
- 将 std::time_t 转换成 std::tm 时间，用 local time 表示
- 成功返回 std::tm 指针，失败返回 NULL
- 返回的 std::tm 结构在 std::gmtime、std::localtime、std::ctime 共享
- 不是 thread-safe 的
std::tm* gmtime(const std::time_t* time);
- 类似 localtime
- 将 std::time_t 转换成 std::tm 时间，用 Coordinated Universal Time (UTC) 表示
std::size)t strftime(char* str, std::size_t count, const char* format, const std::tm* time);
- 将 time 按照 format 格式转化成字符串，以 null 终止
- 返回字符串大小
char* asctime(const std::tm* time_ptr);
- 将 std::tm 时间转化成字符串，格式为 Www Mmm dd hh:mm:ss yyyy\n
char* ctime(const std::time_t* time)
- 将 std::time_t 转化成字符转，格式为 Www Mmm dd hh:mm:ss yyyy
- 相当于 std::asctime(std::localtime(time))
std::time_t mktime(std::tm* time);
- 将 std::tm 时间转化成 std::time_t 格式，忽略 time->tm_wday 和 time->tm_yday
double difftime(std::time_t time_end, std::time_t time_beg);
- 计算两个时间差，以秒计算
- 这个函数保留了 std::time_t 的抽象
char* strptime(const char* s, const char* format, struct tm* tm);
- 在 time.h 有定义，ctime 没有
- 按照 format 格式解析 s 字符串，将结果时间保存到 tm
- 成功返回 s 中被消费的字符后一位，如果完全消费完，返回最后一个 null byte
- 失败返回 NULL
time_t convert_http_date(const char *str_http_date)
{
if (str_http_date == NULL) {
return (time_t)-1;
}
char *fmt[] = {
"%a, %d %b %Y %H:%M:%S", // Sun, 06 Nov 1994 08:49:37 GMT
"%a, %d-%b-%y %H:%M:%S", // Sunday, 06-Nov-94 08:49:37 GMT
"%a %b %d %H:%M:%S %Y" // Sun Nov 6 08:49:37 1994
};
struct tm tm;
for (size_t i = 0; i < sizeof(fmt) / sizeof(fmt[0]); i++) {
if (strptime(str_http_date, fmt[i], &tm)) {
// UTC ---> UTC+8
tm.tm_hour = (tm.tm_hour + 8) % 24;
return mktime(&tm);
}
}
return (time_t)-1;
}
2. iomanip && locale
template<class CharT>
/*unspecified*/ put_time(const std::tm* tmb, const CharT* fmt); since c++11
- 按照 fmt 格式输出 tmb 时间
template <class CharT>
/*unspecified*/ std::get_time()std::tm* tmb, const CharT* fmt); since c++11
- std::istream >> get_time(tmb, fmt)
- 按照 fmt 的格式解析时间，保存到 tmb
3. chrono
static std::chrono::system_clock::time_point from_time_t( std::time_t t ); since c++11
- std::chrono::system_clock 的工厂方法
- 把 std::time_t 转化成 std::chrono::system_clock::time_point
static std::time_t to_time_t( const std::chrono::system_clock::time_point& t ); since c++11
- std::chrono::system_clock 工厂方法
- 把 time_point 转化成 std::time_t
