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
2015

Attributes Summary

cache

Return the cache associated with this instance.

in_subfmt

jd1

jd2

jd2_filled

mask

masked

name

out_subfmt

precision

scale

Time scale

subfmts

value

Methods Summary

mask_if_needed(value)

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

cache

Return the cache associated with this instance.

in_subfmt
jd1
jd2
jd2_filled
mask
masked
name = 'ymdhms'
out_subfmt
precision
scale

Time scale

subfmts = ()
value

Methods Documentation

mask_if_needed(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_subfmtpython:str or python: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