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.