Obtains a time that occurs a specified number of seconds after or before another time within a 24-hour period.
RelativeTime ( time, n )
Argument |
Description |
---|---|
time |
A value of type time |
n |
A long number of seconds |
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.
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.
This statement returns 19:01:41:
RelativeTime(19:01:31, 10)
This statement returns 19:01:21:
RelativeTime(19:01:31, - 10)
RelativeTime method for DataWindows in the DataWindow Reference or the online Help