TIME - extended date/time functions.

The SS and NS mode C libraries support various date/time functions that originated with the UW Tools package. In the UW Tools package, these functions have names that begin with a dot "." to indicate that they are unique to GCOS8; however, alternate names with an underscore instead of a dot have been defined to make the functions directly available to C code.

The list below shows the C name of the function, followed by the UW Tools name in parentheses. In these descriptions a "day number" is the number of days since January 1, 1970 and a "time number" the number of seconds since 0:00 a.m. GMT on January 1, 1970.

_bdtim (_bdtim)
converts a BCD time value to a time number.
_ctime (.ctime)
returns the current time as a time number.
_indays (.indays)
converts any date into a day number.
_tlang (.tlang)
changes the current date/time parsing tables.
_tfmt (.tfmt)
formats a time number into a date/time string.
_tinit (.tinit)
initializes a set of time zone definitions.
_tlocale (.tlocale)
converts a time zone locale name to a time zone reference value.
_tm (.tm)
converts a time number to a "tm" time structure.
_tmfmt (.tmfmt)
formats a "tm" time structure into a date/time string.
_tosec (.tosec)
converts a date/time string in almost any format into a time number.
_tzdoff (.tzdoff)
determines the offset between standard and daylight time.
_tzisdst (.tzisdst)
determines if a particular time zone is a daylight savings time zone.
_tzname (.tzname)
determines the name of a time zone.
_tzoff (.tzoff)
returns the offset of a particular time zone from GMT.
_tzqry (.tzqry)
converts a time zone name to a time zone reference value.
_tzstd (.tzstd)
obtains the standard time zone reference value for a particular locale.
_tzuse (.tzuse)
determines the time zone to be used for a locale.

For information on any of these, look for the corresponding UW Tools function under "expl b lib". For example, if you want information on "_tosec", use "expl b lib .tosec".

You should also look at "expl b tz" and "expl b time" for information on time zones and date/time parsing.

Copyright © 1996, Thinkage Ltd.