id: https://nde.nl/ontology/hc/class/TemporalCoverage
name: temporal_coverage_class
title: TemporalCoverage Class
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  dcterms: http://purl.org/dc/terms/
  schema: http://schema.org/
default_prefix: hc
default_range: string
imports:
  - linkml:types
  - ../metadata
  - ./SpecificityAnnotation
  - ./TemplateSpecificityScores
  - ./TemporalPeriod
  - ./KeyDate
  - ../slots/end
  - ../slots/has_or_had_key_date
  - ../slots/has_or_had_key_period
  - ../slots/note
  - ../slots/has_or_had_period
  - ../slots/specificity_annotation
  - ../slots/start
  - ../slots/template_specificity

classes:
  TemporalCoverage:
    class_uri: dcterms:PeriodOfTime
    description: |
      Time period covered by the finding aid's materials.

      Supports both numeric years and special values like "present".
      Can include named periods (key_periods) and significant dates (key_dates).
    slots:
      - end
      - has_or_had_key_date
      - has_or_had_key_period
      - note
      - has_or_had_period
      - specificity_annotation
      - start
      - template_specificity
    slot_usage:
      start:
        description: Start year of coverage
        range: TemporalValue
        required: true
      end:
        description: End year of coverage (use "present" for ongoing)
        range: TemporalValue
        required: true
      note:
        description: Additional notes about temporal coverage
      has_or_had_period:
        description: Named periods within coverage
        range: TemporalPeriod
        multivalued: true
        inlined_as_list: true
      has_or_had_key_period:
        description: Named historical periods (alias for periods)
        range: TemporalPeriod
        multivalued: true
        inlined_as_list: true
      has_or_had_key_date:
        description: Significant historical dates
        range: KeyDate
        multivalued: true
        inlined_as_list: true
      specificity_annotation:
        range: SpecificityAnnotation
        inlined: true
      template_specificity:
        range: TemplateSpecificityScores
        inlined: true
    exact_mappings:
      - dcterms:PeriodOfTime
      - schema:temporalCoverage

slots:
  start:
    slot_uri: schema:startDate
    description: Start of temporal coverage
    range: string
  end:
    slot_uri: schema:endDate
    description: End of temporal coverage
    range: string
  has_or_had_key_period:
    slot_uri: dcterms:temporal
    description: Named historical periods
    range: TemporalPeriod
    multivalued: true
  has_or_had_key_date:
    slot_uri: dcterms:date
    description: Significant historical dates
    range: KeyDate
    multivalued: true
  has_or_had_period:
    slot_uri: dcterms:temporal
    description: Named periods within coverage (uses TemporalPeriod class)
    range: TemporalPeriod
    multivalued: true