swirl
Guide to OmniMark 8   OmniMark home
docs home 
IndexConceptsTasksSyntaxLibrariesLegacy LibrariesErrors
 
      Other Library Functions  
function  

ymdhms-adjust-time-zone

 
 

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


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

        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
 
 

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

OmniMark 8.2.0 Documentation Generated: March 13, 2008 at 3:27:39 pm
If you have any comments about this section of the documentation, please use this form.

Copyright © Stilo International plc, 1988-2008.