aboutsummaryrefslogtreecommitdiff
path: root/src/slalib/sun67.htx/node32.html
blob: 9d7f8ab4e6b3f481e7d221b3a9b9a8f0bf6612d5 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<!--Converted with LaTeX2HTML 97.1 (release) (July 13th, 1997)
 by Nikos Drakos (nikos@cbl.leeds.ac.uk), CBLU, University of Leeds
* revised and updated by:  Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
  Jens Lippman, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>SLA_CD2TF - Days to Hour,Min,Sec</TITLE>
<META NAME="description" CONTENT="SLA_CD2TF - Days to Hour,Min,Sec">
<META NAME="keywords" CONTENT="sun67">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso_8859_1">
<LINK REL="STYLESHEET" HREF="sun67.css">
<LINK REL="next" HREF="node33.html">
<LINK REL="previous" HREF="node31.html">
<LINK REL="up" HREF="node13.html">
<LINK REL="next" HREF="node33.html">
</HEAD>
<BODY >
<BR> <HR>
<A NAME="tex2html746" HREF="node33.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next_motif.gif"></A> 
<A NAME="tex2html744" HREF="node13.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up_motif.gif"></A> 
<A NAME="tex2html738" HREF="node31.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="previous_motif.gif"></A>   <A HREF="sun67.html#stardoccontents"><IMG  ALIGN="BOTTOM" BORDER="0"
 SRC="contents_motif.gif"></A>
<BR>
<B> Next:</B> <A NAME="tex2html747" HREF="node33.html">SLA_CLDJ - Calendar to MJD</A>
<BR>
<B>Up:</B> <A NAME="tex2html745" HREF="node13.html">SUBPROGRAM SPECIFICATIONS</A>
<BR>
<B> Previous:</B> <A NAME="tex2html739" HREF="node31.html">SLA_CC62S - Cartesian 6-Vector to Spherical</A>
<BR> <HR> <P>
<P><!--End of Navigation Panel-->
<H2><A NAME="SECTION000419000000000000000">SLA_CD2TF - Days to Hour,Min,Sec</A>
<A NAME="xref_SLA_CD2TF">&#160;</A><A NAME="SLA_CD2TF">&#160;</A>
</H2>
       <DL>
<DT><STRONG>ACTION:</STRONG>
<DD>Convert an interval in days to hours, minutes, seconds
(single precision).
<P>    <DT><STRONG>CALL:</STRONG>
<DD><TT>CALL sla_CD2TF (NDP, DAYS, SIGN, IHMSF)</TT>
<P>       </DL>
<P>     <DL>
<DT><STRONG>GIVEN:</STRONG>
<DD>
<BR>
<TABLE CELLPADDING=3>
<TR VALIGN="TOP"><TD ALIGN="LEFT"><EM>NDP</EM></TD>
<TH ALIGN="LEFT"><B>I</B></TH>
<TD ALIGN="LEFT" NOWRAP>number of decimal places of seconds</TD>
</TR>
<TR VALIGN="TOP"><TD ALIGN="LEFT"><EM>DAYS</EM></TD>
<TD ALIGN="LEFT"><B>R</B></TD>
<TD ALIGN="LEFT" NOWRAP>interval in days</TD>
</TR>
</TABLE></DL>
<P>     <DL>
<DT><STRONG>RETURNED:</STRONG>
<DD>
<BR>
<TABLE CELLPADDING=3>
<TR VALIGN="TOP"><TD ALIGN="LEFT"><EM>SIGN</EM></TD>
<TH ALIGN="LEFT"><B>C</B></TH>
<TD ALIGN="LEFT" NOWRAP>`+' or `-'</TD>
</TR>
<TR VALIGN="TOP"><TD ALIGN="LEFT"><EM>IHMSF</EM></TD>
<TD ALIGN="LEFT"><B>I(4)</B></TD>
<TD ALIGN="LEFT" NOWRAP>hours, minutes, seconds, fraction</TD>
</TR>
</TABLE></DL>
<P>      <DL>
<DT><STRONG>NOTES:</STRONG>
<DD><DL COMPACT>
<DT>1.
<DD>NDP less than zero is interpreted as zero.
<DT>2.
<DD>The largest useful value for NDP is determined by the size of
DAYS, the format of REAL floating-point numbers on the target
        machine, and the risk of overflowing IHMSF(4).  For example,
        on a VAX computer, for DAYS up to 1.0, the available floating-point
        precision corresponds roughly to NDP=3.  This is well below
        the ultimate limit of NDP=9 set by the capacity of the 32-bit
        integer IHMSF(4).
  <DT>3.
<DD>The absolute value of DAYS may exceed 1.0.  In cases where it
        does not, it is up to the caller to test for and handle the
        case where DAYS is very nearly 1.0 and rounds up to 24&nbsp;hours,
        by testing for IHMSF(1)=24 and setting IHMSF(1-4) to zero.
</DL></DL>
<BR> <HR>
<A NAME="tex2html746" HREF="node33.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next_motif.gif"></A> 
<A NAME="tex2html744" HREF="node13.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up_motif.gif"></A> 
<A NAME="tex2html738" HREF="node31.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="previous_motif.gif"></A>   <A HREF="sun67.html#stardoccontents"><IMG  ALIGN="BOTTOM" BORDER="0"
 SRC="contents_motif.gif"></A>
<BR>
<B> Next:</B> <A NAME="tex2html747" HREF="node33.html">SLA_CLDJ - Calendar to MJD</A>
<BR>
<B>Up:</B> <A NAME="tex2html745" HREF="node13.html">SUBPROGRAM SPECIFICATIONS</A>
<BR>
<B> Previous:</B> <A NAME="tex2html739" HREF="node31.html">SLA_CC62S - Cartesian 6-Vector to Spherical</A>
<BR> <HR> <P>
<P><!--End of Navigation Panel-->
<ADDRESS>
<I>SLALIB --- Positional Astronomy Library<BR>Starlink User Note 67<BR>P. T. Wallace<BR>12 October 1999<BR>E-mail:ptw@star.rl.ac.uk</I>
</ADDRESS>
</BODY>
</HTML>