C/C++ Time

1. ctime

如其他 C 库一样， 可以认为 C++ 版本的 header 与 C 版本的 header 相同。

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
/*unspecified*/ put_time(const std::tm* tmb, const CharT* fmt);  since c++11

- 按照 fmt 格式输出 tmb 时间

template 
/*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