Skip to content

Slot: at_date_time

The date and time at which something did or will occur, with variants for precision, start and end, and actual vs. planned.

URI: gist_upstream:atDateTime Alias: at_date_time

Inheritance

Properties

Type and Range

Property Value
Range Datetime
Slot URI gist_upstream:atDateTime

Cardinality and Requirements

Property Value

In Subsets

Aliases

  • at date time

Comments

  • This is the top level property for asserting time, and is not expected to be asserted directly.

The subproperties allow the ontologist to do three things: 1) Distinguish start and end times. 2) Indicate whether a time is planned or actual. This is useful for everything from project management to calendar appointments and the like. It is also useful for date effectivities; i.e., something valid up to a planned date). 3) Distinguish varying levels of precision; sort of a simple version of the Allen functions.

All datetimes are of the same format: '2021-06-01T08:03:27.12324-6:00'^^xsd:dateTime. This is compatible with and a subset of ISO 8601.

Time zone offset, such as -6:00 (of which there are a few dozen) is recognized in the date itself, as shown. The actual time zone standard (of which there are 131) may optionally be attached to the event or other object itself.

There will be many historical dates that do not have a time zone offset (e.g., Lincoln's birthday, as well as about 75% of all legacy systems), and in that case the offset can be omitted.

The conventions for precision that are repeated in each property name are as follows: - DateTime is an abstraction over the various precisions of its subproperties. - Date refers to a calendar date (e.g., birthdays and invoice dates) and is assumed to have precision of one day. Time zone offset is allowed. - Minute refers to clock time; e.g., a meeting will start at 9:15 with a timezone offset. Precision is assumed to have precision of one minute. - Microsecond refers to system time, and it will be as precise as the system can supply; typically at least milliseconds, sometime microseconds.

Identifier and Mapping Information

Schema Source

Mappings

Mapping Type Mapped Value
self gist_upstream:atDateTime
native gist:at_date_time

LinkML Source

name: at_date_time
description: The date and time at which something did or will occur, with variants
  for precision, start and end, and actual vs. planned.
comments:
- "This is the top level property for asserting time, and is not expected to be asserted\
  \ directly.\r\n\r\nThe subproperties allow the ontologist to do three things:\r\n\
  1) Distinguish start and end times.\r\n2) Indicate whether a time is planned or\
  \ actual. This is useful for everything from project management to calendar appointments\
  \ and the like. It is also useful for date effectivities; i.e., something valid\
  \ up to a planned date).\r\n3) Distinguish varying levels of precision; sort of\
  \ a simple version of the Allen functions.\r\n\r\nAll datetimes are of the same\
  \ format: '2021-06-01T08:03:27.12324-6:00'^^xsd:dateTime. This is compatible with\
  \ and a subset of ISO 8601.\r\n\r\nTime zone offset, such as -6:00 (of which there\
  \ are a few dozen) is recognized in the date itself, as shown. The actual time zone\
  \ standard (of which there are 131) may optionally be attached to the event or other\
  \ object itself.\r\n\r\nThere will be many historical dates that do not have a time\
  \ zone offset (e.g., Lincoln's birthday, as well as about 75% of all legacy systems),\
  \ and in that case the offset can be omitted.\r\n\r\nThe conventions for precision\
  \ that are repeated in each property name are as follows:\r\n\t- *DateTime is an\
  \ abstraction over the various precisions of its subproperties.\r\n\t- *Date refers\
  \ to a calendar date (e.g., birthdays and invoice dates) and is assumed to have\
  \ precision of one day. Time zone offset is allowed.\r\n\t- *Minute refers to clock\
  \ time; e.g., a meeting will start at 9:15 with a timezone offset. Precision is\
  \ assumed to have precision of one minute.\r\n\t- *Microsecond refers to system\
  \ time, and it will be as precise as the system can supply; typically at least milliseconds,\
  \ sometime microseconds.\r\n"
in_subset:
- gist_core
from_schema: https://w3id.org/lmodel/gist
aliases:
- at date time
rank: 1000
slot_uri: gist_upstream:atDateTime
alias: at_date_time
range: datetime