1 ------------------------------------------------------------------------------
3 -- GNAT RUN-TIME COMPONENTS --
5 -- A D A . C A L E N D A R --
9 -- Copyright (C) 1992-2015, Free Software Foundation, Inc. --
11 -- GNAT is free software; you can redistribute it and/or modify it under --
12 -- terms of the GNU General Public License as published by the Free Soft- --
13 -- ware Foundation; either version 3, or (at your option) any later ver- --
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE. --
18 -- As a special exception under Section 7 of GPL version 3, you are granted --
19 -- additional permissions described in the GCC Runtime Library Exception, --
20 -- version 3.1, as published by the Free Software Foundation. --
22 -- You should have received a copy of the GNU General Public License and --
23 -- a copy of the GCC Runtime Library Exception along with this program; --
24 -- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see --
25 -- <http://www.gnu.org/licenses/>. --
27 -- GNAT was originally developed by the GNAT team at New York University. --
28 -- Extensive contributions were provided by Ada Core Technologies Inc. --
30 ------------------------------------------------------------------------------
32 with Ada
.Unchecked_Conversion
;
36 with System
.OS_Primitives
;
38 package body Ada
.Calendar
with
42 --------------------------
43 -- Implementation Notes --
44 --------------------------
46 -- In complex algorithms, some variables of type Ada.Calendar.Time carry
47 -- suffix _S or _N to denote units of seconds or nanoseconds.
49 -- Because time is measured in different units and from different origins
50 -- on various targets, a system independent model is incorporated into
51 -- Ada.Calendar. The idea behind the design is to encapsulate all target
52 -- dependent machinery in a single package, thus providing a uniform
53 -- interface to all existing and any potential children.
55 -- package Ada.Calendar
56 -- procedure Split (5 parameters) -------+
57 -- | Call from local routine
59 -- package Formatting_Operations |
60 -- procedure Split (11 parameters) <--+
61 -- end Formatting_Operations |
64 -- package Ada.Calendar.Formatting | Call from child routine
65 -- procedure Split (9 or 10 parameters) -+
66 -- end Ada.Calendar.Formatting
68 -- The behavior of the interfacing routines is controlled via various
69 -- flags. All new Ada 2005 types from children of Ada.Calendar are
70 -- emulated by a similar type. For instance, type Day_Number is replaced
71 -- by Integer in various routines. One ramification of this model is that
72 -- the caller site must perform validity checks on returned results.
73 -- The end result of this model is the lack of target specific files per
74 -- child of Ada.Calendar (e.g. a-calfor).
76 -----------------------
77 -- Local Subprograms --
78 -----------------------
80 procedure Check_Within_Time_Bounds
(T
: Time_Rep
);
81 -- Ensure that a time representation value falls withing the bounds of Ada
82 -- time. Leap seconds support is taken into account.
84 procedure Cumulative_Leap_Seconds
85 (Start_Date
: Time_Rep
;
87 Elapsed_Leaps
: out Natural;
88 Next_Leap
: out Time_Rep
);
89 -- Elapsed_Leaps is the sum of the leap seconds that have occurred on or
90 -- after Start_Date and before (strictly before) End_Date. Next_Leap_Sec
91 -- represents the next leap second occurrence on or after End_Date. If
92 -- there are no leaps seconds after End_Date, End_Of_Time is returned.
93 -- End_Of_Time can be used as End_Date to count all the leap seconds that
94 -- have occurred on or after Start_Date.
96 -- Note: Any sub seconds of Start_Date and End_Date are discarded before
97 -- the calculations are done. For instance: if 113 seconds is a leap
98 -- second (it isn't) and 113.5 is input as an End_Date, the leap second
99 -- at 113 will not be counted in Leaps_Between, but it will be returned
100 -- as Next_Leap_Sec. Thus, if the caller wants to know if the End_Date is
101 -- a leap second, the comparison should be:
103 -- End_Date >= Next_Leap_Sec;
105 -- After_Last_Leap is designed so that this comparison works without
106 -- having to first check if Next_Leap_Sec is a valid leap second.
108 function Duration_To_Time_Rep
is
109 new Ada
.Unchecked_Conversion
(Duration, Time_Rep
);
110 -- Convert a duration value into a time representation value
112 function Time_Rep_To_Duration
is
113 new Ada
.Unchecked_Conversion
(Time_Rep
, Duration);
114 -- Convert a time representation value into a duration value
116 function UTC_Time_Offset
118 Is_Historic
: Boolean) return Long_Integer;
119 -- This routine acts as an Ada wrapper around __gnat_localtime_tzoff which
120 -- in turn utilizes various OS-dependent mechanisms to calculate the time
121 -- zone offset of a date. Formal parameter Date represents an arbitrary
122 -- time stamp, either in the past, now, or in the future. If the flag
123 -- Is_Historic is set, this routine would try to calculate to the best of
124 -- the OS's abilities the time zone offset that was or will be in effect
125 -- on Date. If the flag is set to False, the routine returns the current
126 -- time zone with Date effectively set to Clock.
128 -- NOTE: Targets which support localtime_r will aways return a historic
129 -- time zone even if flag Is_Historic is set to False because this is how
130 -- localtime_r operates.
136 -- An integer time duration. The type is used whenever a positive elapsed
137 -- duration is needed, for instance when splitting a time value. Here is
138 -- how Time_Rep and Time_Dur are related:
140 -- 'First Ada_Low Ada_High 'Last
141 -- Time_Rep: +-------+------------------------+---------+
142 -- Time_Dur: +------------------------+---------+
145 type Time_Dur
is range 0 .. 2 ** 63 - 1;
147 --------------------------
148 -- Leap seconds control --
149 --------------------------
152 pragma Import
(C
, Flag
, "__gl_leap_seconds_support");
153 -- This imported value is used to determine whether the compilation had
154 -- binder flag "-y" present which enables leap seconds. A value of zero
155 -- signifies no leap seconds support while a value of one enables support.
157 Leap_Support
: constant Boolean := (Flag
= 1);
158 -- Flag to controls the usage of leap seconds in all Ada.Calendar routines
160 Leap_Seconds_Count
: constant Natural := 25;
162 ---------------------
163 -- Local Constants --
164 ---------------------
166 Ada_Min_Year
: constant Year_Number
:= Year_Number
'First;
167 Secs_In_Four_Years
: constant := (3 * 365 + 366) * Secs_In_Day
;
168 Secs_In_Non_Leap_Year
: constant := 365 * Secs_In_Day
;
169 Nanos_In_Four_Years
: constant := Secs_In_Four_Years
* Nano
;
171 -- Lower and upper bound of Ada time. The zero (0) value of type Time is
172 -- positioned at year 2150. Note that the lower and upper bound account
173 -- for the non-leap centennial years.
175 Ada_Low
: constant Time_Rep
:= -(61 * 366 + 188 * 365) * Nanos_In_Day
;
176 Ada_High
: constant Time_Rep
:= (60 * 366 + 190 * 365) * Nanos_In_Day
;
178 -- Even though the upper bound of time is 2399-12-31 23:59:59.999999999
179 -- UTC, it must be increased to include all leap seconds.
181 Ada_High_And_Leaps
: constant Time_Rep
:=
182 Ada_High
+ Time_Rep
(Leap_Seconds_Count
) * Nano
;
184 -- Two constants used in the calculations of elapsed leap seconds.
185 -- End_Of_Time is later than Ada_High in time zone -28. Start_Of_Time
186 -- is earlier than Ada_Low in time zone +28.
188 End_Of_Time
: constant Time_Rep
:=
189 Ada_High
+ Time_Rep
(3) * Nanos_In_Day
;
190 Start_Of_Time
: constant Time_Rep
:=
191 Ada_Low
- Time_Rep
(3) * Nanos_In_Day
;
193 -- The Unix lower time bound expressed as nanoseconds since the start of
196 Unix_Min
: constant Time_Rep
:=
197 Ada_Low
+ Time_Rep
(17 * 366 + 52 * 365) * Nanos_In_Day
;
199 -- The Unix upper time bound expressed as nanoseconds since the start of
202 Unix_Max
: constant Time_Rep
:=
203 Ada_Low
+ Time_Rep
(34 * 366 + 102 * 365) * Nanos_In_Day
+
204 Time_Rep
(Leap_Seconds_Count
) * Nano
;
206 Epoch_Offset
: constant Time_Rep
:= (136 * 365 + 44 * 366) * Nanos_In_Day
;
207 -- The difference between 2150-1-1 UTC and 1970-1-1 UTC expressed in
208 -- nanoseconds. Note that year 2100 is non-leap.
210 Cumulative_Days_Before_Month
:
211 constant array (Month_Number
) of Natural :=
212 (0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334);
214 -- The following table contains the hard time values of all existing leap
215 -- seconds. The values are produced by the utility program xleaps.adb. This
216 -- must be updated when additional leap second times are defined.
218 Leap_Second_Times
: constant array (1 .. Leap_Seconds_Count
) of Time_Rep
:=
219 (-5601484800000000000,
220 -5585587199000000000,
221 -5554051198000000000,
222 -5522515197000000000,
223 -5490979196000000000,
224 -5459356795000000000,
225 -5427820794000000000,
226 -5396284793000000000,
227 -5364748792000000000,
228 -5317487991000000000,
229 -5285951990000000000,
230 -5254415989000000000,
231 -5191257588000000000,
232 -5112287987000000000,
233 -5049129586000000000,
234 -5017593585000000000,
235 -4970332784000000000,
236 -4938796783000000000,
237 -4907260782000000000,
238 -4859827181000000000,
239 -4812566380000000000,
240 -4765132779000000000,
241 -4544207978000000000,
242 -4449513577000000000,
243 -4339180776000000000);
249 function "+" (Left
: Time
; Right
: Duration) return Time
is
250 pragma Unsuppress
(Overflow_Check
);
251 Left_N
: constant Time_Rep
:= Time_Rep
(Left
);
253 return Time
(Left_N
+ Duration_To_Time_Rep
(Right
));
255 when Constraint_Error
=>
259 function "+" (Left
: Duration; Right
: Time
) return Time
is
268 function "-" (Left
: Time
; Right
: Duration) return Time
is
269 pragma Unsuppress
(Overflow_Check
);
270 Left_N
: constant Time_Rep
:= Time_Rep
(Left
);
272 return Time
(Left_N
- Duration_To_Time_Rep
(Right
));
274 when Constraint_Error
=>
278 function "-" (Left
: Time
; Right
: Time
) return Duration is
279 pragma Unsuppress
(Overflow_Check
);
281 Dur_Low
: constant Time_Rep
:= Duration_To_Time_Rep
(Duration'First);
282 Dur_High
: constant Time_Rep
:= Duration_To_Time_Rep
(Duration'Last);
283 -- The bounds of type Duration expressed as time representations
288 Res_N
:= Time_Rep
(Left
) - Time_Rep
(Right
);
290 -- Due to the extended range of Ada time, "-" is capable of producing
291 -- results which may exceed the range of Duration. In order to prevent
292 -- the generation of bogus values by the Unchecked_Conversion, we apply
293 -- the following check.
295 if Res_N
< Dur_Low
or else Res_N
> Dur_High
then
299 return Time_Rep_To_Duration
(Res_N
);
302 when Constraint_Error
=>
310 function "<" (Left
, Right
: Time
) return Boolean is
312 return Time_Rep
(Left
) < Time_Rep
(Right
);
319 function "<=" (Left
, Right
: Time
) return Boolean is
321 return Time_Rep
(Left
) <= Time_Rep
(Right
);
328 function ">" (Left
, Right
: Time
) return Boolean is
330 return Time_Rep
(Left
) > Time_Rep
(Right
);
337 function ">=" (Left
, Right
: Time
) return Boolean is
339 return Time_Rep
(Left
) >= Time_Rep
(Right
);
342 ------------------------------
343 -- Check_Within_Time_Bounds --
344 ------------------------------
346 procedure Check_Within_Time_Bounds
(T
: Time_Rep
) is
349 if T
< Ada_Low
or else T
> Ada_High_And_Leaps
then
353 if T
< Ada_Low
or else T
> Ada_High
then
357 end Check_Within_Time_Bounds
;
363 function Clock
return Time
is
364 Elapsed_Leaps
: Natural;
365 Next_Leap_N
: Time_Rep
;
367 -- The system clock returns the time in UTC since the Unix Epoch of
368 -- 1970-01-01 00:00:00.0. We perform an origin shift to the Ada Epoch
369 -- by adding the number of nanoseconds between the two origins.
372 Duration_To_Time_Rep
(System
.OS_Primitives
.Clock
) + Unix_Min
;
375 -- If the target supports leap seconds, determine the number of leap
376 -- seconds elapsed until this moment.
379 Cumulative_Leap_Seconds
380 (Start_Of_Time
, Res_N
, Elapsed_Leaps
, Next_Leap_N
);
382 -- The system clock may fall exactly on a leap second
384 if Res_N
>= Next_Leap_N
then
385 Elapsed_Leaps
:= Elapsed_Leaps
+ 1;
388 -- The target does not support leap seconds
394 Res_N
:= Res_N
+ Time_Rep
(Elapsed_Leaps
) * Nano
;
399 -----------------------------
400 -- Cumulative_Leap_Seconds --
401 -----------------------------
403 procedure Cumulative_Leap_Seconds
404 (Start_Date
: Time_Rep
;
406 Elapsed_Leaps
: out Natural;
407 Next_Leap
: out Time_Rep
)
409 End_Index
: Positive;
410 End_T
: Time_Rep
:= End_Date
;
411 Start_Index
: Positive;
412 Start_T
: Time_Rep
:= Start_Date
;
415 -- Both input dates must be normalized to UTC
417 pragma Assert
(Leap_Support
and then End_Date
>= Start_Date
);
419 Next_Leap
:= End_Of_Time
;
421 -- Make sure that the end date does not exceed the upper bound
424 if End_Date
> Ada_High
then
428 -- Remove the sub seconds from both dates
430 Start_T
:= Start_T
- (Start_T
mod Nano
);
431 End_T
:= End_T
- (End_T
mod Nano
);
433 -- Some trivial cases:
434 -- Leap 1 . . . Leap N
435 -- ---+========+------+############+-------+========+-----
436 -- Start_T End_T Start_T End_T
438 if End_T
< Leap_Second_Times
(1) then
440 Next_Leap
:= Leap_Second_Times
(1);
443 elsif Start_T
> Leap_Second_Times
(Leap_Seconds_Count
) then
445 Next_Leap
:= End_Of_Time
;
449 -- Perform the calculations only if the start date is within the leap
450 -- second occurrences table.
452 if Start_T
<= Leap_Second_Times
(Leap_Seconds_Count
) then
455 -- +----+----+-- . . . --+-------+---+
456 -- | T1 | T2 | | N - 1 | N |
457 -- +----+----+-- . . . --+-------+---+
459 -- | Start_Index | End_Index
460 -- +-------------------+
463 -- The idea behind the algorithm is to iterate and find two
464 -- closest dates which are after Start_T and End_T. Their
465 -- corresponding index difference denotes the number of leap
470 exit when Leap_Second_Times
(Start_Index
) >= Start_T
;
471 Start_Index
:= Start_Index
+ 1;
474 End_Index
:= Start_Index
;
476 exit when End_Index
> Leap_Seconds_Count
477 or else Leap_Second_Times
(End_Index
) >= End_T
;
478 End_Index
:= End_Index
+ 1;
481 if End_Index
<= Leap_Seconds_Count
then
482 Next_Leap
:= Leap_Second_Times
(End_Index
);
485 Elapsed_Leaps
:= End_Index
- Start_Index
;
490 end Cumulative_Leap_Seconds
;
496 function Day
(Date
: Time
) return Day_Number
is
501 pragma Unreferenced
(Y
, M
, S
);
503 Split
(Date
, Y
, M
, D
, S
);
511 function Is_Leap
(Year
: Year_Number
) return Boolean is
513 -- Leap centennial years
515 if Year
mod 400 = 0 then
518 -- Non-leap centennial years
520 elsif Year
mod 100 = 0 then
526 return Year
mod 4 = 0;
534 function Month
(Date
: Time
) return Month_Number
is
539 pragma Unreferenced
(Y
, D
, S
);
541 Split
(Date
, Y
, M
, D
, S
);
549 function Seconds
(Date
: Time
) return Day_Duration
is
554 pragma Unreferenced
(Y
, M
, D
);
556 Split
(Date
, Y
, M
, D
, S
);
566 Year
: out Year_Number
;
567 Month
: out Month_Number
;
568 Day
: out Day_Number
;
569 Seconds
: out Day_Duration
)
577 pragma Unreferenced
(H
, M
, Se
, Ss
, Le
);
580 -- Even though the input time zone is UTC (0), the flag Use_TZ will
581 -- ensure that Split picks up the local time zone.
583 Formatting_Operations
.Split
600 if not Year
'Valid or else
601 not Month
'Valid or else
602 not Day
'Valid or else
615 Month
: Month_Number
;
617 Seconds
: Day_Duration
:= 0.0) return Time
619 -- The values in the following constants are irrelevant, they are just
620 -- placeholders; the choice of constructing a Day_Duration value is
621 -- controlled by the Use_Day_Secs flag.
623 H
: constant Integer := 1;
624 M
: constant Integer := 1;
625 Se
: constant Integer := 1;
626 Ss
: constant Duration := 0.1;
631 if not Year
'Valid or else
632 not Month
'Valid or else
633 not Day
'Valid or else
639 -- Even though the input time zone is UTC (0), the flag Use_TZ will
640 -- ensure that Split picks up the local time zone.
643 Formatting_Operations
.Time_Of
653 Use_Day_Secs
=> True,
659 ---------------------
660 -- UTC_Time_Offset --
661 ---------------------
663 function UTC_Time_Offset
665 Is_Historic
: Boolean) return Long_Integer
667 -- The following constants denote February 28 during non-leap centennial
668 -- years, the units are nanoseconds.
670 T_2100_2_28
: constant Time_Rep
:= Ada_Low
+
671 (Time_Rep
(49 * 366 + 150 * 365 + 59) * Secs_In_Day
+
672 Time_Rep
(Leap_Seconds_Count
)) * Nano
;
674 T_2200_2_28
: constant Time_Rep
:= Ada_Low
+
675 (Time_Rep
(73 * 366 + 226 * 365 + 59) * Secs_In_Day
+
676 Time_Rep
(Leap_Seconds_Count
)) * Nano
;
678 T_2300_2_28
: constant Time_Rep
:= Ada_Low
+
679 (Time_Rep
(97 * 366 + 302 * 365 + 59) * Secs_In_Day
+
680 Time_Rep
(Leap_Seconds_Count
)) * Nano
;
682 -- 56 years (14 leap years + 42 non-leap years) in nanoseconds:
684 Nanos_In_56_Years
: constant := (14 * 366 + 42 * 365) * Nanos_In_Day
;
686 type int_Pointer
is access all Interfaces
.C
.int
;
687 type long_Pointer
is access all Interfaces
.C
.long
;
690 range -(2 ** (Standard
'Address_Size - Integer'(1))) ..
691 +(2 ** (Standard'Address_Size - Integer'(1)) - 1);
692 type time_t_Pointer
is access all time_t
;
694 procedure localtime_tzoff
695 (timer
: time_t_Pointer
;
696 is_historic
: int_Pointer
;
698 pragma Import
(C
, localtime_tzoff
, "__gnat_localtime_tzoff");
699 -- This routine is a interfacing wrapper around the library function
700 -- __gnat_localtime_tzoff. Parameter 'timer' represents a Unix-based
701 -- time equivalent of the input date. If flag 'is_historic' is set, this
702 -- routine would try to calculate to the best of the OS's abilities the
703 -- time zone offset that was or will be in effect on 'timer'. If the
704 -- flag is set to False, the routine returns the current time zone
705 -- regardless of what 'timer' designates. Parameter 'off' captures the
706 -- UTC offset of 'timer'.
710 Flag
: aliased Interfaces
.C
.int
;
711 Offset
: aliased Interfaces
.C
.long
;
712 Secs_T
: aliased time_t
;
714 -- Start of processing for UTC_Time_Offset
717 Date_N
:= Time_Rep
(Date
);
719 -- Dates which are 56 years apart fall on the same day, day light saving
720 -- and so on. Non-leap centennial years violate this rule by one day and
721 -- as a consequence, special adjustment is needed.
724 (if Date_N
<= T_2100_2_28
then 0
725 elsif Date_N
<= T_2200_2_28
then 1
726 elsif Date_N
<= T_2300_2_28
then 2
730 Date_N
:= Date_N
- Time_Rep
(Adj_Cent
) * Nanos_In_Day
;
733 -- Shift the date within bounds of Unix time
735 while Date_N
< Unix_Min
loop
736 Date_N
:= Date_N
+ Nanos_In_56_Years
;
739 while Date_N
>= Unix_Max
loop
740 Date_N
:= Date_N
- Nanos_In_56_Years
;
743 -- Perform a shift in origins from Ada to Unix
745 Date_N
:= Date_N
- Unix_Min
;
747 -- Convert the date into seconds
749 Secs_T
:= time_t
(Date_N
/ Nano
);
751 -- Determine whether to treat the input date as historical or not. A
752 -- value of "0" signifies that the date is NOT historic.
754 Flag
:= (if Is_Historic
then 1 else 0);
757 (Secs_T
'Unchecked_Access,
758 Flag
'Unchecked_Access,
759 Offset
'Unchecked_Access);
761 return Long_Integer (Offset
);
768 function Year
(Date
: Time
) return Year_Number
is
773 pragma Unreferenced
(M
, D
, S
);
775 Split
(Date
, Y
, M
, D
, S
);
779 -- The following packages assume that Time is a signed 64 bit integer
780 -- type, the units are nanoseconds and the origin is the start of Ada
781 -- time (1901-01-01 00:00:00.0 UTC).
783 ---------------------------
784 -- Arithmetic_Operations --
785 ---------------------------
787 package body Arithmetic_Operations
is
793 function Add
(Date
: Time
; Days
: Long_Integer) return Time
is
794 pragma Unsuppress
(Overflow_Check
);
795 Date_N
: constant Time_Rep
:= Time_Rep
(Date
);
797 return Time
(Date_N
+ Time_Rep
(Days
) * Nanos_In_Day
);
799 when Constraint_Error
=>
810 Days
: out Long_Integer;
811 Seconds
: out Duration;
812 Leap_Seconds
: out Integer)
816 Elapsed_Leaps
: Natural;
818 Negate
: Boolean := False;
819 Next_Leap_N
: Time_Rep
;
821 Sub_Secs_Diff
: Time_Rep
;
824 -- Both input time values are assumed to be in UTC
826 if Left
>= Right
then
827 Later
:= Time_Rep
(Left
);
828 Earlier
:= Time_Rep
(Right
);
830 Later
:= Time_Rep
(Right
);
831 Earlier
:= Time_Rep
(Left
);
835 -- If the target supports leap seconds, process them
838 Cumulative_Leap_Seconds
839 (Earlier
, Later
, Elapsed_Leaps
, Next_Leap_N
);
841 if Later
>= Next_Leap_N
then
842 Elapsed_Leaps
:= Elapsed_Leaps
+ 1;
845 -- The target does not support leap seconds
851 -- Sub seconds processing. We add the resulting difference to one
852 -- of the input dates in order to account for any potential rounding
853 -- of the difference in the next step.
855 Sub_Secs_Diff
:= Later
mod Nano
- Earlier
mod Nano
;
856 Earlier
:= Earlier
+ Sub_Secs_Diff
;
857 Sub_Secs
:= Duration (Sub_Secs_Diff
) / Nano_F
;
859 -- Difference processing. This operation should be able to calculate
860 -- the difference between opposite values which are close to the end
861 -- and start of Ada time. To accommodate the large range, we convert
862 -- to seconds. This action may potentially round the two values and
863 -- either add or drop a second. We compensate for this issue in the
867 Time_Dur
(Later
/ Nano
- Earlier
/ Nano
) - Time_Dur
(Elapsed_Leaps
);
869 Days
:= Long_Integer (Res_Dur
/ Secs_In_Day
);
870 Seconds
:= Duration (Res_Dur
mod Secs_In_Day
) + Sub_Secs
;
871 Leap_Seconds
:= Integer (Elapsed_Leaps
);
877 if Leap_Seconds
/= 0 then
878 Leap_Seconds
:= -Leap_Seconds
;
887 function Subtract
(Date
: Time
; Days
: Long_Integer) return Time
is
888 pragma Unsuppress
(Overflow_Check
);
889 Date_N
: constant Time_Rep
:= Time_Rep
(Date
);
891 return Time
(Date_N
- Time_Rep
(Days
) * Nanos_In_Day
);
893 when Constraint_Error
=>
897 end Arithmetic_Operations
;
899 ---------------------------
900 -- Conversion_Operations --
901 ---------------------------
903 package body Conversion_Operations
is
909 function To_Ada_Time
(Unix_Time
: Long_Integer) return Time
is
910 pragma Unsuppress
(Overflow_Check
);
911 Unix_Rep
: constant Time_Rep
:= Time_Rep
(Unix_Time
) * Nano
;
913 return Time
(Unix_Rep
- Epoch_Offset
);
915 when Constraint_Error
=>
930 tm_isdst
: Integer) return Time
932 pragma Unsuppress
(Overflow_Check
);
934 Month
: Month_Number
;
943 Year
:= Year_Number
(1900 + tm_year
);
944 Month
:= Month_Number
(1 + tm_mon
);
945 Day
:= Day_Number
(tm_day
);
947 -- Step 1: Validity checks of input values
949 if not Year
'Valid or else not Month
'Valid or else not Day
'Valid
950 or else tm_hour
not in 0 .. 24
951 or else tm_min
not in 0 .. 59
952 or else tm_sec
not in 0 .. 60
953 or else tm_isdst
not in -1 .. 1
958 -- Step 2: Potential leap second
968 -- Step 3: Calculate the time value
972 (Formatting_Operations
.Time_Of
976 Day_Secs
=> 0.0, -- Time is given in h:m:s
980 Sub_Sec
=> 0.0, -- No precise sub second given
982 Use_Day_Secs
=> False, -- Time is given in h:m:s
983 Use_TZ
=> True, -- Force usage of explicit time zone
985 Time_Zone
=> 0)); -- Place the value in UTC
987 -- Step 4: Daylight Savings Time
990 Result
:= Result
+ Time_Rep
(3_600
) * Nano
;
993 return Time
(Result
);
996 when Constraint_Error
=>
1004 function To_Duration
1005 (tv_sec
: Long_Integer;
1006 tv_nsec
: Long_Integer) return Duration
1008 pragma Unsuppress
(Overflow_Check
);
1010 return Duration (tv_sec
) + Duration (tv_nsec
) / Nano_F
;
1013 ------------------------
1014 -- To_Struct_Timespec --
1015 ------------------------
1017 procedure To_Struct_Timespec
1019 tv_sec
: out Long_Integer;
1020 tv_nsec
: out Long_Integer)
1022 pragma Unsuppress
(Overflow_Check
);
1024 Nano_Secs
: Duration;
1027 -- Seconds extraction, avoid potential rounding errors
1030 tv_sec
:= Long_Integer (Secs
);
1032 -- Nanoseconds extraction
1034 Nano_Secs
:= D
- Duration (tv_sec
);
1035 tv_nsec
:= Long_Integer (Nano_Secs
* Nano
);
1036 end To_Struct_Timespec
;
1042 procedure To_Struct_Tm
1044 tm_year
: out Integer;
1045 tm_mon
: out Integer;
1046 tm_day
: out Integer;
1047 tm_hour
: out Integer;
1048 tm_min
: out Integer;
1049 tm_sec
: out Integer)
1051 pragma Unsuppress
(Overflow_Check
);
1053 Month
: Month_Number
;
1055 Day_Secs
: Day_Duration
;
1060 -- Step 1: Split the input time
1062 Formatting_Operations
.Split
1067 Day_Secs
=> Day_Secs
,
1072 Leap_Sec
=> Leap_Sec
,
1074 Is_Historic
=> False,
1077 -- Step 2: Correct the year and month
1079 tm_year
:= Year
- 1900;
1080 tm_mon
:= Month
- 1;
1082 -- Step 3: Handle leap second occurrences
1084 tm_sec
:= (if Leap_Sec
then 60 else Second
);
1091 function To_Unix_Time
(Ada_Time
: Time
) return Long_Integer is
1092 pragma Unsuppress
(Overflow_Check
);
1093 Ada_Rep
: constant Time_Rep
:= Time_Rep
(Ada_Time
);
1095 return Long_Integer ((Ada_Rep
+ Epoch_Offset
) / Nano
);
1097 when Constraint_Error
=>
1100 end Conversion_Operations
;
1102 ----------------------
1103 -- Delay_Operations --
1104 ----------------------
1106 package body Delay_Operations
is
1112 function To_Duration
(Date
: Time
) return Duration is
1113 pragma Unsuppress
(Overflow_Check
);
1115 Safe_Ada_High
: constant Time_Rep
:= Ada_High
- Epoch_Offset
;
1116 -- This value represents a "safe" end of time. In order to perform a
1117 -- proper conversion to Unix duration, we will have to shift origins
1118 -- at one point. For very distant dates, this means an overflow check
1119 -- failure. To prevent this, the function returns the "safe" end of
1120 -- time (roughly 2219) which is still distant enough.
1122 Elapsed_Leaps
: Natural;
1123 Next_Leap_N
: Time_Rep
;
1127 Res_N
:= Time_Rep
(Date
);
1129 -- Step 1: If the target supports leap seconds, remove any leap
1130 -- seconds elapsed up to the input date.
1132 if Leap_Support
then
1133 Cumulative_Leap_Seconds
1134 (Start_Of_Time
, Res_N
, Elapsed_Leaps
, Next_Leap_N
);
1136 -- The input time value may fall on a leap second occurrence
1138 if Res_N
>= Next_Leap_N
then
1139 Elapsed_Leaps
:= Elapsed_Leaps
+ 1;
1142 -- The target does not support leap seconds
1148 Res_N
:= Res_N
- Time_Rep
(Elapsed_Leaps
) * Nano
;
1150 -- Step 2: Perform a shift in origins to obtain a Unix equivalent of
1151 -- the input. Guard against very large delay values such as the end
1152 -- of time since the computation will overflow.
1154 Res_N
:= (if Res_N
> Safe_Ada_High
then Safe_Ada_High
1155 else Res_N
+ Epoch_Offset
);
1157 return Time_Rep_To_Duration
(Res_N
);
1160 end Delay_Operations
;
1162 ---------------------------
1163 -- Formatting_Operations --
1164 ---------------------------
1166 package body Formatting_Operations
is
1172 function Day_Of_Week
(Date
: Time
) return Integer is
1173 Date_N
: constant Time_Rep
:= Time_Rep
(Date
);
1174 Time_Zone
: constant Long_Integer := UTC_Time_Offset
(Date
, True);
1175 Ada_Low_N
: Time_Rep
;
1176 Day_Count
: Long_Integer;
1182 -- As declared, the Ada Epoch is set in UTC. For this calculation to
1183 -- work properly, both the Epoch and the input date must be in the
1184 -- same time zone. The following places the Epoch in the input date's
1187 Ada_Low_N
:= Ada_Low
- Time_Rep
(Time_Zone
) * Nano
;
1189 if Date_N
> Ada_Low_N
then
1193 High_N
:= Ada_Low_N
;
1197 -- Determine the elapsed seconds since the start of Ada time
1199 Day_Dur
:= Time_Dur
(High_N
/ Nano
- Low_N
/ Nano
);
1201 -- Count the number of days since the start of Ada time. 1901-01-01
1202 -- GMT was a Tuesday.
1204 Day_Count
:= Long_Integer (Day_Dur
/ Secs_In_Day
) + 1;
1206 return Integer (Day_Count
mod 7);
1215 Year
: out Year_Number
;
1216 Month
: out Month_Number
;
1217 Day
: out Day_Number
;
1218 Day_Secs
: out Day_Duration
;
1220 Minute
: out Integer;
1221 Second
: out Integer;
1222 Sub_Sec
: out Duration;
1223 Leap_Sec
: out Boolean;
1225 Is_Historic
: Boolean;
1226 Time_Zone
: Long_Integer)
1228 -- The following constants represent the number of nanoseconds
1229 -- elapsed since the start of Ada time to and including the non
1230 -- leap centennial years.
1232 Year_2101
: constant Time_Rep
:= Ada_Low
+
1233 Time_Rep
(49 * 366 + 151 * 365) * Nanos_In_Day
;
1234 Year_2201
: constant Time_Rep
:= Ada_Low
+
1235 Time_Rep
(73 * 366 + 227 * 365) * Nanos_In_Day
;
1236 Year_2301
: constant Time_Rep
:= Ada_Low
+
1237 Time_Rep
(97 * 366 + 303 * 365) * Nanos_In_Day
;
1239 Date_Dur
: Time_Dur
;
1241 Day_Seconds
: Natural;
1242 Elapsed_Leaps
: Natural;
1243 Four_Year_Segs
: Natural;
1244 Hour_Seconds
: Natural;
1245 Is_Leap_Year
: Boolean;
1246 Next_Leap_N
: Time_Rep
;
1247 Rem_Years
: Natural;
1248 Sub_Sec_N
: Time_Rep
;
1252 Date_N
:= Time_Rep
(Date
);
1254 -- Step 1: Leap seconds processing in UTC
1256 if Leap_Support
then
1257 Cumulative_Leap_Seconds
1258 (Start_Of_Time
, Date_N
, Elapsed_Leaps
, Next_Leap_N
);
1260 Leap_Sec
:= Date_N
>= Next_Leap_N
;
1263 Elapsed_Leaps
:= Elapsed_Leaps
+ 1;
1266 -- The target does not support leap seconds
1273 Date_N
:= Date_N
- Time_Rep
(Elapsed_Leaps
) * Nano
;
1275 -- Step 2: Time zone processing. This action converts the input date
1276 -- from GMT to the requested time zone. Applies from Ada 2005 on.
1279 if Time_Zone
/= 0 then
1280 Date_N
:= Date_N
+ Time_Rep
(Time_Zone
) * 60 * Nano
;
1287 Off
: constant Long_Integer :=
1288 UTC_Time_Offset
(Time
(Date_N
), Is_Historic
);
1291 Date_N
:= Date_N
+ Time_Rep
(Off
) * Nano
;
1295 -- Step 3: Non-leap centennial year adjustment in local time zone
1297 -- In order for all divisions to work properly and to avoid more
1298 -- complicated arithmetic, we add fake February 29s to dates which
1299 -- occur after a non-leap centennial year.
1301 if Date_N
>= Year_2301
then
1302 Date_N
:= Date_N
+ Time_Rep
(3) * Nanos_In_Day
;
1304 elsif Date_N
>= Year_2201
then
1305 Date_N
:= Date_N
+ Time_Rep
(2) * Nanos_In_Day
;
1307 elsif Date_N
>= Year_2101
then
1308 Date_N
:= Date_N
+ Time_Rep
(1) * Nanos_In_Day
;
1311 -- Step 4: Sub second processing in local time zone
1313 Sub_Sec_N
:= Date_N
mod Nano
;
1314 Sub_Sec
:= Duration (Sub_Sec_N
) / Nano_F
;
1315 Date_N
:= Date_N
- Sub_Sec_N
;
1317 -- Convert Date_N into a time duration value, changing the units
1320 Date_Dur
:= Time_Dur
(Date_N
/ Nano
- Ada_Low
/ Nano
);
1322 -- Step 5: Year processing in local time zone. Determine the number
1323 -- of four year segments since the start of Ada time and the input
1326 Four_Year_Segs
:= Natural (Date_Dur
/ Secs_In_Four_Years
);
1328 if Four_Year_Segs
> 0 then
1329 Date_Dur
:= Date_Dur
- Time_Dur
(Four_Year_Segs
) *
1333 -- Calculate the remaining non-leap years
1335 Rem_Years
:= Natural (Date_Dur
/ Secs_In_Non_Leap_Year
);
1337 if Rem_Years
> 3 then
1341 Date_Dur
:= Date_Dur
- Time_Dur
(Rem_Years
) * Secs_In_Non_Leap_Year
;
1343 Year
:= Ada_Min_Year
+ Natural (4 * Four_Year_Segs
+ Rem_Years
);
1344 Is_Leap_Year
:= Is_Leap
(Year
);
1346 -- Step 6: Month and day processing in local time zone
1348 Year_Day
:= Natural (Date_Dur
/ Secs_In_Day
) + 1;
1352 -- Processing for months after January
1354 if Year_Day
> 31 then
1356 Year_Day
:= Year_Day
- 31;
1358 -- Processing for a new month or a leap February
1361 and then (not Is_Leap_Year
or else Year_Day
> 29)
1364 Year_Day
:= Year_Day
- 28;
1366 if Is_Leap_Year
then
1367 Year_Day
:= Year_Day
- 1;
1372 while Year_Day
> Days_In_Month
(Month
) loop
1373 Year_Day
:= Year_Day
- Days_In_Month
(Month
);
1379 -- Step 7: Hour, minute, second and sub second processing in local
1382 Day
:= Day_Number
(Year_Day
);
1383 Day_Seconds
:= Integer (Date_Dur
mod Secs_In_Day
);
1384 Day_Secs
:= Duration (Day_Seconds
) + Sub_Sec
;
1385 Hour
:= Day_Seconds
/ 3_600
;
1386 Hour_Seconds
:= Day_Seconds
mod 3_600
;
1387 Minute
:= Hour_Seconds
/ 60;
1388 Second
:= Hour_Seconds
mod 60;
1391 when Constraint_Error
=>
1400 (Year
: Year_Number
;
1401 Month
: Month_Number
;
1403 Day_Secs
: Day_Duration
;
1409 Use_Day_Secs
: Boolean;
1411 Is_Historic
: Boolean;
1412 Time_Zone
: Long_Integer) return Time
1415 Elapsed_Leaps
: Natural;
1416 Next_Leap_N
: Time_Rep
;
1418 Rounded_Res_N
: Time_Rep
;
1421 -- Step 1: Check whether the day, month and year form a valid date
1423 if Day
> Days_In_Month
(Month
)
1424 and then (Day
/= 29 or else Month
/= 2 or else not Is_Leap
(Year
))
1429 -- Start accumulating nanoseconds from the low bound of Ada time
1433 -- Step 2: Year processing and centennial year adjustment. Determine
1434 -- the number of four year segments since the start of Ada time and
1437 Count
:= (Year
- Year_Number
'First) / 4;
1439 for Four_Year_Segments
in 1 .. Count
loop
1440 Res_N
:= Res_N
+ Nanos_In_Four_Years
;
1443 -- Note that non-leap centennial years are automatically considered
1444 -- leap in the operation above. An adjustment of several days is
1445 -- required to compensate for this.
1448 Res_N
:= Res_N
- Time_Rep
(3) * Nanos_In_Day
;
1450 elsif Year
> 2200 then
1451 Res_N
:= Res_N
- Time_Rep
(2) * Nanos_In_Day
;
1453 elsif Year
> 2100 then
1454 Res_N
:= Res_N
- Time_Rep
(1) * Nanos_In_Day
;
1457 -- Add the remaining non-leap years
1459 Count
:= (Year
- Year_Number
'First) mod 4;
1460 Res_N
:= Res_N
+ Time_Rep
(Count
) * Secs_In_Non_Leap_Year
* Nano
;
1462 -- Step 3: Day of month processing. Determine the number of days
1463 -- since the start of the current year. Do not add the current
1464 -- day since it has not elapsed yet.
1466 Count
:= Cumulative_Days_Before_Month
(Month
) + Day
- 1;
1468 -- The input year is leap and we have passed February
1476 Res_N
:= Res_N
+ Time_Rep
(Count
) * Nanos_In_Day
;
1478 -- Step 4: Hour, minute, second and sub second processing
1480 if Use_Day_Secs
then
1481 Res_N
:= Res_N
+ Duration_To_Time_Rep
(Day_Secs
);
1485 Res_N
+ Time_Rep
(Hour
* 3_600
+ Minute
* 60 + Second
) * Nano
;
1487 if Sub_Sec
= 1.0 then
1488 Res_N
:= Res_N
+ Time_Rep
(1) * Nano
;
1490 Res_N
:= Res_N
+ Duration_To_Time_Rep
(Sub_Sec
);
1494 -- At this point, the generated time value should be withing the
1495 -- bounds of Ada time.
1497 Check_Within_Time_Bounds
(Res_N
);
1499 -- Step 4: Time zone processing. At this point we have built an
1500 -- arbitrary time value which is not related to any time zone.
1501 -- For simplicity, the time value is normalized to GMT, producing
1502 -- a uniform representation which can be treated by arithmetic
1503 -- operations for instance without any additional corrections.
1506 if Time_Zone
/= 0 then
1507 Res_N
:= Res_N
- Time_Rep
(Time_Zone
) * 60 * Nano
;
1514 Cur_Off
: constant Long_Integer :=
1515 UTC_Time_Offset
(Time
(Res_N
), Is_Historic
);
1516 Cur_Res_N
: constant Time_Rep
:=
1517 Res_N
- Time_Rep
(Cur_Off
) * Nano
;
1518 Off
: constant Long_Integer :=
1519 UTC_Time_Offset
(Time
(Cur_Res_N
), Is_Historic
);
1522 Res_N
:= Res_N
- Time_Rep
(Off
) * Nano
;
1526 -- Step 5: Leap seconds processing in GMT
1528 if Leap_Support
then
1529 Cumulative_Leap_Seconds
1530 (Start_Of_Time
, Res_N
, Elapsed_Leaps
, Next_Leap_N
);
1532 Res_N
:= Res_N
+ Time_Rep
(Elapsed_Leaps
) * Nano
;
1534 -- An Ada 2005 caller requesting an explicit leap second or an
1535 -- Ada 95 caller accounting for an invisible leap second.
1537 if Leap_Sec
or else Res_N
>= Next_Leap_N
then
1538 Res_N
:= Res_N
+ Time_Rep
(1) * Nano
;
1541 -- Leap second validity check
1543 Rounded_Res_N
:= Res_N
- (Res_N
mod Nano
);
1547 and then Rounded_Res_N
/= Next_Leap_N
1553 return Time
(Res_N
);
1556 end Formatting_Operations
;
1558 ---------------------------
1559 -- Time_Zones_Operations --
1560 ---------------------------
1562 package body Time_Zones_Operations
is
1564 ---------------------
1565 -- UTC_Time_Offset --
1566 ---------------------
1568 function UTC_Time_Offset
(Date
: Time
) return Long_Integer is
1570 return UTC_Time_Offset
(Date
, True);
1571 end UTC_Time_Offset
;
1573 end Time_Zones_Operations
;
1575 -- Start of elaboration code for Ada.Calendar
1578 System
.OS_Primitives
.Initialize
;