cal — Apollo


SYSCALLS/CAL - calendar routines     83/12/06


Include files:

    Fortran:    /sys/ins/cal.ins.ftn
    Pascal:     /sys/ins/cal.ins.pas


Procedures and Functions:
    cal_$add_clock(clock1, clock2)
        Adds clock2 to clock1.

    cal_$apply_local_offset (clock)
        Adds the local offset (from UTC) to clock.  Used to compute local time
        from a UTC time.

    cal_$clock_to_sec (clock), sec = ...
        Converts system clock units to seconds.

    integer_value := cal_$cmp_clock(clock1, clock2)
        Compares two UTC time values. Result is +1 if clock1 > clock2,
        0 if clock1 = clock2, -1 if clock1 < clock2.

    cal_$decode_ascii_date (string, stringlength, year, month, day, status)
        Decodes an ascii string containing a date specification.

    cal_$decode_ascii_time (string, stringlength, hour, minute, second, status)
        Decodes an ascii string containing a time specification.

    cal_$decode_ascii_tzdif (string, stringlength, tz_dif, tz_name, status)
        Decodes an ascii string containing a time zone difference specification.

    cal_$decode_local_time (decoded_clock)
        Decodes local time into year, month, day, hour, minute, second.

    cal_$decode_time (clock, decoded_clock)
        Decodes given clock into year, month, day, hour, minute, second.

    cal_$encode_time (decoded_clock, clock)
        Encoded year, month, day, hour, minute, second into system clock units.

    cal_$float_clock (clock, float_seconds)
        Converts a system clock representation to a double precision floating
        point value, expressed in seconds.

    cal_$get_info (timezone_info)
        Returns system time zone info (name and offset from UTC.)

    cal_$get_local_time (clock)
        Returns local time, in system clock representation.

    cal_$sec_to_clock (seconds, clock)
        Converts seconds to system clock units.

    boolean_value := cal_$sub_clock(clock1, clock2)
        Subtracts clock2 from clock1. Return value is TRUE if the result
        is >= 0.

    cal_$weekday (year, month, day), weekday = ...
        Computes day of week.

    cal_$write_timezone (timezone_info, status)
        Writes time zone info onto the boot volume.
Museum
