Skip to content

Commit

Permalink
Merge pull request #1127 from radiantearth/issue-1125
Browse files Browse the repository at this point in the history
Collection: Open intervals for temporal extents
  • Loading branch information
cholmes authored May 11, 2021
2 parents b43d16b + ba9df2e commit a553f11
Show file tree
Hide file tree
Showing 2 changed files with 10 additions and 4 deletions.
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
### Changed

- An empty Catalog is now allowed, removed the requirement that it must have a child or item link. ([#1115](https://github.com/radiantearth/stac-spec/issues/1115))
- An open date range to both sides is now allowed in the Collection's temporal extents. ([#1125](https://github.com/radiantearth/stac-spec/issues/1125))
- Catalog and Collection JSON Schemas don't have a common JSON Schema any more

### Removed
Expand Down
13 changes: 9 additions & 4 deletions collection-spec/collection-spec.md
Original file line number Diff line number Diff line change
Expand Up @@ -202,12 +202,17 @@ Clients only interested in the overall extent will only need to access the first
It is recommended to only use multiple temporal extents if a union of them would then include a large
uncovered time span (e.g. only having data for the years 2000, 2010 and 2020).

Each inner array consists of exactly two dates and times, each in UTC.
Each date and time MUST be formatted according to [RFC 3339, section 5.6](https://tools.ietf.org/html/rfc3339#section-5.6).
Each inner array consists of exactly two elements, either a timestamp or `null`.

Timestamps consist of a date and time in UTC and MUST be formatted according to
[RFC 3339, section 5.6](https://tools.ietf.org/html/rfc3339#section-5.6).
The temporal reference system is the Gregorian calendar.

Open date ranges are supported by setting either the start or the end time to `null`.
Example for data from the beginning of 2019 until now: `[["2009-01-01T00:00:00Z", null]]`.
Open date ranges are supported by setting the start and/or the end time to `null`.
Example for data from the beginning of 2019 until now: `[["2019-01-01T00:00:00Z", null]]`.
It is recommended to provide at least a rough guideline on the temporal extent and thus
it's not recommended to set both start and end time to `null`. Nevertheless, this is possible
if there's a strong use case for an open date range to both sides.

### Provider Object

Expand Down

0 comments on commit a553f11

Please sign in to comment.