通过

year_month_weekday 类

  • 项目

表示特定年份、月份和该月的第 n 个工作日。

语法

class year_month_weekday; // C++20

备注

year_month_weekday 支持面向年和月的算术，但不支持面向天的算术。 对于面向天的算术，请使用 sys_days 转换来转换为支持面向天的算数的 sys_days。

year_month_weekday 是一种可完全复制的标准布局类类型。

成员

名称 描述
Constructor 使用指定的月份和工作日构造 year_month_weekday。
index 获取工作日的索引。
month 获取月份值。
ok 检查 year_month_weekday 是否有效。
operator+= 添加指定的月份数或年份数。
operator-= 减去指定的月份数或年份数。
operator local_days 获取从 system_clock 纪元到此 year_month_weekday 的天数作为 local_days。
operator sys_days 获取从 system_clock 纪元到此 year_month_weekday 的天数作为 sys_days。
weekday 获取工作日。
weekday_indexed 获取存储在此 year_month_weekday 中的 [weekday_indexed]。
year 获取年份。

非成员

“属性” 描述
operator+ 添加月份或年份。
operator- 减去月份或年份。
operator== 确定两个 year_month_weekday 值是否相等。
operator<< 将 year_month_weekday 输出到给定流。

要求

标头： <chrono> （自C++20以来）

命名空间：std::chrono

编译器选项： /std:c++latest

构造函数

构造一个 year_month_weekday。

// 1)
year_month_weekday() = default

// 2)
constexpr year_month_weekday(const year& y, const month& m, const weekday_indexed& wdi) noexcept;

// 3) 
constexpr explicit year_month_weekday(const local_days& dp) noexcept;

// 4)
constexpr year_month_weekday(const sys_days& dp) noexcept;

参数

m
month 值。

dp
一个 sys_days 或 local_days

wdi
weekday 值。

y
year 值。

注解：构造函数

1) 默认构造函数不初始化任何字段。

2) 构造与指定 year、month 和 weekday_indexed 相对应的 year_month_weekday。

3) 构造与 sys_days{dp.time_since_epoch()} 所表示日期相对应的 year_month_weekday。

4) 构造与 dp 所表示日期相对应的 year_month_weekday。 对于 ok() 为 true 的任何 year_month_weekday (ymdl)，operator== 与 year_month_weekday{sys_days{ymdl}} 的比较将为 true。

有关用于指定日期的 C++20 语法的信息，请参阅 operator/

示例：创建 year_month_weekday

// compile using: /std:c++latest
#include <iostream>
#include <chrono>

using namespace std::chrono;

int main()
{
    year_month_weekday ymw{1997y / January / Wednesday[1]};
    std::cout << ymw << '\n';
    
    return 0;
}

1997/Jan/Wed[1]

index

获取此 year_month_weekday 中工作日的周索引。

constexpr unsigned index() const noexcept;

返回值

工作日的索引。 例如，如果工作日是该周的第一个星期三，则索引为 1。

month

获取月份值。

constexpr month month() const noexcept;

返回值

month 值。

ok

检查存储在此 year_month_weekday 中的值是否有效。 存储在此 year_month_weekday 中的 year、month 和 weekday_index 必须全部为 ok，此函数才能返回 true。 否则返回 false。

constexpr bool ok() const noexcept;

返回值

如果 year_month_weekday 值有效，则为 true。 否则为 false。
如果 month 有效且 weekday_indexed 有效，则 year_month_weekday 有效。

operator+=

向此 year_month_weekday 添加月份或年份。

1) constexpr year_month_weekday& operator+=(const months& m) noexcept;
2) constexpr year_month_weekday& operator+=(const years& y) noexcept;

参数

m
要添加的月数。

y
要添加的年数。

返回值

*this，反映添加的结果。

示例： operator+=

// compile using: /std:c++latest
#include <iostream>
#include <chrono>

using namespace std::chrono;

int main()
{
    year_month_weekday ymw{1997y / January / Wednesday[1]};
    std::cout << ymw << '\n';

    ymw += months{1};
    ymw += years{1};

    std::cout << ymw << '\n';
    
    return 0;
}

1997/Jan/Wed[1]
1998/Feb/Wed[1]

operator-=

从此 year_month_weekday 减去月份或年份。

1) constexpr year_month_weekday& operator-=(const months& m) noexcept;
2) constexpr year_month_weekday& operator-=(const years& y) noexcept;

参数

m
要减去的月数。

y
要减去的年数。

返回值

*this，反映减去的结果。

示例： operator-=

// compile using: /std:c++latest
#include <iostream>
#include <chrono>

using namespace std::chrono;

int main()
{
    year_month_weekday ymw{1997y / January / Wednesday[1]};
    std::cout << ymw << '\n';

    ymw -= months{1};
    ymw -= years{1};

    std::cout << ymw << '\n';
    
    return 0;
}

1997/Jan/Wed[1]
1995/Dec/Wed[1]

operator local_days

获取从 system_clock 纪元（1970 年 1 月 1 日）到此 year_month_weekday 的天数作为 local_days

constexpr explicit operator local_days() const noexcept;

返回值

如果为 ok()，则返回天数作为 local_days{sys_days{*this}.time_since_epoch()}。 否则，未指定返回值。

operator sys_days

获取从 system_clock 纪元（1970 年 1 月 1 日）到此 year_month_day 的天数作为 sys_days。

constexpr operator sys_days() const noexcept;

返回值

如果为 ok()，则返回 sys_days，其表示 year()/month() 的第一个 weekday() 后 (index() - 1) * 7 天的日期。 如果 index() 为 0，则返回 sys_days，其表示 year()/month() 的第一个 weekday() 前 7 天的日期。

weekday

获取此 year_month_weekday 中存储的 weekday_indexed 中存储的 weekday。

constexpr weekday weekday() const noexcept;

返回值

weekday 值。

weekday_indexed

获取存储在此 year_month_weekday 中的 weekday_indexed。

constexpr weekday_indexed weekday_indexed() const noexcept;

返回值

weekday_indexed 值。

year

获取年份值。

constexpr year year() const noexcept;

返回值

year 值。

另请参阅

<chrono>
year
year_month
year_month_day
year_month_day_last
year_month_weekday_last
operator/头文件引用