TimeUnix#

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

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.