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

< cpp‎ | chrono

定义于头文件 `<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_pm` 为 false ，否则结果在范围 `[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