1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
|
------------------------------------------------------------------------------
-- XML/Ada - An XML suite for Ada95 --
-- --
-- Copyright (C) 2005-2017, AdaCore --
-- --
-- This library is free software; you can redistribute it and/or modify it --
-- under terms of the GNU General Public License as published by the Free --
-- Software Foundation; either version 3, or (at your option) any later --
-- version. This library is distributed in the hope that it will be useful, --
-- but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHAN- --
-- TABILITY or FITNESS FOR A PARTICULAR PURPOSE. --
-- --
-- --
-- --
-- --
-- --
-- You should have received a copy of the GNU General Public License and --
-- a copy of the GCC Runtime Library Exception along with this program; --
-- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see --
-- <http://www.gnu.org/licenses/>. --
-- --
------------------------------------------------------------------------------
-- This package provides handling for the various time-related types found
-- in the XML schema standard.
-- This includes durations, dates, times, and combination of those.
--
-- We cannot use the standard Ada types to represent dates, since the range of
-- dates supported by XML is much broader (any year should be manageable),
-- which isn't supported directly by Ada.
--
-- These types also handle timezones, which means that sometimes two dates
-- might not be comparable if we do not know the timezone of one of them. The
-- precise semantics of the comparison of dates is defined in the XML Schema
-- standard part 3.
with Sax.Symbols; use Sax.Symbols;
with Sax.Utils; use Sax.Utils;
package Schema.Date_Time is
type Duration_T is private; -- A duration, no timezone
type Date_Time_T is private; -- A date and time, with timezone
type Date_T is private; -- A date, with timezone
type Time_T is private; -- A time, with timezone
type GDay_T is private; -- A day in a month, with timezone
type GMonth_Day_T is private; -- A month/day combination, with timezone
type GMonth_T is private; -- A month, with timezone
type GYear_T is private; -- A year, with timezone
type GYear_Month_T is private; -- A year/month combination, with timezone
No_Time_T : constant Time_T;
No_Duration : constant Duration_T;
No_Date_Time : constant Date_Time_T;
No_Date_T : constant Date_T;
No_GDay : constant GDay_T;
No_Month_Day : constant GMonth_Day_T;
No_Month : constant GMonth_T;
No_Year : constant GYear_T;
No_Year_Month : constant GYear_Month_T;
function Image (Date : Date_Time_T) return String;
-- Return the string representation of Date, as defined in the XML
-- schema standard, that is:
-- yyyy-mm-ddThh:mm:ss.sss+tz:tz
-- (year, month, day, hour, minutes, seconds, subseconds and timezone).
-- The subsecond field's precision is given by the precision of the
-- Duration type in Ada
function Image (Duration : Duration_T) return String;
function Image (Time : Time_T) return String;
function Image (Date : Date_T) return String;
function Image (Day : GDay_T) return String;
function Image (Day : GMonth_Day_T) return String;
function Image (Month : GMonth_T) return String;
function Image (Year : GYear_T) return String;
function Image (Month : GYear_Month_T) return String;
-- Return the string representation of the argument
procedure Value
(Symbols : Symbol_Table;
Ch : String;
Val : out Duration_T;
Error : out Symbol);
-- Return the duration stored in Ch. It should contain a string of the
-- type "PyyyyYmmM".
subtype Day_Duration is Duration range 0.0 .. 86_400.0;
function Sign (Duration : Duration_T) return Integer;
function Year (Duration : Duration_T) return Natural;
function Month (Duration : Duration_T) return Natural;
function Day (Duration : Duration_T) return Natural;
function Seconds (Duration : Duration_T) return Day_Duration;
-- Return the components of the duration. In general, you do not need to
-- use this directly, and can instead use the "+" operator below to
-- add it directly to a date.
procedure Value
(Symbols : Symbol_Table;
Ch : String;
Val : out Date_Time_T;
Error : out Symbol);
-- Return the date stored in Ch. It should contain a string with the format
-- yyyy-mm-ddThh:mm:ss.sss+tz:tz
-- Any number of digits is supported for the date and the subseconds field
function Year (Date : Date_Time_T) return Integer;
function Month (Date : Date_Time_T) return Natural;
function Day (Date : Date_Time_T) return Natural;
-- Return the components of Date
procedure Value
(Symbols : Symbol_Table;
Ch : String;
Val : out Time_T;
Error : out Symbol);
procedure Value
(Symbols : Symbol_Table;
Ch : String;
Val : out GDay_T;
Error : out Symbol);
procedure Value
(Symbols : Symbol_Table;
Ch : String;
Val : out GMonth_Day_T;
Error : out Symbol);
procedure Value
(Symbols : Symbol_Table;
Ch : String;
Val : out GYear_T;
Error : out Symbol);
procedure Value
(Symbols : Symbol_Table;
Ch : String;
Val : out GMonth_T;
Error : out Symbol);
procedure Value
(Symbols : Symbol_Table;
Ch : String;
Val : out GYear_Month_T;
Error : out Symbol);
procedure Value
(Symbols : Symbol_Table;
Ch : String;
Val : out Date_T;
Error : out Symbol);
-- Return the date stored in Ch. The format of the string is specified in
-- the XML Schema specifications
function "+"
(Date : Date_Time_T; Duration : Duration_T) return Date_Time_T;
-- Add duration to Date, according to the algorithm described in appendix
-- E of the XML Schema standard
function "<" (Time1, Time2 : Date_Time_T) return Boolean;
function "<=" (Time1, Time2 : Date_Time_T) return Boolean;
function "=" (Time1, Time2 : Date_Time_T) return Boolean;
function ">" (Time1, Time2 : Date_Time_T) return Boolean;
function ">=" (Time1, Time2 : Date_Time_T) return Boolean;
-- Raises Not_Comparable if the two dates are not comparable according
-- to the XML Schema standard.
function "<" (Duration1, Duration2 : Duration_T) return Boolean;
function "<=" (Duration1, Duration2 : Duration_T) return Boolean;
function "=" (Duration1, Duration2 : Duration_T) return Boolean;
function ">" (Duration1, Duration2 : Duration_T) return Boolean;
function ">=" (Duration1, Duration2 : Duration_T) return Boolean;
-- Raises Not_Comparable if the two dates are not comparable according
-- to the XML Schema standard.
function "<" (Time1, Time2 : Time_T) return Boolean;
function "<=" (Time1, Time2 : Time_T) return Boolean;
function "=" (Time1, Time2 : Time_T) return Boolean;
function ">" (Time1, Time2 : Time_T) return Boolean;
function ">=" (Time1, Time2 : Time_T) return Boolean;
-- Raises Not_Comparable if the two times are not comparable according
-- to the XML Schema standard.
function "<" (Date1, Date2 : Date_T) return Boolean;
function "<=" (Date1, Date2 : Date_T) return Boolean;
function "=" (Date1, Date2 : Date_T) return Boolean;
function ">" (Date1, Date2 : Date_T) return Boolean;
function ">=" (Date1, Date2 : Date_T) return Boolean;
-- Raises Not_Comparable if the two times are not comparable according
-- to the XML Schema standard.
function "<" (Day1, Day2 : GDay_T) return Boolean;
function "<=" (Day1, Day2 : GDay_T) return Boolean;
function "=" (Day1, Day2 : GDay_T) return Boolean;
function ">" (Day1, Day2 : GDay_T) return Boolean;
function ">=" (Day1, Day2 : GDay_T) return Boolean;
-- Raises Not_Comparable if the two times are not comparable according
-- to the XML Schema standard.
function "<" (Day1, Day2 : GMonth_Day_T) return Boolean;
function "<=" (Day1, Day2 : GMonth_Day_T) return Boolean;
function "=" (Day1, Day2 : GMonth_Day_T) return Boolean;
function ">" (Day1, Day2 : GMonth_Day_T) return Boolean;
function ">=" (Day1, Day2 : GMonth_Day_T) return Boolean;
-- Raises Not_Comparable if the two times are not comparable according
-- to the XML Schema standard.
function "<" (Month1, Month2 : GMonth_T) return Boolean;
function "<=" (Month1, Month2 : GMonth_T) return Boolean;
function "=" (Month1, Month2 : GMonth_T) return Boolean;
function ">" (Month1, Month2 : GMonth_T) return Boolean;
function ">=" (Month1, Month2 : GMonth_T) return Boolean;
-- Raises Not_Comparable if the two times are not comparable according
-- to the XML Schema standard.
function "<" (Month1, Month2 : GYear_Month_T) return Boolean;
function "<=" (Month1, Month2 : GYear_Month_T) return Boolean;
function "=" (Month1, Month2 : GYear_Month_T) return Boolean;
function ">" (Month1, Month2 : GYear_Month_T) return Boolean;
function ">=" (Month1, Month2 : GYear_Month_T) return Boolean;
-- Raises Not_Comparable if the two times are not comparable according
-- to the XML Schema standard.
function "<" (Year1, Year2 : GYear_T) return Boolean;
function "<=" (Year1, Year2 : GYear_T) return Boolean;
function "=" (Year1, Year2 : GYear_T) return Boolean;
function ">" (Year1, Year2 : GYear_T) return Boolean;
function ">=" (Year1, Year2 : GYear_T) return Boolean;
-- Raises Not_Comparable if the two times are not comparable according
-- to the XML Schema standard.
Not_Comparable : exception;
private
subtype Day_Range is Duration range -86_400.0 .. 86_400.0;
type Timezone_T is new Integer;
No_Timezone : constant Timezone_T := Timezone_T'Last;
-- A timezone indicator. This is an offset, in minutes, to UTC.
type Date_NZ_T is record
Year, Month, Day : Integer;
end record;
No_Date_NZ : constant Date_NZ_T := (0, 0, 0);
-- A non-timezoned date.
type GDay_T is record
Day : Integer;
TZ : Timezone_T;
end record;
No_Gday : constant GDay_T := (0, No_Timezone);
type GMonth_Day_T is record
Month, Day : Integer;
TZ : Timezone_T;
end record;
No_Month_Day : constant GMonth_Day_T := (0, 0, No_Timezone);
type GMonth_T is record
Month : Integer;
TZ : Timezone_T;
end record;
No_Month : constant GMonth_T := (0, No_Timezone);
type GYear_T is record
Year : Integer;
TZ : Timezone_T;
end record;
No_Year : constant GYear_T := (0, No_Timezone);
type GYear_Month_T is record
Year, Month : Integer;
TZ : Timezone_T;
end record;
No_Year_Month : constant GYear_Month_T := (0, 0, No_Timezone);
subtype Time_NZ_T is Day_Range;
No_Time_NZ : constant Time_NZ_T := 0.0;
-- A non-timezoned time
type Duration_T is record
Sign : Integer;
Year, Month, Day : Natural;
Seconds : Duration;
end record;
No_Duration : constant Duration_T := (1, 0, 0, 0, 0.0);
-- A negative duration is representated by having all fields to a negative
-- value.
type Date_T is record
Date : Date_NZ_T;
TZ : Timezone_T;
end record;
No_Date_T : constant Date_T := (No_Date_NZ, No_Timezone);
-- A timezoned date. TZ is the timezone offset in minutes. It is set to
-- Integer'Last if there is no timezone specified
type Time_T is record
Time : Time_NZ_T;
TZ : Timezone_T;
end record;
No_Time_T : constant Time_T := (No_Time_NZ, No_Timezone);
-- A timezoned time
type Date_Time_T is record
Date : Date_NZ_T;
Time : Time_NZ_T;
TZ : Timezone_T;
end record;
No_Date_Time : constant Date_Time_T :=
(No_Date_NZ, No_Time_NZ, No_Timezone);
-- TZ is the timezone offset, in minutes. TZ is set to Integer'Last if
-- there is no timezone specified
end Schema.Date_Time;
|
