Skip to main content
`Ctrl`+`K`

# TimeYMDHMS

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

  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

  `in_subfmt` |
  `jd1` |
  `jd2` |
  `name` |
  `out_subfmt` |
  `precision` |
  `scale` | Time scale.
  `subfmts` |
  `value` |

  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)

    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:
      parent `object`

        Parent `Time` object associated with this `TimeFormat` object

      out_subfmt `python:str` or `python:None`

        Output subformt (use existing self.out_subfmt if `None`)

    Returns:
      value `numpy.array`, `numpy.ma.array`

        Array or masked array of formatted time representation values