KHolidays::AstroSeasons Class
Represents and manages the Astronomical Seasons (solstices and equinoxes). More...
| Header: | #include <KHolidays/AstroSeasons> |
| CMake: | find_package(KF6 REQUIRED COMPONENTS Holidays)target_link_libraries(mytarget PRIVATE KF6::Holidays) |
Public Types
| enum | Season { JuneSolstice, DecemberSolstice, MarchEquinox, SeptemberEquinox, None } |
Static Public Members
| KHolidays::AstroSeasons::Season | seasonAtDate(const QDate &date) |
(since 5.50) QDate | seasonDate(KHolidays::AstroSeasons::Season season, int year) |
| QString | seasonName(KHolidays::AstroSeasons::Season season) |
| QString | seasonNameAtDate(const QDate &date) |
Detailed Description
For the purposes of this class, we sometimes use the shorthand of "Season" where we really mean "Astronomical Season".
An Astronomical Season can be one of the following:
- June solstice
- December solstice
- March equinox
- September equinox
A very good description of the astronomical seasons can be read at the Wikipedia, https://en.wikipedia.org/wiki/Seasons
Note that this class represents the "Astronomical Seasons" and not the traditional "Seasons" which vary widely by culture.
Member Type Documentation
enum AstroSeasons::Season
| Constant | Value |
|---|---|
KHolidays::AstroSeasons::JuneSolstice | 0 |
KHolidays::AstroSeasons::DecemberSolstice | 1 |
KHolidays::AstroSeasons::MarchEquinox | 2 |
KHolidays::AstroSeasons::SeptemberEquinox | 3 |
KHolidays::AstroSeasons::None | 4 |
Member Function Documentation
[static] KHolidays::AstroSeasons::Season AstroSeasons::seasonAtDate(const QDate &date)
Return the season for the specified Gregorian date. The enum 'None' is returned if one of the supported seasons does not occur on the date.
date compute the season for the specified Gregorian date.
[static, since 5.50] QDate AstroSeasons::seasonDate(KHolidays::AstroSeasons::Season season, int year)
Return the Gregorian date on which the season occurs in given year.
season Season to return a date for
year Year for which to return the date
This function was introduced in 5.50.
[static] QString AstroSeasons::seasonName(KHolidays::AstroSeasons::Season season)
Return the string representation of season.
season astronomical season.
[static] QString AstroSeasons::seasonNameAtDate(const QDate &date)
Return the season as a text string for the specified date. A null string is returned if one of the supported seasons does not occur on the date.
date compute the season for the specified Gregorian date.