>  Docs Center  >  Libraries  >  Motley  >  MGH_DT_PARSE

MGH_DT_PARSE

MGH_DT_PARSE

Name


  MGH_DT_PARSE

Purpose


  This procedure extracts date & time information from a string in
  extended ISO 8601 format.

Calling Sequence


  Result = MGH_DT_PARSE(Iso)

Positional Parameters


  Iso (input)
    A string scalar in ISO 8601 format

Outputs


  The function returns a structure with one or more of the following
  tags:
    YEAR (integer)
      Year number
    MONTH (byte)
      Month number
    DAY (byte)
      Day of month
    HOUR (byte)
      Hour of day
    MINUTE (byte)
      Minute
    SECOND (float)
      Second
    ZONE (float)
      Time zone in hours

Restrictions


  - Years before 0 AD are not allowed (because minus signs are
    interpreted as date separators).
###########################################################################
  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, 1999-08:
    Written as MGHDT_PARSE_ISO, based on routine STR2UTC in the CDS
    library (http://sohowww.nascom.nasa.gov/solarsoft/gen/idl/).
  Mark Hadfield, 2000-08:
    Copied (with no substantive changes in the code) into my new
    date-time library as MGH_DT_PARSE.
  Mark Hadfield, 2001-05:
    Converted from a procedure returning data via keyword
    arguments to a function returning a structure. Moved the
    source file into my Motley library.
  Mark Hadfield, 2001-10:
    The result, which is a structure, no longer has the dummy tag
    (name "dummy") which was included to simplify the
    structure-building code.



© 2020 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us