Time scale transformation: International Atomic Time, TAI, to Coordinated Universal Time, UTC.
Namespace: ASCOM.Astrometry.SOFAAssembly: ASCOM.Astrometry (in ASCOM.Astrometry.dll) Version: 6.0.0.0 (6.6.9999.9999)
Syntaxpublic int TaiUtc(
double tai1,
double tai2,
ref double utc1,
ref double utc2
)
Public Function TaiUtc (
tai1 As Double,
tai2 As Double,
ByRef utc1 As Double,
ByRef utc2 As Double
) As Integer
public:
virtual int TaiUtc(
double tai1,
double tai2,
double% utc1,
double% utc2
) sealed
Parameters
- tai1 Double
- TAI as a 2-part Julian Date (Note 1)
- tai2 Double
- TAI as a 2-part Julian Date (Note 1)
- utc1 Double
- UTC as a 2-part quasi Julian Date (Notes 1-3)
- utc2 Double
- UTC as a 2-part quasi Julian Date (Notes 1-3)
Return Value
Int32Status: +1 = dubious year (Note 4), 0 = OK, -1 = unacceptable date
Remarks
Notes:
- tai1+tai2 is Julian Date, apportioned in any convenient way between the two arguments, for example where tai1 is the Julian Day Number and tai2 is the fraction of a day. The returned utc1
and utc2 form an analogous pair, except that a special convention is used, to deal with the problem of leap seconds - see the next note.
- JD cannot unambiguously represent UTC during a leap second unless special measures are taken. The convention in the present function is that the JD day represents UTC days whether the
length is 86399, 86400 or 86401 SI seconds. In the 1960-1972 era there were smaller jumps (in either direction) each time the linear UTC(TAI) expression was changed, and these "mini-leaps are also included in the SOFA convention.
- The function iauD2dtf can be used to transform the UTC quasi-JD into calendar date and clock time, including UTC leap second handling.
- The warning status "dubious year" flags UTCs that predate the introduction of the time scale or that are too far in the future to be trusted. See iauDat for further details.
See Also