ymdhms-adjust-time-zone

function

Library: Date and time functions (OMDATE)
Include: omdate.xin

Returns: Returns the adjusted date/time in "YYYYMMDDhhmmss+ZHZM" format.


Declaration
define string function ymdhms-adjust-time-zone value string ymdhms
                                         to-be value string new-zone

Argument definitions

ymdhms
a date/time in the normalized 19-character "YYYYMMDDhhmmss+ZHZM" format.
new-zone
the time zone to which you want the date/time adjusted in "+hhmm" format


Purpose

This function takes a date/time and a time zone, returning the date/time adjusted to the given time zone. The returned date/time is also in the "YYYYMMDDhhmmss+ZHZM" format.

Example:


  include "omdate.xin"
  process
    local stream new-time
    set new-time to ymdhms-adjust-time-zone "19980416154929+0500" to-be "+0600"
    output "Adjusted time with new time zone offset = " || new-time || "%n"
  ; Result of this program:
  ;   Adjusted time with new time zone offset = 19980416164929+0600