A Gregorian UTC minute and its simulator clock-matching rules. More...
#include <utc_time.h>
Public Member Functions | |
| int | dayOfYear () const |
| Return the one-based ordinal day used by simulator clock events. | |
| std::array< UtcEvent, 5 > | events () const |
| Build the ordered simulator event sequence for this UTC minute. | |
| double | absoluteSeconds () const |
| Convert the calendar minute to a monotonically increasing calendar coordinate. | |
| bool | matchesAbsoluteTime (double actual) const |
| Check whether the simulator clock is in the requested UTC minute. | |
| bool | matchesCaptureTime (double actual) const |
| Check the stricter time window used for capture. | |
Static Public Member Functions | |
| static bool | leapYear (int value) |
| Return whether a Gregorian calendar year has 366 days. | |
| static int | daysInMonth (int year, int month) |
| Get the length of a Gregorian calendar month. | |
Data Fields | |
| int | year = 1 |
| int | month = 1 |
| int | day = 1 |
| int | hour = 0 |
| int | minute = 0 |
| std::string | text |
Detailed Description
A Gregorian UTC minute and its simulator clock-matching rules.
text is canonical YYYY-MM-DDTHH:MMZ; absolute seconds are a calendar coordinate, not a monotonic or exposure timestamp.
Definition at line 51 of file utc_time.h.
Member Function Documentation
◆ absoluteSeconds()
|
inline |
Convert the calendar minute to a monotonically increasing calendar coordinate.
Definition at line 84 of file utc_time.h.
◆ dayOfYear()
|
inline |
Return the one-based ordinal day used by simulator clock events.
Definition at line 69 of file utc_time.h.
◆ daysInMonth()
|
inlinestatic |
Get the length of a Gregorian calendar month.
- Parameters
-
year Calendar year. month Validated one-based month (1 through 12).
- Returns
- Days in the requested month.
Only February varies under the Gregorian leap-year rule.
Definition at line 64 of file utc_time.h.
◆ events()
|
inline |
Build the ordered simulator event sequence for this UTC minute.
Definition at line 75 of file utc_time.h.
◆ leapYear()
|
inlinestatic |
Return whether a Gregorian calendar year has 366 days.
Definition at line 56 of file utc_time.h.
◆ matchesAbsoluteTime()
|
inline |
Check whether the simulator clock is in the requested UTC minute.
- Parameters
-
actual Absolute calendar seconds, in the same epoch as absoluteSeconds().
- Returns
- True for a finite time in the half-open minute.
A reading exactly at the next minute belongs to that minute.
Definition at line 94 of file utc_time.h.
◆ matchesCaptureTime()
|
inline |
Check the stricter time window used for capture.
- Parameters
-
actual Absolute calendar seconds.
- Returns
- True only during the first second of the requested minute.
Minute-level matching is sufficient for date validation but not for confirming a capture immediately after zeroing the clock.
Definition at line 103 of file utc_time.h.
Field Documentation
◆ day
| int pangea_survey::UtcDateTime::day = 1 |
Definition at line 52 of file utc_time.h.
◆ hour
| int pangea_survey::UtcDateTime::hour = 0 |
Definition at line 52 of file utc_time.h.
◆ minute
| int pangea_survey::UtcDateTime::minute = 0 |
Definition at line 52 of file utc_time.h.
◆ month
| int pangea_survey::UtcDateTime::month = 1 |
Definition at line 52 of file utc_time.h.
◆ text
| std::string pangea_survey::UtcDateTime::text |
Definition at line 53 of file utc_time.h.
◆ year
| int pangea_survey::UtcDateTime::year = 1 |
Definition at line 52 of file utc_time.h.
The documentation for this struct was generated from the following file:
- modules/pangea/utc_time.h