TimeFITS

class astropy.time.TimeFITS(val1, val2, scale, precision, in_subfmt, out_subfmt, from_jd=False)[source]

Bases: astropy.time.TimeString

FITS format: “[±Y]YYYY-MM-DD[THH:MM:SS[.sss]]”.

ISOT but can give signed five-digit year (mostly for negative years);

The allowed subformats are:

  • ‘date_hms’: date + hours, mins, secs (and optional fractional secs)
  • ‘date’: date
  • ‘longdate_hms’: as ‘date_hms’, but with signed 5-digit year
  • ‘longdate’: as ‘date’, but with signed 5-digit year

See Rots et al., 2015, A&A 574:A36 (arXiv:1409.7583).

Attributes Summary

cache Return the cache associated with this instance.
jd2_filled
mask
masked
name
scale Time scale
subfmts
value Convert times to strings, using signed 5 digit if necessary.

Methods Summary

format_string(self, str_fmt, \*\*kwargs) Write time to a string using a given format.
mask_if_needed(self, value)
parse_string(self, timestr, subfmts) Read time and deprecated scale if present
set_jds(self, val1, val2) Parse the time strings contained in val1 and set jd1, jd2
str_kwargs(self) Generator that yields a dict of values corresponding to the calendar date and time for the internal JD values.
to_value(self[, parent]) Return time representation from internal jd1 and jd2.

Attributes Documentation

cache

Return the cache associated with this instance.

jd2_filled
mask
masked
name = 'fits'
scale

Time scale

subfmts = (('date_hms', re.compile('(?P<year>\\d{4})-(?P<mon>\\d\\d)-(?P<mday>\\d\\d)T(?P<hour>\\d\\d):(?P<min>\\d\\d):(?P<sec>\\d\\d(\\.\\d*)?)(\\((?P<scale>\\w+)(\\((?P<realization>\\w+)\\))?\\))?$'), '{year:04d}-{mon:02d}-{day:02d}T{hour:02d}:{min:02d}:{sec:02d}'), ('date', re.compile('(?P<year>\\d{4})-(?P<mon>\\d\\d)-(?P<mday>\\d\\d)(\\((?P<scale>\\w+)(\\((?P<realization>\\w+)\\))?\\))?$'), '{year:04d}-{mon:02d}-{day:02d}'), ('longdate_hms', re.compile('(?P<year>[+-]\\d{5})-(?P<mon>\\d\\d)-(?P<mday>\\d\\d)T(?P<hour>\\d\\d):(?P<min>\\d\\d):(?P<sec>\\d\\d(\\.\\d*)?)(\\((?P<scale>\\w+)(\\((?P<realization>\\w+)\\))?\\))?$'), '{year:+06d}-{mon:02d}-{day:02d}T{hour:02d}:{min:02d}:{sec:02d}'), ('longdate', re.compile('(?P<year>[+-]\\d{5})-(?P<mon>\\d\\d)-(?P<mday>\\d\\d)(\\((?P<scale>\\w+)(\\((?P<realization>\\w+)\\))?\\))?$'), '{year:+06d}-{mon:02d}-{day:02d}'))
value

Convert times to strings, using signed 5 digit if necessary.

Methods Documentation

format_string(self, str_fmt, **kwargs)

Write time to a string using a given format.

By default, just interprets str_fmt as a format string, but subclasses can add to this.

mask_if_needed(self, value)
parse_string(self, timestr, subfmts)[source]

Read time and deprecated scale if present

set_jds(self, val1, val2)

Parse the time strings contained in val1 and set jd1, jd2

str_kwargs(self)

Generator that yields a dict of values corresponding to the calendar date and time for the internal JD values.

to_value(self, parent=None)

Return time representation from internal jd1 and jd2. This is the base method that ignores parent and requires that subclasses implement the value property. Subclasses that require parent or have other optional args for to_value should compute and return the value directly.