---
id: "date_range"
kind: "datatype"
status: "draft"
is_pii: false
name: "Date range"
categories: ["datetime"]
langs: ["common"]
quality: 70
url: "https://registry.apicrafter.io/datatype/date_range"
---

# Date range (`date_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.

Period between two calendar dates written as one value: the dates joined by a dash, a slash or a word (al, a, au, bis, to, until), as in 5-4-02 al 27-5-02, 22-1-02/27-2-02, 01.03.2020 - 31.03.2020 or the ISO 8601 interval 2020-01-01/2020-03-31. Field data, schedules and registers give the period that a measurement, a harvest cut, a contract or an exhibition covers this way. Two years only are year_range, two times of a day timerange.

- Parent datatype: [`timespan`](https://registry.apicrafter.io/datatype/timespan.md)
- Personal data (PII): no
- Categories: Date and time (datetime)
- Countries: global
- Languages: Common to most languages (common)

## Examples

- `5-4-02 al 27-5-02` — growth period between two alfalfa cuts, INTA Rafaela cultivar network (AquaCrop data, UNR)
- `22-1-02/27-2-02` — the same, slash form
- `2020-01-01/2020-03-31` — ISO 8601 time interval
- `01.03.2020 - 31.03.2020`
- `2019-2020` (invalid example) — two years: year_range
- `08:00-22:00` (invalid example) — two times of day: timerange

## Metacrafter rules

1 rules: 0 match the field name, 1 match values.

- `daterangevalue` (data, `common/dateandtime.yaml`)

## Supported by tools

- [`metacrafter`](https://registry.apicrafter.io/tool/metacrafter.md)

## Translations

- es: Rango de fechas
- ru: Диапазон дат

## Sources

- wikipedia: <https://en.wikipedia.org/wiki/ISO_8601#Time_intervals>

## Quality

Score 70/100. Missing: regexp, mapping (Wikidata, Schema.org, ...).

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