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

# SDMX reporting time period (`sdmx_reporting_period`)

> **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.

Reporting period in SDMX statistical data and metadata, written as a four-digit year, a hyphen, a period letter and a number: A1 for the year, S1-S2 for half-years, T1-T3 for four-month trimesters, Q1-Q4 for quarters, M01-M12 for months, W01-W53 for weeks and D001-D366 for days, with an optional time zone (Z, +hh:mm or -hh:mm). Periods count from the start of the reporting year, 1 January unless a reporting year start day is given, and the year is the year in which the reporting year begins. The SDMX time period (TIME_PERIOD) may also hold Gregorian values such as 2024, 2024-01 or 2024-01-15, date-times and time ranges; those are the datatypes year, yearmonth, date and datetime.

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

## Detection

Regular expression (Python `re`):

```
^\d{4}-(?:A1|S[12]|T[1-3]|Q[1-4]|M(?:0[1-9]|1[0-2])|W(?:0[1-9]|[1-4]\d|5[0-3])|D(?:00[1-9]|0[1-9]\d|[12]\d{2}|3[0-5]\d|36[0-6]))(?:Z|[+-](?:14:00|(?:0\d|1[0-3]):[0-5]\d))?$
```

## Examples

- `2000-A1` — Reporting year
- `2000-S1` — First semester
- `2000-T1` — First trimester
- `2000-Q1` — First quarter
- `2000-M01` — January
- `2000-W01` — First week
- `2000-D001` — First day
- `2000-Q5` (invalid example) — A year has four quarters
- `2000-M13` (invalid example) — A year has twelve months
- `2000-01` (invalid example) — Gregorian month: the datatype yearmonth

## Sources

- doc: <https://github.com/sdmx-twg/sdmx-ml/blob/master/schemas/SDMXCommon.xsd>
- doc: <https://sdmx.org/standards-2/>
- wikipedia: <https://en.wikipedia.org/wiki/SDMX>

## Quality

Score 75/100. Missing: mapping (Wikidata, Schema.org, ...), translation, detector coverage.

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