Skip to main content
`Ctrl`+`K`

# TimeUnix

class astropy.time.TimeUnix(val1, val2, scale, precision, in_subfmt, out_subfmt, from_jd=False)

  Bases: `TimeFromEpoch`

  Unix time (UTC): seconds from 1970-01-01 00:00:00 UTC, ignoring leap seconds.

  For example, 946684800.0 in Unix time is midnight on January 1, 2000.

  NOTE: this quantity is not exactly unix time and differs from the strict POSIX definition by up to 1 second on days with a leap second. POSIX unix time actually jumps backward by 1 second at midnight on leap second days while this class value is monotonically increasing at 86400 seconds per UTC day.

  Attributes Summary

  `epoch` | Reference epoch time from which the time interval is measured.
  `epoch_format` |
  `epoch_scale` |
  `epoch_val` |
  `epoch_val2` |
  `in_subfmt` |
  `jd1` |
  `jd2` |
  `name` |
  `out_subfmt` |
  `precision` |
  `scale` | Time scale.
  `subfmts` |
  `unit` |
  `value` | Return time representation from internal jd1 and jd2.

  Methods Summary

  `fill_value`(subfmt) | Return a value corresponding to J2000 (2000-01-01 12:00:00) in this format.
  `set_jds`(val1, val2) | Initialize the internal jd1 and jd2 attributes given val1 and val2.
  `to_value`([parent]) | Return time representation from internal jd1 and jd2.

  Attributes Documentation

  epoch

    Reference epoch time from which the time interval is measured.

  epoch_format = 'iso'
  epoch_scale = 'utc'
  epoch_val = '1970-01-01 00:00:00'
  epoch_val2 = None
  in_subfmt
  jd1
  jd2
  name = 'unix'
  out_subfmt
  precision
  scale

    Time scale.

  subfmts = (('float', <class 'numpy.float64'>, None, <ufunc 'add'>), ('long', <class 'numpy.longdouble'>, <function longdouble_to_twoval>, <function twoval_to_longdouble>), ('decimal', <class 'numpy.object_'>, <numpy.vectorize object>, <numpy.vectorize object>), ('str', <class 'numpy.str_'>, <numpy.vectorize object>, <numpy.vectorize object>), ('bytes', <class 'numpy.bytes_'>, <numpy.vectorize object>, <numpy.vectorize object>))
  unit = 1.1574074074074073e-05
  value

  Methods Documentation

  classmethod fill_value(subfmt)

    Return a value corresponding to J2000 (2000-01-01 12:00:00) in this format.

    This is used as a fill value for masked arrays to ensure that any ERFA operations on the masked array will not fail due to the masked value.

  set_jds(val1, val2)

    Initialize the internal jd1 and jd2 attributes given val1 and val2. For an TimeFromEpoch subclass like TimeUnix these will be floats giving the effective seconds since an epoch time (e.g. 1970-01-01 00:00:00).

  to_value(parent=None, **kwargs)

    Return time representation from internal jd1 and jd2. Subclasses that require `parent` or to adjust the jds should override this method.