clinks_to_special_time_c

	status.i4.v = clinks_to_special_time_c(clinks.u4.v, type.i4.v,
					       options.u4.v, special_time.u4.r)

	This routine converts clinks to a special time breakpoint.  Please see
	clinks_now for the definition of clinks.
	
	clinks		time in clinks
	type		type of time breakpoint desired
			(DATE_START_OF_MINUTE -> time of the start of the minute
						 for the requested clinks,
			 DATE_START_OF_HOUR -> time of the start of the hour
					       for the requested clinks,
			 DATE_START_OF_SHIFT -> time of the start of shift
						for the requested clinks,
			 DATE_START_OF_DAY -> time of midnight for the
					      requested clinks,
			 DATE_START_OF_WEEK -> time of the start of week
					       for the requested clinks,
			 DATE_START_OF_MONTH -> time of the start of month
						for the requested clinks,
			 DATE_START_OF_YEAR -> time of the start of year
					       for the requested clinks)
	options		date conversion options
			(DATE_OPT_NONE -> no options selected,
			 DATE_OPT_PREVIOUS_TIME -> return the previous
						   time interval value,
			 DATE_OPT_NEXT_TIME -> return the next
					       time interval value)
	special_time	returned special time in clinks

	This function returns ACNET status values as follows:

	OK			success
	CBS_INVARG		invalid clink value or type value supplied

	This function requires the following include files:

	clib_h

	Related functions:

	clinks_to_day_of_week_c, clinks_now, clinks_to_date, date_to_clinks,
	clinks_is_dst_c, get_date_clinks, convert_compare_date_to_clinks,
	db_date_to_clinks, db_date_to_date_c, convert_seconds_c,
	clinks_to_seconds_into_day_c, timezone_info

	C/C++ usage:

	int	status;
	int	type = DATE_START_OF_DAY;
	unsigned int	clinks = 937526400;
	unsigned int	options = DATE_OPT_NONE;
	unsigned int	special_time;

	status = clinks_to_special_time_c(clinks,type,options,&special_time);