...
These operations provide support for the temporal attributes of other entities, such as recording the dates and times of meaningful system events; specifying the duration of loans and exhibitions, or of temporarily-granted access permissions; beginning and ending dates of loans and exhibitions; and and facilitating searching and reporting based, in part, on date and time ranges (e.g. "objects accessioned within the last week").
Operations supported may include:
- Date and time addition and subtraction.
...
- Date and time format conversion, in support of Internationalization and import.
- Time zone handling.
- Generating timestamps.
Assumptions
Scope
- This service will apply to system dates and times: the dates and times of meaningful collections management events modeled by the CollectionSpace system, such as the date and time that an object was accessioned, loaned, exhibited, moved, or covered by conservation activities; dates and times related to an insurance contract or shipping manifest; or dates and times that a date and time range during which temporary access permissions might be granted to a Principal.
The service will not attempt to model dates and times, or named time periods, that might be encountered in the context of Annotatations CollectionObject metadata or other forms of Annotations, such as the European Renaissance or the "203 BC," "1962 CE," "European Renaissance," "Han Dynasty," or "Mesozoic Era."
Calendars
- This service will default to using the Gregorian Calendar system.
It may be possible, during implementation, to abstract this create an abstraction layer to more readily allow permit the use of other calendar systems (e.g. Islamic, Hebrew) for representing system dates and times, in the event that might be a future requirement for the CollectionSpace system.
Date and Time Formats
- This service will inherently accept any of several widely-used input formats for dates and times, and potentially .
- This service will allow customization - based on regular expressions or similar patterns - that will allow permit the use of other custom date and time input formats.
- For input date and time formats where years are represented with fewer than four digits (required to unambiguously designate years in the Gregorian Calendar), default assumptions about assigning these dates to a century will be used and documented.
...