Other Library Functions

Library: omdate - date and time functions Include: omdate.xin

Return type: String Returns:        Returns a specified date/time rounded up to the nearest indicated interval.

Declaration

  define stream function round-up-ymdhms value stream ymdhms
                                      to value stream interval

This function takes a date/time in "YYYYMMDDhhmmss+ZHZM" format and returns the same value, but rounded up to the end of an interval as indicated by the second argument.

Arguments:

• "ymdhms" -- a date/time in "YYYYMMDDhhmmss+ZHZM" format.
• "interval" -- the name of the interval which you want the indicated date rounded to. For example, "year", "month", "day", "hour", or "minute". Only the shortest distinguishing prefix of the interval name is needed, so "y" can be used in place of "year", but "mo" and "mi" are needed to distinguish between "month" and "minute". This argument can be in either uppercase or lowercase. If this argument is unrecognized, the date/time will be returned unchanged.

Example: