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

Return type: String 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

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

Other Library Functions    add-to-ymdhms    arpadate-to-ymdhms    format-ymdhms    now-as-ymdhms    round-down-ymdhms    round-up-ymdhms    ymdhms-adjust-time-zone    ymdhms-day-difference    ymdhms-julian-day-count    ymdhms-month-difference    ymdhms-second-difference    ymdhms-to-arpadate    ymd-weekday

[ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACY LIBRARIES ] [ ERRORS ]