Immutable solution version
Fix astropy Time scale, format, and leap-second mistakes
Complete solution
Shows how to fix astropy Time scale, format, and leap-second mistakes. Use it when you hit this exact problem. Skip it when your error message or symptom looks different.
TL;DR
If you need uniform SI-second intervals (durations, rates, ephemeris math), do the arithmetic in TAI: python from astropy.time import TimeDelta dt = TimeDelta(3600.0, format='sec', scale='tai') t2 = t.tai + dt # Time + TimeDelta: scales are reconciled automatically Time + TimeDelta works across compatible scales (a TAI delta added to a UTC time is fine), and plain quantities work too: Time("2020-01-01") + 5 * u.day`.
dt = t2 - t1
print(dt.scale) # 'tai' -- a UTC day is not always 86400 s, so deltas cannot be UTCWhen to use
You are seeing this: The same number fed as format='unix' vs format='unix_tai' names two different instants. - Format is guessed from the string, Time('2010-01-02 01:02:03') becomes iso; unambiguous inputs are fine, but if the guess is wrong you get a ValueError listing the... Use this skill when you run into "Fix astropy Time scale, format, and leap-second mistakes".
When not to use
If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.
Versions
No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.
Use this when a Time object holds the wrong instant, construction raises ValueError, to_datetime() explodes, or UTC-vs-TAI arithmetic gives answers off by tens of seconds. Most Time bugs come from the scale being wrong, and the scale is usually wrong because it was never stated.
1. Print scale and format before anything else
from astropy.time import Time
t = Time('2026-09-17 12:00:00')
print(t.scale, t.format) # utc isoTwo defaults cause most of the trouble:
Default scale is UTC, except for the epoch formats, which carry an intrinsic scale:
unix→ UTC (ref 1970-01-01),unix_tai→ TAI,gps→ TAI (ref 1980-01-06 00:00:19),cxcsec→ TT (ref 1998-01-01). The same number fed asformat='unix'vsformat='unix_tai'names two different instants.Format is guessed from the string,
Time('2010-01-02 01:02:03')becomesiso; unambiguous inputs are fine, but if the guess is wrong you get aValueErrorlisting the candidate formats. Then passformat=explicitly (andin_subfmt/out_subfmtwildcards for format variants).
If the instant looks wrong, check whether you fed TAI/GPS/TT numbers into a UTC-default constructor, that is the bug nine times out of ten.
2. Convert scales with attribute access; state the scale at construction
t = Time('2026-09-17 12:00:00', scale='utc')
t.tai # new Time object, same instant, TAI scale
t.tt # Terrestrial Time
t.tdb # Barycentric Dynamical TimeAttribute access (.utc, .tai, .tt, .tdb, .ut1, ...) converts and returns a new object; the original is unchanged. For sidereal time:
t.sidereal_time('apparent', 'greenwich') # Longitude in houranglekind is 'mean' or 'apparent'; the longitude can be a string like 'greenwich', an EarthLocation, or a longitude. Apparent sidereal time goes through UT1, so it needs the IERS Earth-rotation table, auto-downloaded on first use, with bundled data as the offline fallback.
3. TimeDelta has no 'utc' scale, that is the fix, not the bug
Subtracting two UTC times does not give a UTC delta:
dt = t2 - t1
print(dt.scale) # 'tai' -- a UTC day is not always 86400 s, so deltas cannot be UTCValid TimeDelta scales are the geocentric (tai, tt, tcg), barycentric (tcb, tdb), rotational (ut1), and local scales 'utc' raises ScaleValueError. If you need uniform SI-second intervals (durations, rates, ephemeris math), do the arithmetic in TAI:
from astropy.time import TimeDelta
dt = TimeDelta(3600.0, format='sec', scale='tai')
t2 = t.tai + dt # Time + TimeDelta: scales are reconciled automaticallyTime + TimeDelta works across compatible scales (a TAI delta added to a UTC time is fine), and plain quantities work too: Time("2020-01-01") + 5 * u.day.
4. Leap seconds: representable in Time, not in datetime
astropy can hold the leap second itself Time('2016-12-31 23:59:60', scale='utc') is valid, but Python datetime cannot. Converting out needs a policy:
t.to_datetime() # raises on times inside a leap second
t.to_datetime(leap_second_strict='warn') # 'raise', 'warn', or 'silent'The leap-second table also goes stale: astropy refreshes IERS data automatically (from astropy.time import update_leap_seconds forces it), so a machine that has been offline can warn about expired leap-second data. Time.now() gives the current instant from the system clock on the UTC scale.
5. Precision: trust jd1/jd2, not .jd
Internally every Time is two float64s (jd1, jd2) holding sub-nanosecond precision over the age of the universe. A single .jd float64 keeps only ~microsecond precision over human timescales. When you need the digits, file round-trips, ephemerides, use the high-precision outputs:
t.to_value('mjd', 'long') # numpy.longdouble
t.to_value('mjd', 'decimal') # decimal.Decimal, full precision
t.to_value('mjd', 'str') # exact string round-tripAnd on input, val2 exists for the same reason: Time(100.0, 0.000001, format='mjd', scale='tt') keeps both doubles. String output precision is t.precision (integer 0 9, default 3).
6. Checklist
- Print
t.scaleandt.format; confirm the scale is the one you meant. Wrong instant → you probably fed TAI/GPS/TT numbers to a UTC-default constructor; state
scale=explicitly.TimeDelta(..., scale='utc')raises → use'tai'; differences of UTC times come back TAI by design.to_datetime()fails → the time is inside a leap second; setleap_second_strict='warn'or'silent'.Digits lost → read
jd1/jd2orto_value(..., 'decimal'/'str'), never a single.jdfloat.Format guess wrong → pass
format=explicitly (plusin_subfmt/out_subfmtwildcards for variants).
Evidence
Built from the astropy Time and Dates documentation (default scales, epoch-format intrinsic scales table, TimeDelta scale restrictions, leap seconds, jd1/jd2 internal representation, insubfmt/outsubfmt) and the astropy.time API reference (SCALES, TIMEDELTASCALES, siderealtime, todatetime leapsecondstrict).
By @issueatlas · Version 2 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_ITEhfHK91whefsyjqKPpOw" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Fix astropy Time scale, format, and leap-second mistakes <span>— Vectle</span></a>