---
id: "year_range"
kind: "datatype"
status: "draft"
is_pii: false
categories: ["datetime"]
langs: ["common"]
quality: 93
url: "http://registry.apicrafter.io/datatype/year_range"
---

# Year range (`year_range`)

> **Draft.** Draft records have not been reviewed yet and may be incomplete or wrong; do not treat them as authoritative for legal or compliance decisions.

Span of calendar years written as two four-digit years joined by a hyphen, such as 2019-2020. It often names a season, an academic or fiscal year, or a reporting period.

- Personal data (PII): no
- Categories: Date and time (datetime)
- Countries: global
- Languages: Common to most languages (common)

## Detection

Regular expression (Python `re`):

```
^\d{4}-\d{4}$
```

## Examples

- `2019-2020`
- `1914-1918`
- `2019-20` (invalid example) — short form of the second year is not covered

## Mappings

- fta: `PERIOD.YEAR_RANGE`

## Supported by tools

- `fta`

## Translations

- ru: Диапазон лет

## Sources

- other: <https://github.com/tsegall/fta/blob/main/SemanticTypes.md>

## Quality

Score 93/100. Missing: authoritative source link.

JSON: <http://registry.apicrafter.io/api/v1/datatypes/year_range.json> · Edit: <https://github.com/apicrafter/metacrafter-registry/edit/main/data/datatypes/any/datetime/year_range.yaml>