Find UT1 - UTC differences by interpolating in IERS Table.

Parameters¶

iers_table~astropy.utils.iers.IERS, optional

Table containing UT1-UTC differences from IERS Bulletins A and/or B. Default: ~astropy.utils.iers.earth_orientation_table (which in turn defaults to the combined version provided by ~astropy.utils.iers.IERS_Auto).

return_statusbool

Whether to return status values. If False (default), iers raises IndexError if any time is out of the range covered by the IERS table.

Returns¶

ut1_utcfloat or float array

UT1-UTC, interpolated in IERS Table

statusint or int array

Status values (if return_status=`True`):: astropy.utils.iers.FROM_IERS_B astropy.utils.iers.FROM_IERS_A astropy.utils.iers.FROM_IERS_A_PREDICTION astropy.utils.iers.TIME_BEFORE_IERS_RANGE astropy.utils.iers.TIME_BEYOND_IERS_RANGE

Notes¶

In normal usage, UT1-UTC differences are calculated automatically on the first instance ut1 is needed.

Examples¶

To check in code whether any times are before the IERS table range:

>>> from astropy.utils.iers import TIME_BEFORE_IERS_RANGE
>>> t = Time(['1961-01-01', '2000-01-01'], scale='utc')
>>> delta, status = t.get_delta_ut1_utc(return_status=True)  
>>> status == TIME_BEFORE_IERS_RANGE  
array([ True, False]...)