Description
A utility service that provides support for date and time operations.
These operations provide support for the temporal attributes of other entities, such as temporarily-granted access permissions; beginning and ending dates of loans and exhibitions; and searching and reporting based in part on date ranges (e.g. "objects accessioned within the last week").
Operations supported include:
- Date and time addition and subtraction.
- Date and time ranges.
- Date and time format conversion, in support of Internationalization and import.
- Time zone handling.
Assumptions
Date and Time Formats
- The default output format for dates and times, unless otherwise customized for a locale or institution, will be one or more default profiles of ISO 8601, the International standard for date and time formatting. (A 1997 W3C Note, Date and Time Formats, provides some suggestions for selecting these profiles.) There are two excellent general introductions to the ISO 8601 standard:
- Markus Kuhn, A summary of the international standard date and time notation
- Jukka "Yucca" Korpela, Info on ISO 8601, the date and time representation standard
Time Zones
- Deployments of the CollectionSpace service may be hosted in a different time zone than users of the service.
- Users of a deployment may simultaneously be located in two or more time zones.
- The core date and time framework/library will require periodic updates to time zone data, as various world governments make changes to that data.
Boilerplate structure and text below
Much of the page structure and text below this point is boilerplate, copied in from the relevant New Service template. Further work is needed to complete this page.
Key Concepts
- Especially things that become common sense, and so usually missed by new reviewers
Dependencies
- Services with potential dependencies on this service include:
- Any entities whose data models include temporal attributes may potentially have some dependencies on this service.
Background Documentation
- If we have notes from community design meetings, link to them here.
- If we have relevant sections in Spectrum or another such document, link to them here (or cite section numbers, etc.)
Key Team Members
- (Name(s) of members) is/are the primary tech team member(s) for this service
- Need to identify the community members acting as Domain Experts.