Changes for page SDMX 2.1 Standards. Section 6. Technical Notes

Last modified by Artur on 2025/08/19 10:43

From 5.2 to 5.1 From 5.5 to 5.4

From version 5.4

edited by Helena
on 2025/05/21 21:50

Change comment: There is no comment for this version

To version 5.2

edited by Helena
on 2025/05/21 21:41

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -371,47 +371,50 @@
  The hierarchy of time formats is as follows (**bold** indicates a category which is made up of multiple formats, //italic// indicates a distinct format):
--* **Observational Time Period**
--** **Standard Time Period**
--*** **Basic Time Period**
--**** **Gregorian Time Period**
--**** //Date Time//
--*** **Reporting Time Period**
--** //Time Range//
++* **Observational Time Period **o **Standard Time Period**
++                                                        §    **Basic Time Period**
++
++* **Gregorian Time Period**
++* //Date Time//
++
++§   **Reporting Time Period **o //Time Range//
++
  The details of these time period categories and of the distinct formats which make them up are detailed in the sections to follow.
--=== 4.2.2 Observational Time Period ===
++==== 4.2.2 Observational Time Period ====
  This is the superset of all time representations in SDMX. This allows for time to be expressed as any of the allowable formats.
--=== 4.2.3 Standard Time Period ===
++==== 4.2.3 Standard Time Period ====
  This is the superset of any predefined time period or a distinct point in time. A time period consists of a distinct start and end point. If the start and end of a period are expressed as date instead of a complete date time, then it is implied that the start of the period is the beginning of the start day (i.e. 00:00:00) and the end of the period is the end of the end day (i.e. 23:59:59).
--=== 4.2.4 Gregorian Time Period ===
++==== 4.2.4 Gregorian Time Period ====
  A Gregorian time period is always represented by a Gregorian year, year-month, or day. These are all based on ISO 8601 dates. The representation in SDMX-ML messages and the period covered by each of the Gregorian time periods are as follows:
--**Gregorian Year:**
++**Gregorian Year:**
++
  Representation: xs:gYear (YYYY)
--Period: the start of January 1 to the end of December 31
--**Gregorian Year Month**:
++Period: the start of January 1 to the end of December 31 **Gregorian Year Month**:
++
  Representation: xs:gYearMonth (YYYY-MM)
--Period: the start of the first day of the month to end of the last day of the month
--**Gregorian Day**:
++Period: the start of the first day of the month to end of the last day of the month **Gregorian Day**:
++
  Representation: xs:date (YYYY-MM-DD)
++
  Period: the start of the day (00:00:00) to the end of the day (23:59:59)
--=== 4.2.5 Date Time ===
++==== 4.2.5 Date Time ====
  This is used to unambiguously state that a date-time represents an observation at a single point in time. Therefore, if one wants to use SDMX for data which is measured at a distinct point in time rather than being reported over a period, the date-time representation can be used.
  Representation: xs:dateTime (YYYY-MM-DDThh:mm:ss)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[1~]^^>>path:#_ftn1]]
--=== 4.2.6 Standard Reporting Period ===
++==== 4.2.6 Standard Reporting Period ====
  Standard reporting periods are periods of time in relation to a reporting year. Each of these standard reporting periods has a duration (based on the ISO 8601 definition) associated with it. The general format of a reporting period is as follows:
@@ -418,52 +418,75 @@
  [REPORTING_YEAR]-[PERIOD_INDICATOR][PERIOD_VALUE]
  Where:
++
  REPORTING_YEAR represents the reporting year as four digits (YYYY) PERIOD_INDICATOR identifies the type of period which determines the duration of the period
++
  PERIOD_VALUE indicates the actual period within the year
  The following section details each of the standard reporting periods defined in SDMX:
--**Reporting Year**:
--Period Indicator: A
++**Reporting Year**:
++
++                           Period Indicator: A
++
  Period Duration: P1Y (one year)
++
  Limit per year: 1
--Representation: common:ReportingYearType (YYYY-A1, e.g. 2000-A1)
--**Reporting Semester:**
--Period Indicator: S
++Representation: common:ReportingYearType (YYYY-A1, e.g. 2000-A1) **Reporting Semester:**
++
++                           Period Indicator: S
++
  Period Duration: P6M (six months)
++
  Limit per year: 2
--Representation: common:ReportingSemesterType (YYYY-Ss, e.g. 2000-S2)
--**Reporting Trimester:**
--Period Indicator: T
++Representation: common:ReportingSemesterType (YYYY-Ss, e.g. 2000-S2) **Reporting Trimester:**
++
++                           Period Indicator: T
++
  Period Duration: P4M (four months)
++
  Limit per year: 3
--Representation: common:ReportingTrimesterType (YYYY-Tt, e.g. 2000-T3)
--**Reporting Quarter:**
--Period Indicator: Q
++Representation: common:ReportingTrimesterType (YYYY-Tt, e.g. 2000-T3) **Reporting Quarter:**
++
++                           Period Indicator: Q
++
  Period Duration: P3M (three months)
++
  Limit per year: 4
--Representation: common:ReportingQuarterType (YYYY-Qq, e.g. 2000-Q4)
--**Reporting Month**:
++Representation: common:ReportingQuarterType (YYYY-Qq, e.g. 2000-Q4) **Reporting Month**:
++
  Period Indicator: M
++
  Period Duration: P1M (one month)
++
  Limit per year: 1
++
  Representation: common:ReportingMonthType (YYYY-Mmm, e.g. 2000-M12) Notes: The reporting month is always represented as two digits, therefore 1-9 are 0 padded (e.g. 01). This allows the values to be sorted chronologically using textual sorting methods.
  **Reporting Week**:
++
  Period Indicator: W
++
  Period Duration: P7D (seven days)
++
  Limit per year: 53
++
  Representation: common:ReportingWeekType (YYYY-Www, e.g. 2000-W53)
++
  Notes: There are either 52 or 53 weeks in a reporting year. This is based on the ISO 8601 definition of a week (Monday - Saturday), where the first week of a reporting year is defined as the week with the first Thursday on or after the reporting year start day.[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[2~]^^>>path:#_ftn2]](%%) The reporting week is always represented as two digits, therefore 1-9 are 0 padded (e.g. 01). This allows the values to be sorted chronologically using textual sorting methods.
  **Reporting Day**:
++
  Period Indicator: D
++
  Period Duration: P1D (one day)
++
  Limit per year: 366
++
  Representation: common:ReportingDayType (YYYY-Dddd, e.g. 2000-D366) Notes: There are either 365 or 366 days in a reporting year, depending on whether the reporting year includes leap day (February 29). The reporting day is always represented as three digits, therefore 1-99 are 0 padded (e.g. 001).
  This allows the values to be sorted chronologically using textual sorting methods.
@@ -474,29 +474,43 @@
  Since the duration and the reporting year start day are known for any reporting period, it is possible to relate any reporting period to a distinct calendar period. The actual Gregorian calendar period covered by the reporting period can be computed as follows (based on the standard format of [REPROTING_YEAR][PERIOD_INDICATOR][PERIOD_VALUE] and the reporting year start day as [REPORTING_YEAR_START_DAY]):
--**~1. Determine [REPORTING_YEAR_BASE]:**
++1. **Determine [REPORTING_YEAR_BASE]:**
++
  Combine [REPORTING_YEAR] of the reporting period value (YYYY) with [REPORTING_YEAR_START_DAY] (MM-DD) to get a date (YYYY-MM-DD).
++
  This is the [REPORTING_YEAR_START_DATE]
--**a) If the [PERIOD_INDICATOR] is W:
--~1. If [REPORTING_YEAR_START_DATE] is a Friday, Saturday, or Sunday:**
++
++**a) If the [PERIOD_INDICATOR] is W:**
++
++1.
++11.
++111.
++1111. **If [REPORTING_YEAR_START_DATE] is a Friday, Saturday, or Sunday:**
++
  Add^^3^^ (P3D, P2D, or P1D respectively) to the [REPORTING_YEAR_START_DATE]. The result is the [REPORTING_YEAR_BASE].
