LSST Applications
21.0.0+04719a4bac,21.0.0-1-ga51b5d4+f5e6047307,21.0.0-11-g2b59f77+a9c1acf22d,21.0.0-11-ga42c5b2+86977b0b17,21.0.0-12-gf4ce030+76814010d2,21.0.0-13-g1721dae+760e7a6536,21.0.0-13-g3a573fe+768d78a30a,21.0.0-15-g5a7caf0+f21cbc5713,21.0.0-16-g0fb55c1+b60e2d390c,21.0.0-19-g4cded4ca+71a93a33c0,21.0.0-2-g103fe59+bb20972958,21.0.0-2-g45278ab+04719a4bac,21.0.0-2-g5242d73+3ad5d60fb1,21.0.0-2-g7f82c8f+8babb168e8,21.0.0-2-g8f08a60+06509c8b61,21.0.0-2-g8faa9b5+616205b9df,21.0.0-2-ga326454+8babb168e8,21.0.0-2-gde069b7+5e4aea9c2f,21.0.0-2-gecfae73+1d3a86e577,21.0.0-2-gfc62afb+3ad5d60fb1,21.0.0-25-g1d57be3cd+e73869a214,21.0.0-3-g357aad2+ed88757d29,21.0.0-3-g4a4ce7f+3ad5d60fb1,21.0.0-3-g4be5c26+3ad5d60fb1,21.0.0-3-g65f322c+e0b24896a3,21.0.0-3-g7d9da8d+616205b9df,21.0.0-3-ge02ed75+a9c1acf22d,21.0.0-4-g591bb35+a9c1acf22d,21.0.0-4-g65b4814+b60e2d390c,21.0.0-4-gccdca77+0de219a2bc,21.0.0-4-ge8a399c+6c55c39e83,21.0.0-5-gd00fb1e+05fce91b99,21.0.0-6-gc675373+3ad5d60fb1,21.0.0-64-g1122c245+4fb2b8f86e,21.0.0-7-g04766d7+cd19d05db2,21.0.0-7-gdf92d54+04719a4bac,21.0.0-8-g5674e7b+d1bd76f71f,master-gac4afde19b+a9c1acf22d,w.2021.13
LSST Data Management Base Package
|
Class for handling dates/times, including MJD, UTC, and TAI. More...
#include <DateTime.h>
Public Types | |
enum | DateSystem { JD = 0 , MJD , EPOCH } |
enum | Timescale { TAI = 5 , UTC , TT } |
Public Member Functions | |
DateTime () | |
Default constructor: construct an invalid DateTime. More... | |
DateTime (long long nsecs, Timescale scale=TAI) | |
Construct a DateTime from nanoseconds since the unix epoch. More... | |
DateTime (double date, DateSystem system=MJD, Timescale scale=TAI) | |
Construct a DateTime from a double in the specified system and scale. More... | |
DateTime (int year, int month, int day, int hr, int min, int sec, Timescale scale=TAI) | |
Construct a DateTime from year, month, day, etc. More... | |
DateTime (std::string const &iso8601, Timescale scale) | |
Construct a DateTime from an ISO8601 string. More... | |
long long | nsecs (Timescale scale=TAI) const |
Get date as nanoseconds since the unix epoch. More... | |
double | get (DateSystem system=MJD, Timescale scale=TAI) const |
Get date as a double in a specified representation, such as MJD. More... | |
std::string | toString (Timescale scale) const |
Get date as an ISO8601-formatted string. More... | |
struct tm | gmtime (Timescale scale) const |
Get date as a tm struct, with truncated fractional seconds. More... | |
struct timespec | timespec (Timescale scale) const |
Get date as a timespec struct, with time in seconds and nanoseconds. More... | |
struct timeval | timeval (Timescale scale) const |
Get date as a timeval struct, with time in seconds and microseconds. More... | |
bool | isValid () const |
Is this date valid? More... | |
bool | operator== (DateTime const &rhs) const |
std::size_t | hash_value () const noexcept |
Return a hash of this object. More... | |
Static Public Member Functions | |
static DateTime | now (void) |
Return current time as a DateTime. More... | |
static void | initializeLeapSeconds (std::string const &leapString) |
Initialize the leap second table from USNO. More... | |
Static Public Attributes | |
constexpr static long long | invalid_nsecs = std::numeric_limits<std::int64_t>::min() |
Friends | |
class | boost::serialization::access |
Class for handling dates/times, including MJD, UTC, and TAI.
Definition at line 64 of file DateTime.h.
|
explicit |
Default constructor: construct an invalid DateTime.
Definition at line 306 of file DateTime.cc.
Construct a DateTime from nanoseconds since the unix epoch.
[in] | nsecs | integer nanoseconds since the unix epoch; if nsecs == DateTime.invalid_nsecs then the DateTime is invalid, regardless of scale |
[in] | scale | time scale of input (TAI, TT or UTC, default TAI). |
lsst.pex.exceptions.DomainError | if scale is UTC and the date is before 1961-01-01 |
Definition at line 308 of file DateTime.cc.
|
explicit |
Construct a DateTime from a double in the specified system and scale.
[in] | date | specified date |
[in] | system | time system of input (JD, MJD, or [Julian] EPOCH) |
[in] | scale | time scale of input (TAI, TT or UTC, default TAI). |
lsst.pex.exceptions.DomainError | if scale is UTC and the date is before 1961-01-01 |
Definition at line 310 of file DateTime.cc.
lsst::daf::base::DateTime::DateTime | ( | int | year, |
int | month, | ||
int | day, | ||
int | hr, | ||
int | min, | ||
int | sec, | ||
Timescale | scale = TAI |
||
) |
Construct a DateTime from year, month, day, etc.
(tm struct fields)
[in] | year | year; must be in the range [1902, 2261], inclusive. |
[in] | month | month number, where January = 1 |
[in] | day | day of the month (1 to 31). |
[in] | hr | hour (0 to 23) |
[in] | min | minute (0 to 59) |
[in] | sec | integer seconds (0 to 60) |
[in] | scale | time scale of input (TAI, TT or UTC, default TAI). |
lsst.pex.exceptions.DomainError | if year is < 1902 or > 2261, or if scale is UTC and the date is before 1961-01-01 (the start of the leap second table) |
Definition at line 327 of file DateTime.cc.
|
explicit |
Construct a DateTime from an ISO8601 string.
Accepts a restricted subset of ISO8601: yyyy-mm-ddThh:mm:ss.nnnnnnnnnZ where:
[in] | iso8601 | ISO8601 string representation of date and time |
[in] | scale | time scale of input (TAI, TT or UTC, default TAI). |
lsst.pex.exceptions.DomainError | if year is < 1902 or > 2261, or if scale is UTC and the date is before 1961-01-01 (the start of the leap second table) |
Definition at line 385 of file DateTime.cc.
double lsst::daf::base::DateTime::get | ( | DateSystem | system = MJD , |
Timescale | scale = TAI |
||
) | const |
Get date as a double in a specified representation, such as MJD.
[in] | system | desired time system (JD, MJD, or [Julian] EPOCH) |
[in] | scale | desired time scale (TAI, TT or UTC) |
lsst.pex.exceptions.DomainError | if scale is UTC and the UTC date is before 1961-01-01 |
lsst.pex.exceptions.RuntimeError | if DateTime is invalid |
Definition at line 429 of file DateTime.cc.
struct tm lsst::daf::base::DateTime::gmtime | ( | Timescale | scale | ) | const |
Get date as a tm struct, with truncated fractional seconds.
[in] | scale | desired time scale (TAI, TT or UTC) |
lsst.pex.exceptions.DomainError | if scale is UTC and the UTC date is before 1961-01-01 |
lsst.pex.exceptions.RuntimeError | if DateTime is invalid |
Definition at line 463 of file DateTime.cc.
|
noexcept |
|
static |
Initialize the leap second table from USNO.
The data can be found here: http://maia.usno.navy.mil/ser7/tai-utc.dat and is saved in DateTime.cc as static constant leapString
.
leapString | leap second table from USNO as a single multiline string. |
Definition at line 527 of file DateTime.cc.
|
inline |
|
static |
Return current time as a DateTime.
Assumes the system clock keeps UTC, as almost all computers do.
Definition at line 517 of file DateTime.cc.
Get date as nanoseconds since the unix epoch.
[in] | scale | desired time scale (TAI, TT or UTC) |
lsst.pex.exceptions.DomainError | if scale is UTC and the UTC date is before 1961-01-01 |
Definition at line 447 of file DateTime.cc.
bool lsst::daf::base::DateTime::operator== | ( | DateTime const & | rhs | ) | const |
Definition at line 513 of file DateTime.cc.
struct timespec lsst::daf::base::DateTime::timespec | ( | Timescale | scale | ) | const |
Get date as a timespec struct, with time in seconds and nanoseconds.
[in] | scale | Desired time scale (TAI, TT or UTC) |
lsst.pex.exceptions.DomainError | if scale is UTC and the UTC date is before 1961-01-01 |
lsst.pex.exceptions.RuntimeError | if DateTime is invalid |
Definition at line 463 of file DateTime.cc.
struct timeval lsst::daf::base::DateTime::timeval | ( | Timescale | scale | ) | const |
Get date as a timeval struct, with time in seconds and microseconds.
[in] | scale | desired time scale (TAI, TT or UTC) |
lsst.pex.exceptions.DomainError | if scale is UTC and the UTC date is before 1961-01-01 |
lsst.pex.exceptions.RuntimeError | if DateTime is invalid |
Definition at line 463 of file DateTime.cc.
std::string lsst::daf::base::DateTime::toString | ( | Timescale | scale | ) | const |
Get date as an ISO8601-formatted string.
The returned format is: yyyy-mm-ddThh:mm:ss.sssssssssZ where the final Z is only present if scale is UTC
[in] | scale | Desired time scale (TAI, TT or UTC). |
lsst.pex.exceptions.DomainError | if scale is UTC and the UTC date is before 1961-01-01 |
lsst.pex.exceptions.RuntimeError | if DateTime is invalid |
Definition at line 499 of file DateTime.cc.
|
friend |
Definition at line 291 of file DateTime.h.
|
staticconstexpr |
Definition at line 75 of file DateTime.h.