give example for datetime

[crotwell]

Datetime description is confusing:

Integer values used to represent the year, day, hours, minutes. Decimals represent seconds, a boolean represents the timezone.

What is a boolean timezone? This also doesn't say how the integers are to be combined. Very confusing.

Should also say instead that it is ISO 8601 string, give a link to the ISO spec or perhaps the W3C xschema spec. I think at some point it was preferred to be one of a limited versions of the ISO spec, so perhaps limit to a few like: YYYY-MM-DDThh:mm:ss.SSSSSSZ, YYYY-MM-DDThh:mm:ssZ, YYYY-MM-DDThh:mm:ss.SSSZ, YYYY-MM-DDZ,

Add a sentence that using times in UTC is preferred, and that the Z timezone identifier should be appended to as processing systems often interpret times without timezones as local time. Appending the Z helps eliminate a common source of error.

It should have an example.

[crotwell]

Related, all example times in the docs should include the Z to designate UTC. For example, Network endDate example should be: endDate="2018-01-27T00:00:00Z"

[crotwell]

fixed in PR #77