Requested time extent
The WMSMapRequest.Time property stores time
as a character vector or a double indicating the
desired time extent of the requested map. When you set the property, 'time' must
be the value of the Layer.Details.Dimension.Name field.
The default value is ''.
Time is stored in the ISO® 8601:1988(E) extended format.
In general, the Time property is stored in a yyyy-mm-dd format
or a yyyy-mm-ddThh:mm:ssZ format, if the precision
requires hours, minutes, or seconds. You can use several different
character vector and numeric formats to set the Time property,
according to the following table (where dateform number is the number
used by the Standard MATLAB® Date Format Definitions). Express
all hours, minutes, and seconds in Coordinated Universal Time (UTC).
| Dateform (number) | Input (character vector) | Stored format |
|---|---|---|
| 0 | dd-mm-yyyy HH:MM:SS | yyyy-mm-ddTHH:MM:SSZ |
| 1 | dd-mm-yyyy | yyyy-mm-dd |
| 2 | mm/dd/yy | yyyy-mm-dd |
| 6 | mm/dd | yyyy-mm-dd (current year) |
| 10 | yyyy | yyyy |
| 13 | HH:MM:SS | yyyy-mm-ddTHH:MM:SSZ |
| 14 | HH:MM:SS PM | yyyy-mm-ddTHH:MM:SSZ |
| 15 | HH:MM | yyyy-mm-ddTHH:MM:00Z |
| 16 | HH:MM PM | yyyy-mm-ddTHH:MM:00Z |
| 21 | mmm.dd,yyyy HH:MM:SS | yyyy-mm-ddTHH:MM:SSZ |
| 22 | mmm.dd,yyyy | yyyy-mm-dd |
| 23 | mm/dd/yyyy | yyyy-mm-dd |
| 26 | yyyy/mm/dd | yyyy-mm-dd |
| 29 | yyyy-mm-dd | yyyy-mm-dd |
| 30 | yyyymmddTHHMMSS | yyyy-mm-ddTHH:MM:SSZ |
| 31 | yyyy-mm-dd HH:MM:SS | yyyy-mm-ddTHH:MM:SSZ |
Inputs using the dateform numbers 13–16 return the date set to the current year, month, and day. Use of other dateform formats, especially 19, 20, 24, and 25, results in erroneous output.
In addition to these standard MATLAB dateform formats,
the WMSMapRequest.Time property also accepts the
following inputs.
| Input (character vector) | Description |
|---|---|
'current' | The current time holdings of the server |
numeric datenum | Numeric date value converted to yyyy-mm-dd (dateform 29 format) |
Byyyy | B.C.E. year |
Use the prefixes K, M, and G, followed by a character vector number (thousand, million, and billion years, respectively), for geologic data sets that refer to the distant past.