TimeYMDHMS#

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

Bases: TimeUnique

ymdhms: A Time format to represent Time as year, month, day, hour, minute, second (thus the name ymdhms).

Acceptable inputs must have keys or column names in the “YMDHMS” set of year, month, day hour, minute, second:

  • Dict with keys in the YMDHMS set

  • NumPy structured array, record array or astropy Table, or single row of those types, with column names in the YMDHMS set

One can supply a subset of the YMDHMS values, for instance only ‘year’, ‘month’, and ‘day’. Inputs have the following defaults:

'month': 1, 'day': 1, 'hour': 0, 'minute': 0, 'second': 0

When the input is supplied as a dict then each value can be either a scalar value or an array. The values will be broadcast to a common shape.

Example:

>>> from astropy.time import Time
>>> t = Time({'year': 2015, 'month': 2, 'day': 3,
...           'hour': 12, 'minute': 13, 'second': 14.567},
...           scale='utc')
>>> t.iso
'2015-02-03 12:13:14.567'
>>> t.ymdhms.year
np.int32(2015)

Attributes Summary

Methods Summary

fill_value(subfmt)

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

set_jds(val1, val2)

Set internal jd1 and jd2 from val1 and val2.

to_value([parent, out_subfmt])

Return time representation from internal jd1 and jd2 in specified out_subfmt.

Attributes Documentation

in_subfmt#
jd1#
jd2#
name = 'ymdhms'#
out_subfmt#
precision#
scale#

Time scale.

subfmts = ()#
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)[source]#

Set internal jd1 and jd2 from val1 and val2. Must be provided by derived classes.

to_value(parent=None, out_subfmt=None)#

Return time representation from internal jd1 and jd2 in specified out_subfmt.

This is the base method that ignores parent and uses the value property to compute the output. This is done by temporarily setting self.out_subfmt and calling self.value. This is required for legacy Format subclasses prior to astropy 4.0 New code should instead implement the value functionality in to_value() and then make the value property be a simple call to self.to_value().

Parameters:
parentobject

Parent Time object associated with this TimeFormat object

out_subfmtstr or None

Output subformt (use existing self.out_subfmt if None)

Returns:
valuenumpy.array, numpy.ma.array

Array or masked array of formatted time representation values