cal_remove_local_offset(A)

CAL_$REMOVE_LOCAL_OFFSET          Domain/OS           CAL_$REMOVE_LOCAL_OFFSET


NAME
     cal_$remove_local_offset - convert local time to UTC

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/cal.h>

     void cal_$remove_local_offset(
          time_$clock_t *clock_value)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/cal.ins.pas';

     procedure cal_$remove_local_offset(
          var clock_value: time_$clock_t);

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/cal.ins.ftn'

           integer*2 clock_value(3), clockh
           integer*4 clockl

           equivalence (clockl, clock_value(2)), (clockh, clock_value(1))

           call cal_$remove_local_offset(clock_value)

DESCRIPTION
     Cal_$remove_local_offset subtracts the local time zone offset from the
     clock value in clock_value.  If clock_value is a local time when
     cal_$remove_local_offset is called, it will be the equivalent UTC time
     when cal_$remove_local_offset returns.

     clock_value
          A clock value.

NOTES
     Cal_$write_timezone sets the local time zone offset.
Museum
