std::chrono::is_am, std::chrono::is_pm, std::chrono::make12, std::chrono::make24

来自cppreference.com
< cpp‎ | chrono
 
 
工具库
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)
(C++20)
swap 与类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
初等字符串转换
(C++17)
(C++17)
 
日期和时间工具
时间点
(C++11)
(C++20)
时长
(C++11)
时钟
(C++11)      
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
当天时刻
is_amis_pm
(C++20)(C++20)
make12make24
(C++20)(C++20)
(C++20)

日历
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)(C++20)
时区
(C++20)
(C++20)
(C++20)
chrono I/O
(C++20)
C 风格日期和时间
 
在标头 <chrono> 定义
constexpr bool is_am( const std::chrono::hours& h ) noexcept;
(1) (C++20 起)
constexpr bool is_pm( const std::chrono::hours& h ) noexcept;
(2) (C++20 起)
constexpr std::chrono::hours make12( const std::chrono::hours& h ) noexcept;
(3) (C++20 起)
constexpr std::chrono::hours make24( const std::chrono::hours& h,
                                     bool is_pm ) noexcept;
(4) (C++20 起)

这些函数辅助在 12 时格式与 24 时格式的日之时间之间翻译。

1) 检测 24 时格式时间是否为 a.m. ( ante meridiem ,午前)。
2) 检测 24 时格式时间是否为 p.m. ( post meridiem ,午后)。
3) 返回 24 时格式时间的 12 时等价版本。
4) 返回 12 时格式时间 h 的 24 时等价版本,其中 is_pm 确定时间是否为 p.m. 。

参数

h - 要检测的 12 时或 24 时格式时间
is_pm - 确定 12 时格式时间是否为 p.m.

返回值

1) 0h <= h && h <= 11h
2) 12h <= h && h <= 23h
3)h 在范围 [0h, 23h] 内,则返回范围 [1h, 12h] 内的 12 时等价版本。否则返回值未指定。
4)h 在范围 [1h, 12h] 内,则返回范围 [0h, 11h] 内的 24 时等价版本,若 is_pmfalse ,否则结果在范围 [12h, 23h] 内。否则返回值未指定。

示例

#include <iostream>
#include <iomanip>
#include <utility>
#include <chrono>
 
int main()
{
    using namespace std::chrono;
 
    static_assert(
        is_am(10h) &&  is_am(11h) && !is_am(12h) && !is_am(23h) &&
       !is_pm(10h) && !is_pm(11h) &&  is_pm(12h) &&  is_pm(23h)
    );
 
    std::cout << "make12():\n";
 
    for (const hours hh : { 0h, 1h, 11h, 12h, 13h, 23h }) {
        const hours am{make12(hh)};
        std::cout << std::setw(2) << hh.count() << "h == "
                  << std::setw(2) << am.count() << (is_am(hh) ? "h a.m.\n" : "h p.m.\n");
    }
 
    std::cout << "\nmake24():\n";
 
    using p = std::pair<hours, bool>;
 
    for (const auto& [hh, pm] : { p{1h, 0}, p{12h, 0}, p{1h, 1}, p{12h, 1} }) {
        std::cout << std::setw(2) << hh.count()
                  << (pm ? "h p.m." : "h a.m.")
                  << " == " << std::setw(2)
                  << make24(hh, pm).count() << "h\n";
    }
}

输出:

make12():
 0h == 12h a.m.
 1h ==  1h a.m.
11h == 11h a.m.
12h == 12h p.m.
13h ==  1h p.m.
23h == 11h p.m.
 
make24():
 1h a.m. ==  1h
12h a.m. ==  0h
 1h p.m. == 13h
12h p.m. == 12h