Skip to Content
Last modified by Artur on 2025/09/10 11:19
From version 2.6
edited by Helena
on 2025/06/08 23:41
Change comment: There is no comment for this version
To version 1.14
edited by Helena
on 2025/06/08 23:36
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -95,8 +95,8 @@
95 95  The above looks like this, in JSON schema:
96 96  
97 97  > "idType": {
98 -> "type": "string",
99 -> "pattern": "^[A-Za-z0-9_@$-]+$"
98 +> "type": "string",
99 +> "pattern": "^[A-Za-z0-9_@$-]+$"
100 100  > }
101 101  
102 102  There are also cases, though, that data types cannot be mapped like above. One such case is the array data type, which was introduced in SDMX 3.0 as a new representation. In JSON schema an array is already natively foreseen, while in the XML schema, this has to be defined as a complex type, with an SDMX specific definition (i.e., specific element/attribute names for SDMX). Beyond that, the minimum and/or maximum number of items within an array is possible in both cases.
... ... @@ -103,28 +103,47 @@
103 103  
104 104  Further to the above, the mapping between the non-native data types is presented in the table below:
105 105  
106 -(% style="width:1005.83px" %)
107 -|(% style="width:198px" %)**SDMX Facet**|(% style="width:241px" %)**XML Schema**|(% style="width:563px" %)**JSON schema **"**pattern**"{{footnote}}Regular expressions, as specified in W3C XML Schema Definition Language (XSD) 1.1 Part 2: Datatypes.{{/footnote}} **for "string" type**
108 -|(% style="width:198px" %)GregorianYear|(% style="width:241px" %)xsd:gYear|(% style="width:563px" %)(((
109 -"^-?([1-9][0-9]{3,}|0[0-9]{3})(Z|(\+|-)((0[0-9]|1[0-3]):[0-5][0-9]|14:00))?$"
106 +|**SDMX Facet**|**XML Schema**|**JSON schema **"**pattern**"[[(% class="wikiinternallink wikiinternallink" %)^^~[1~]^^>>path:#_ftn1]](%%) **for "string" type**
107 +|GregorianYear|xsd:gYear|(((
108 +"^-?([1-9][0-9]{3,}|0[0-9]{3})(Z|(\+|-)((0[0-
109 +
110 +9]|1[0-3]):[0-5][0-9]|14:00))?$"
110 110  )))
111 -|(% style="width:198px" %)GregorianMonth|(% style="width:241px" %)xsd:gYearMonth|(% style="width:563px" %)(((
112 -"^-?([1-9][0-9]{3,}|0[0-9]{3})-(0[1-9]|1[0-2])(Z|(\+|-)((0[0-9]|1[0-3]):[0-5][0-9]|14:00))?$"
112 +|GregorianMonth|xsd:gYearMonth|(((
113 +"^-?([1-9][0-9]{3,}|0[0-9]{3})-(0[1-9]|1[0-
114 +
115 +2])(Z|(\+|-)((0[0-9]|1[0-3]):[0-5][0-
116 +
117 +9]|14:00))?$"
113 113  )))
114 -|(% style="width:198px" %)GregorianDay|(% style="width:241px" %)xsd:date|(% style="width:563px" %)(((
115 -"^-?([1-9][0-9]{3,}|0[0-9]{3})-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])(Z|(\+|-)((0[0-9]|1[0-3]):[0-5][0-9]|14:00))?$"
119 +|GregorianDay|xsd:date|(((
120 +"^-?([1-9][0-9]{3,}|0[0-9]{3})-(0[1-9]|1[0-2])-
121 +
122 +(0[1-9]|[12][0-9]|3[01])(Z|(\+|-)((0[0-9]|1[0-
123 +
124 +3]):[0-5][0-9]|14:00))?$"
116 116  )))
117 -|(% style="width:198px" %)Day|(% style="width:241px" %)xsd:gDay|(% style="width:563px" %)(((
118 -"^~-~--(0[1-9]|[12][0-9]|3[01])(Z|(\+|-)((0[0-9]|1[0-3]):[0-5][0-9]|14:00))?$"
126 +|Day|xsd:gDay|(((
127 +"^~-~--(0[1-9]|[12][0-9]|3[01])(Z|(\+|-
128 +
129 +)((0[0-9]|1[0-3]):[0-5][0-9]|14:00))?$"
119 119  )))
120 -|(% style="width:198px" %)MonthDay|(% style="width:241px" %)xsd:gMonthDay|(% style="width:563px" %)(((
121 -"^~-~-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])(Z|(\+|-)((0[0-9]|1[0-3]):[0-5][0-9]|14:00))?$"
131 +|MonthDay|xsd:gMonthDay|(((
132 +"^~-~-(0[1-9]|1[0-2])-(0[1-9]|[12][0-
133 +
134 +9]|3[01])(Z|(\+|-)((0[0-9]|1[0-3]):[0-5][0-
135 +
136 +9]|14:00))?$"
122 122  )))
123 -|(% style="width:198px" %)Month|(% style="width:241px" %)xsd:Month|(% style="width:563px" %)(((
124 -"^~-~-(0[1-9]|1[0-2])(Z|(\+|-)((0[0-9]|1[0-3]):[0-5][0-9]|14:00))?$"
138 +|Month|xsd:Month|(((
139 +"^~-~-(0[1-9]|1[0-2])(Z|(\+|-)((0[0-9]|1[0-
140 +
141 +3]):[0-5][0-9]|14:00))?$"
125 125  )))
126 -|(% style="width:198px" %)Duration|(% style="width:241px" %)xsd:duration|(% style="width:563px" %)(((
127 -"^-?P[0-9]+Y?([0-9]+M)?([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+(\.[0-9]+)?S)?)?$"
143 +|Duration|xsd:duration|(((
144 +"^-?P[0-9]+Y?([0-9]+M)?([0-9]+D)?(T([0-
145 +
146 +9]+H)?([0-9]+M)?([0-9]+(\.[0-9]+)?S)?)?$"
128 128  )))
129 129  
130 130  == 4.2 Time and Time Format ==
... ... @@ -139,14 +139,15 @@
139 139  
140 140  The hierarchy of time formats is as follows (**bold** indicates a category which is made up of multiple formats, //italic// indicates a distinct format):
141 141  
142 -* **Observational Time Period**
143 -** **Standard Time Period**
144 -*** **Basic Time Period**
145 -**** **Gregorian Time Period**
146 -**** //Date Time//
147 -*** **Reporting Time Period**
148 -** //Time Range//
161 +* **Observational Time Period **o **Standard Time Period**
149 149  
163 + § **Basic Time Period**
164 +
165 +* **Gregorian Time Period**
166 +* //Date Time//
167 +
168 +§ **Reporting Time Period **o //Time Range//
169 +
150 150  The details of these time period categories and of the distinct formats which make them up are detailed in the sections to follow.
151 151  
152 152  === 4.2.2 Observational Time Period ===
... ... @@ -162,12 +162,11 @@
162 162  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:
163 163  
164 164  **Gregorian Year:**
185 +
165 165  Representation: xs:gYear (YYYY)
166 -Period: the start of January 1 to the end of December 31
167 -**Gregorian Year Month**:
187 +Period: the start of January 1 to the end of December 31 **Gregorian Year Month**:
168 168  Representation: xs:gYearMonth (YYYY-MM)
169 -Period: the start of the first day of the month to end of the last day of the month
170 -**Gregorian Day**:
189 +Period: the start of the first day of the month to end of the last day of the month **Gregorian Day**:
171 171  Representation: xs:date (YYYY-MM-DD)
172 172  Period: the start of the day (00:00:00) to the end of the day (23:59:59)
173 173  
... ... @@ -175,7 +175,7 @@
175 175  
176 176  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.
177 177  
178 -Representation: xs:dateTime (YYYY-MM-DDThh:mm:ss){{footnote}}The seconds can be reported fractionally{{/footnote}}
197 +Representation: xs:dateTime (YYYY-MM-DDThh:mm:ss)[[(% class="wikiinternallink wikiinternallink" %)^^~[2~]^^>>path:#_ftn2]]
179 179  
180 180  === 4.2.6 Standard Reporting Period ===
181 181  
... ... @@ -244,7 +244,7 @@
244 244  
245 245  Representation: common:ReportingWeekType (YYYY-Www, e.g. 2000-W53)
246 246  
247 -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" %)^^~[3~]^^>>path:#_ftn3]](%%) 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.
266 +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" %)^^~[3~]^^>>path:#_ftn3]](%%) 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.
248 248  
249 249  **Reporting Day**:
250 250  
... ... @@ -276,7 +276,7 @@
276 276  11. **If the [PERIOD_INDICATOR] is W:**
277 277  111. **If [REPORTING_YEAR_START_DATE] is a Friday, Saturday, or Sunday:**
278 278  
279 -Add[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[4~]^^>>path:#_ftn4]](%%) (P3D, P2D, or P1D respectively) to the [REPORTING_YEAR_START_DATE]. The result is the [REPORTING_YEAR_BASE].
298 +Add[[(% class="wikiinternallink wikiinternallink" %)^^~[4~]^^>>path:#_ftn4]](%%) (P3D, P2D, or P1D respectively) to the [REPORTING_YEAR_START_DATE]. The result is the [REPORTING_YEAR_BASE].
280 280  
281 281  1.
282 282  11.
... ... @@ -577,5 +577,4 @@
577 577  
578 578  [[~[4~]>>path:#_ftnref4]] The rules for adding durations to a date time are described in the W3C XML Schema specification. See [[http:~~/~~/www.w3.org/TR/xmlschema>>url:http://www.w3.org/TR/xmlschema-2/#adding-durations-to-dateTimes]][[->>url:http://www.w3.org/TR/xmlschema-2/#adding-durations-to-dateTimes]][[2/#adding>>url:http://www.w3.org/TR/xmlschema-2/#adding-durations-to-dateTimes]][[->>url:http://www.w3.org/TR/xmlschema-2/#adding-durations-to-dateTimes]][[durations>>url:http://www.w3.org/TR/xmlschema-2/#adding-durations-to-dateTimes]][[->>url:http://www.w3.org/TR/xmlschema-2/#adding-durations-to-dateTimes]][[to>>url:http://www.w3.org/TR/xmlschema-2/#adding-durations-to-dateTimes]][[dateTimes>>url:http://www.w3.org/TR/xmlschema-2/#adding-durations-to-dateTimes]][[ >>url:http://www.w3.org/TR/xmlschema-2/#adding-durations-to-dateTimes]]for further details.
579 579  
580 -
581 -{{putFootnotes/}}
599 +