Classe year_month

Représente un mois et une année. Le jour n’est pas spécifié.

Syntaxe

class year_month; // C++20

Membres

Nom	Description
Constructeurs	Construire un year_month
year	Retourne l’année.
month	Retourne le mois.
ok	Vérifiez que les valeurs et month les year valeurs se trouvent dans la plage valide.
operator+=	Ajoutez le nombre spécifié de mois ou d’années.
operator-=	Soustrait le nombre spécifié de mois ou d’années.

Non-membres

Nom	Description
from_stream	Analyser un year_month flux à partir d’un flux à l’aide du format spécifié
operator+	Ajoutez des mois et/ou des années.
operator-	Soustraire des mois et/ou des années.
operator==	Déterminez si deux year_month valeurs sont égales.
operator<=>	Comparez deux year_month valeurs. Les >, >=, <=, <, != opérateurs sont synthétisés par le compilateur.
operator<<	Sortie d’un year_month flux.

Spécifications

En-tête :<chrono> (depuis C++20)

Espace de noms :std::chrono

Option du compilateur :/std:c++latest

Constructeurs

Construisez un year_month.

1) year_month() = default;
2) constexpr year_month(const year& y, const month& m) noexcept;

Paramètres

y
valeur year.

m
valeur month.

Notes

1) Le constructeur par défaut n’initialise pas la ou month la year valeur.
2) Construisez une year_month avec les valeurs spécifiées.

Pour plus d’informations sur la syntaxe C++20 pour spécifier des dates, consultez operator/

Exemple : Créer un year_month

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

using namespace std::chrono;

int main()
{
    year_month ym{2021y / June};

    std::cout << ym;
    return 0;
}

2021/Jun

month

Obtenez le mois.

constexpr month month() const noexcept;

Valeur retournée

valeur month.

year

Obtenez l’année.

constexpr year year() const noexcept;

Valeur retournée

Le year.

ok

Vérifiez si la valeur de l’année et du mois stockée dans cette year_month plage est valide.

constexpr bool ok() const noexcept;

Valeur retournée

true si les year_month valeurs de l’année et du mois se trouvent dans la plage valide. Sinon, false.

operator+=

Ajoutez des mois ou des années à cela year_month.

1) constexpr year_month& operator+=(const months& dm) noexcept;
2) constexpr year_month& operator+=(const years& dy) noexcept;

Paramètres

dm
Nombre de mois à ajouter.

dy
Nombre d’années à ajouter.

Valeur retournée

*this, qui reflète le résultat de l’ajout.

Exemple : operator +=

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

using namespace std::chrono;

int main()
{
    year_month ym{2021y / June};

    std::cout << ym << '\n';

    ym += months{2};
    ym += years{1};

    std::cout << ym;
    
    return 0;
}

2021/Jun
2022/Aug

operator-=

Soustraire des mois ou des années de ce year_month.

1) constexpr year_month& operator-=(const months& dm) noexcept;
2) constexpr year_month& operator-=(const years& dy) noexcept;

Paramètres

dm
Nombre de mois à soustraire.

dy
Nombre d’années à soustraire.

Valeur retournée

*this, qui reflète le résultat de la soustraction.

Exemple : operator -=

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

using namespace std::chrono;

int main()
{
    year_month ym{2021y / June};

    std::cout << ym << '\n';

    ym -= months{2};
    ym -= years{1};

    std::cout << ym;
    
    return 0;
}

2021/Jun
2020/Apr

Voir aussi

<chrono>
year
year_month_day
year_month_day_last
year_month_weekday
year_month_weekday_last
operator/
Informations de référence sur les fichiers d’en-tête