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

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

From 5.1 to 5.2 From 5.5 to 5.6

From version 5.2

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

Change comment: There is no comment for this version

To version 5.5

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

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,50 +371,47 @@
  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 **o **Standard Time Period**
++* **Observational Time Period**
++** **Standard Time Period**
++*** **Basic Time Period**
++**** **Gregorian Time Period**
++**** //Date Time//
++*** **Reporting Time Period**
++** //Time Range//
--                                                        §    **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
--Period: the start of January 1 to the end of December 31 **Gregorian Year Month**:
--
++**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
--Period: the start of the first day of the month to end of the last day of the month **Gregorian Day**:
--
++**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:
@@ -421,75 +421,52 @@
  [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)
--Representation: common:ReportingYearType (YYYY-A1, e.g. 2000-A1) **Reporting Semester:**
--
--                           Period Indicator: S
--
++**Reporting Semester:**
++Period Indicator: S
  Period Duration: P6M (six months)
--
  Limit per year: 2
++Representation: common:ReportingSemesterType (YYYY-Ss, e.g. 2000-S2)
--Representation: common:ReportingSemesterType (YYYY-Ss, e.g. 2000-S2) **Reporting Trimester:**
--
--                           Period Indicator: T
--
++**Reporting Trimester:**
++Period Indicator: T
  Period Duration: P4M (four months)
--
  Limit per year: 3
++Representation: common:ReportingTrimesterType (YYYY-Tt, e.g. 2000-T3)
--Representation: common:ReportingTrimesterType (YYYY-Tt, e.g. 2000-T3) **Reporting Quarter:**
--
--                           Period Indicator: Q
--
++**Reporting Quarter:**
++Period Indicator: Q
  Period Duration: P3M (three months)
--
  Limit per year: 4
++Representation: common:ReportingQuarterType (YYYY-Qq, e.g. 2000-Q4)
--Representation: common:ReportingQuarterType (YYYY-Qq, e.g. 2000-Q4) **Reporting Month**:
--
++**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.
@@ -500,55 +500,39 @@
  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.
--11.
--111.
--1111. **If [REPORTING_YEAR_START_DATE] is a Friday, Saturday, or Sunday:**
--
++**a) If the [PERIOD_INDICATOR] is W:
++~1. 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].
--1.
--11.
--111.
--1111. **If [REPORTING_YEAR_START_DATE] is a Monday, Tuesday, Wednesday, or Thursday:**
--
++2. **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]
--b) **Else:**
++**2. Determine [PERIOD_DURATION]:**
--The [REPORTING_YEAR_START_DATE] is the [REPORTING_YEAR_BASE].
++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.
--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]:**
--
++**3. 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].
--1. **Determine the [PERIOD_END]:**
--
++**4. Determine the [PERIOD_END]:**
  Multiply the [PERIOD_VALUE] by the [PERIOD_DURATION]. Add^^3^^ this to the [REPORTING_YEAR_BASE] add^^3^^ -P1D. The result is the [PERIOD_END].
  For all of these ranges, the bounds include the beginning of the [PERIOD_START] (i.e. 00:00:00) and the end of the [PERIOD_END] (i.e. 23:59:59).
--**Examples: **
++**Examples:
++2010-Q2, REPORTING_YEAR_START_DAY = ~-~-07-01 (July 1)**
--**2010-Q2, REPORTING_YEAR_START_DAY = ~-~-07-01 (July 1)**
--
  ~1. [REPORTING_YEAR_START_DATE] = 2010-07-01
  b) [REPORTING_YEAR_BASE] = 2010-07-01