RelativeTime PowerScript function
Description
Obtains a time that occurs a specified number of seconds after
or before another time within a 24-hour period.
Syntax
1 |
<span>RelativeTime</span> ( <span>time</span>, <span>n</span> ) |
Argument |
Description |
---|---|
time |
A value of type time |
n |
A long number of seconds |
Return Values
Time. Returns the time that occurs n seconds
after time if n is greater
than 0. Returns the time that occurs n seconds
before time if n is less
than 0. The maximum return value is 23:59:59. If any argument’s
value is null, RelativeTime returns null.
Usage
All PowerBuilder functions except RelativeTime use
the Windows API to process dates and times, so in most instances
processing of Daylight Savings Time (DST) is dependent on the operating
system. However, the RelativeTime function is
not DST–aware and therefore may return an incorrect time
in a region that is using DST.
Examples
This statement returns 19:01:41:
1 |
<span>RelativeTime</span>(19:01:31, 10) |
This statement returns 19:01:21:
1 |
<span>RelativeTime</span>(19:01:31, <span>-</span> 10) |
See Also
-
SecondsAfter, RelativeTime method
for DataWindows in the DataWindow Reference or the online Help