...
Excerpt |
---|
A utility service that provides support for date and time operations. |
These operations provide support for the temporal attributes of other entities, such as:
...
Operations that may be performed by this service are proposed below. Some of these may be implemented solely as internal code, and have no web services or externally-facing components:
Basic date and time operations.
- Date and time addition and subtraction, in part in support of such concepts as "last week," "this month", and "90 days from now."
- Generating timestamps at the current instant.
Date and time ranges
- Calculating the duration of date and time ranges, in support of time-bounded entities, such as loans, exhibitionsexhibits, and temporarily-granted temporary access permissions.
- Identifying whether a specific date and time falls before, within, or after a date and time range.
Formatting and validation
- Formatting dates and times, and converting between formats.
- Validating entered dates and times.
Time zones
- Time zone handling.
Named time periods
- Support for named time periods. (This encompasses a great deal, and should be broken out further here.)
These operations provide support for the temporal attributes of other entities, such as:
- Generating date-related parts of ID numbers.
- Facilitating searches and reporting based, in part, on date and time ranges (e.g. "collection objects accessioned within the last week" or "collection objects scheduled for conservation activity during March 1-20 of the current year").
Operations supported may include:
- Date and time addition and subtraction, in part in support of such concepts as "last week," "this month", and "90 days from now."
- Date and time ranges, in support of time-bounded entitiesProviding notifications at significant time points related to time-bound events, such as loans, exhibitsexhibitions, and temporary temporarily-granted access permissions.
- Date and time format conversion, in support of Supporting customization (including Internationalization) of displayed and entered dates and importtimes.
- Time zone handling.
- Generating timestampsSupport for import of dates and times.
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 a date and time range during which temporary access permissions might be granted to a Principal.
...
- Especially things that become common sense, and so usually missed by new reviewers
Dependencies
Services with potential dependencies on this service include:
- ID Service.
- Notification Service
- Scheduler Service
- IDs, but only to the extent that certain forms of IDs may incorporate timestamps. Any
More generally, any entity services 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.)
...