%AddIntervalLocal function

Function
The function adds relative time TimeR to absolute time TimeA. A result is value of Absolute time type.
Declaration
TIME %AddIntervalLocal(
   TIME in TimeA,
   REAL in TimeR,
   INT  in timeZone :=  %GetTimeZone()
 )

Parameters
TimeA Absolute time.
TimeR Relative time.
timeZone Forced time zone to convert to a local time. It is set as a time zone offset from UTC during winter in seconds.

Description
The function %AddIntervalLocal adds relative time to absolute one. The result will not be influenced by the fact if the time offset was or was not in this interval. E.g., if 3 hours are added to 1:00 a.m., the result is always 4:00 a.m.
Example
 ; =================================================================
 ;  Slovakia (country for this example)
 ;  Time zone is UTC+1.
 ;  There are summer [A] and winter [B] time (with time shifts).
 ;  Summer time is from 29th March 2009 to 24th October 2009.
 ;  A3:00:00 is changed to B2:00:00 on Sunday (25th October 2009).
 ; =================================================================
 
 
 BEGIN
 
  TIME _baseTime
 
  TIME _addLocal1
  TIME _addLocal2
 
   ; UTC 23:30:00 24.10.2009
  _baseTime := %StrToTimeEx("01:30:00 25.10.2009", "hh:mi:ss dd-mm-rrrr")
 
  ; add 1 hour - result time 25-10-2009 A2:30:00.000
  _addLocal1 := %AddIntervalLocal(_baseTime, 3600)
  ; add 2 hour - result time 25-10-2009 03:30:00.000
  _addLocal2 := %AddIntervalLocal(_baseTime, 7200)
 
 END

Related pages:

Implemented functions
Function arguments - types
%AddIntervalMono

Napíšte komentár