Name

---

  MGH_DT_CALDAT

Purpose

---

  Like CALDAT but implemented as a function returning a
  structure. It also has a different argument order and an optional
  time-zone argument.

Calling Sequence

---

  result = MGH_DT_CALDAT(dtjul, ZONE=zone)

Positional Parameters

---

  dtjul (input, numeric scalar or array)
    Date & time in Julian days.

Keyword Parameters

---

  ZONE (input, numeric scalar or array)
    Time zone in hours. Default is 0.

Return Value

---

  The function returns a structure scalar or array, with the same
  shape as the input, with tags YEAR, MONTH, DAY, HOUR,
  MINUTE, SECOND and ZONE.
###########################################################################
  This software is provided subject to the following conditions:
  1. NIWA makes no representations or warranties regarding the
    accuracy of the software, the use to which the software may
    be put or the results to be obtained from the use of the
    software. Accordingly NIWA accepts no liability for any loss
    or damage (whether direct of indirect) incurred by any person
    through the use of or reliance on the software.
  2. NIWA is to be acknowledged as the original author of the
    software where the software is used or presented in any form.
###########################################################################

Modification History

---

  Mark Hadfield, 2000-08:
    Written.
  Mark Hadfield, 2001-05:
    Added ZONE keyword.
  Mark Hadfield, 2002-12:
    Documentation improvements.
  Mark Hadfield, 2005-01:
    Result now has the same shape as the input.