--2. **If [REPORTING_YEAR_START_DATE] is a Monday, Tuesday, Wednesday, or Thursday:**
++1.
++11.
++111.
++1111. **If [REPORTING_YEAR_START_DATE] is a Monday, Tuesday, Wednesday, or Thursday:**
++
  Add^^3^^ (P0D, -P1D, -P2D, or -P3D respectively) to the [REPORTING_YEAR_START_DATE]. The result is the [REPORTING_YEAR_BASE].
--b) **Else:**
--The [REPORTING_YEAR_START_DATE] is the [REPORTING_YEAR_BASE]
--**2. Determine [PERIOD_DURATION]:**
++b) **Else:**
--a) If the [PERIOD_INDICATOR] is A, the [PERIOD_DURATION] is P1Y.
--b) If the [PERIOD_INDICATOR] is S, the [PERIOD_DURATION] is P6M.
--c) If the [PERIOD_INDICATOR] is T, the [PERIOD_DURATION] is P4M.
--d) If the [PERIOD_INDICATOR] is Q, the [PERIOD_DURATION] is P3M.
--e) If the [PERIOD_INDICATOR] is M, the [PERIOD_DURATION] is P1M.
--f) If the [PERIOD_INDICATOR] is W, the [PERIOD_DURATION] is P7D.
--g) If the [PERIOD_INDICATOR] is D, the [PERIOD_DURATION] is P1D.
++The [REPORTING_YEAR_START_DATE] is the [REPORTING_YEAR_BASE].
--**3. Determine [PERIOD_START]:**
++1. **Determine [PERIOD_DURATION]:**
++11.
++111. If the [PERIOD_INDICATOR] is A, the [PERIOD_DURATION] is P1Y.
++111. If the [PERIOD_INDICATOR] is S, the [PERIOD_DURATION] is P6M.
++111. If the [PERIOD_INDICATOR] is T, the [PERIOD_DURATION] is P4M.
++111. If the [PERIOD_INDICATOR] is Q, the [PERIOD_DURATION] is P3M.
++111. If the [PERIOD_INDICATOR] is M, the [PERIOD_DURATION] is P1M.
++111. If the [PERIOD_INDICATOR] is W, the [PERIOD_DURATION] is P7D.
++111. If the [PERIOD_INDICATOR] is D, the [PERIOD_DURATION] is P1D.
++1. **Determine [PERIOD_START]:**
++
  Subtract one from the [PERIOD_VALUE] and multiply this by the [PERIOD_DURATION]. Add[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[3~]^^>>path:#_ftn3]](%%) this to the [REPORTING_YEAR_BASE]. The result is the [PERIOD_START].
 . **Determine the [PERIOD_END]:**