Brief Description

A CollectionSpace structured date represents a single date or date range that may have some uncertainty.

REST-based API

The Structured Date Service offers a REST-based Application Programming Interface (API) to parse a date string into a structured date.

Parse a display date

Attempts to interpret a given display date (string), and returns suggested structured date parts.

GET /cspace-services/structureddates?displayDate={datestring}

For example:

GET /cspace-services/structureddates?displayDate=june%201998

Returns:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:structureddate_common xmlns:ns2="http://collectionspace.org/services/structureddate">
  <dateDisplayDate>june 1998</dateDisplayDate>
  <dateEarliestSingleYear>1998</dateEarliestSingleYear>
  <dateEarliestSingleMonth>6</dateEarliestSingleMonth>
  <dateEarliestSingleDay>1</dateEarliestSingleDay>
  <dateEarliestSingleEra>urn:cspace:core.collectionspace.org:vocabularies:name(dateera):item:name(ce)'CE'</dateEarliestSingleEra>
  <dateLatestYear>1998</dateLatestYear>
  <dateLatestMonth>6</dateLatestMonth>
  <dateLatestDay>30</dateLatestDay>
  <dateLatestEra>urn:cspace:core.collectionspace.org:vocabularies:name(dateera):item:name(ce)'CE'</dateLatestEra>
  <dateEarliestScalarValue>1998-06-01</dateEarliestScalarValue>
  <dateLatestScalarValue>1998-07-01</dateLatestScalarValue>
  <scalarValuesComputed>true</scalarValuesComputed>
</ns2:structureddate_common>

If the supplied date string can not be parsed, the HTTP response will have status code 400, and the body will contain an error message.

CollectionSpace 7.0 Documentation

Structured Date Service RESTful APIs

Analytics

Brief Description

REST-based API

Parse a display date

Related content