source: trunk/SRC/Documentation/idldoc_assistant_output/Calendar/caldat.html @ 234

Last change on this file since 234 was 234, checked in by pinsard, 17 years ago

new idldoc html and assistant outputs
File size: 6.4 KB
Line 
1
2
3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4  <head>
5    <title>caldat.pro (SAXO Documentation Assistant)</title>
6  </head>
7
8  <body text="#000000" bgcolor="#FFFFFF">
9
10   
11<!-- Navbar template takes a structure with the following fields:
12       overview_href :
13       overview_selected :
14       dir_overview_href :
15       dir_overview_selected :
16       categories_href :
17       categories_selected :
18       index_href :
19       index_selected :
20       search_href :
21       search_selected :
22       file_selected :
23       source_href :
24       source_selected :
25       help_href :
26       help_selected :
27       etc_selected :
28
29       prev_file_href :
30       next_file_href :
31
32       view_single_page_href :
33       view_frames_href :
34
35       summary_fields_href :
36       summary_routine_href :
37       details_routine_href :
38
39       title :
40       subtitle :
41       user :
42-->
43
44
45<table border="0" cellpadding="0" cellspacing="0" width="98%" bgcolor="#F0F0FF" valign="bottom">
46  <tr>
47    <td width="10%">
48<a href=""><img src="./../prev.gif" border="0" alt="Previous"></a></td>
49    <td width="80%" align="center" valign="center">
50<font size=-1><i>SAXO Documentation Assistant</i>: <a href="./../home.html">Overview</a></font></td>
51    <td width="10%" align="right">
52<a href="date2jul.html"><img src="./../next.gif" border="0" alt="Next"></a></td>
53  </tr>
54</table>
55
56
57    <h1><font size="-2">Calendar/</font></h1>
58    <h2>caldat.pro</h2>
59
60    <dl>
61    </dl>
62
63   
64 Return the calendar date and time given julian date.
65 This is the inverse of the function
66 <a href=".//julday.html">julday</a>.
67 3 calendars are available according to the value of key_caltype
68 (variable of the common file cm_4cal): 'greg', '360d', 'noleap'
69
70
71   
72
73     
74      <a name="#_caldat"></a>
75
76      <h2>caldat  <font size="-1" color="#006633"> Calendar
77</font></h2>
78
79      <p><font face="Courier">caldat<i>, <a href="#_caldat_keyword_julian">julian</a>, <a href="#_caldat_keyword_month">month</a>, <a href="#_caldat_keyword_day">day</a>, <a href="#_caldat_keyword_year">year</a>, <a href="#_caldat_keyword_hour">hour</a>, <a href="#_caldat_keyword_minute">minute</a>, <a href="#_caldat_keyword_second">second</a></i>, <a href="#_caldat_keyword_NDAYSPM">NDAYSPM</a>=<i>integer</i></font></p>
80
81   
82
83
84   
85
86   
87    <h3>Parameters</h3>
88   
89
90    <a name="#_caldat_keyword_julian"></a>
91    <h4>julian&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
92      <font size="-1" color="#006633">in</font>
93     
94     
95      <font size="-1" color="#006633">required</font>
96     
97      <font size="-1" color="#006633">type:</font> <font size="-1" color="#006633"><i>long integer</i></font>
98     
99     
100    </h4>
101
102   
103 contains the Julian Day Number (which begins at noon) of the
104 specified calendar date.
105
106   
107
108    <a name="#_caldat_keyword_month"></a>
109    <h4>month&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
110     
111      <font size="-1" color="#006633">out</font>
112     
113     
114     
115      <font size="-1" color="#006633">type:</font> <font size="-1" color="#006633"><i>integer</i></font>
116     
117     
118    </h4>
119
120   
121 Number of the desired month (1 = January, ..., 12 = December).
122
123   
124
125    <a name="#_caldat_keyword_day"></a>
126    <h4>day&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
127     
128      <font size="-1" color="#006633">out</font>
129     
130     
131     
132      <font size="-1" color="#006633">type:</font> <font size="-1" color="#006633"><i>integer</i></font>
133     
134     
135    </h4>
136
137   
138 Number of day of the month.
139
140   
141
142    <a name="#_caldat_keyword_year"></a>
143    <h4>year&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
144     
145      <font size="-1" color="#006633">out</font>
146     
147     
148     
149      <font size="-1" color="#006633">type:</font> <font size="-1" color="#006633"><i>integer</i></font>
150     
151     
152    </h4>
153
154   
155 Number of the desired year.
156
157   
158
159    <a name="#_caldat_keyword_hour"></a>
160    <h4>hour&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
161     
162      <font size="-1" color="#006633">out</font>
163     
164     
165     
166      <font size="-1" color="#006633">type:</font> <font size="-1" color="#006633"><i>integer</i></font>
167     
168     
169    </h4>
170
171   
172 Hour of the day
173
174   
175
176    <a name="#_caldat_keyword_minute"></a>
177    <h4>minute&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
178     
179      <font size="-1" color="#006633">out</font>
180     
181     
182     
183      <font size="-1" color="#006633">type:</font> <font size="-1" color="#006633"><i>integer</i></font>
184     
185     
186    </h4>
187
188   
189 Minute of the day
190
191   
192
193    <a name="#_caldat_keyword_second"></a>
194    <h4>second&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
195     
196      <font size="-1" color="#006633">out</font>
197     
198     
199     
200      <font size="-1" color="#006633">type:</font> <font size="-1" color="#006633"><i>float</i></font>
201     
202     
203    </h4>
204
205   
206 Second (and fractions) of the day.
207
208   
209   
210
211   
212    <h3>Keywords</h3>
213
214   
215    <a name="#_caldat_keyword_NDAYSPM"></a>
216    <h4>NDAYSPM&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
217     
218     
219     
220     
221     
222      <font size="-1" color="#006633">type:</font> <font size="-1" color="#006633"><i>integer</i></font>
223      <font size="-1" color="#006633">default:</font> <font size="-1" color="#006633"><i>30</i></font>
224     
225    </h4>
226
227   
228 To use a calendar with fixed number of days per month.
229 see also the use of key_caltype (variable of the common file cm_4cal)
230
231   
232   
233
234   
235    </pre><h3>Version history</h3>
236   
237    <h4>Version</h4>
238 $Id: caldat.pro 231 2007-03-19 17:15:51Z pinsard $
239    <h4>History</h4>
240 Translated from "Numerical Recipies in C", by William H. Press,
241 Brian P. Flannery, Saul A. Teukolsky, and William T. Vetterling.
242 Cambridge University Press, 1988 (second printing).
243
244 DMS, July 1992.
245 DMS, April 1996, Added HOUR, MINUTE and SECOND keyword
246 AB, 7 December 1997, Generalized to handle array input.
247
248 Eric Guilyardi, June 1999
249 Added key_work ndayspm for fixed number of days per months
250
251 AB, 3 January 2000, Make seconds output as DOUBLE in array output.
252
253 Sebastien Masson, May 2006, add different calendar with key_caltype
254 (variable of the common file cm_4cal)
255
256   
257
258    <h3>Known issues</h3>
259   
260   
261   
262    <h4>Restrictions</h4>
263 Accuracy using IEEE double precision numbers is approximately 1/10000th of a
264 second.
265
266
267    <h3>Other attributes</h3>
268   
269   
270    <h4>Uses routines</h4> cm_4cal
271
272   
273   
274   
275
276    <font size="-3"><p>&nbsp;</p></font>
277    <hr size="1" color="#CCCCCC"/>
278     
279
280   
281
282    <p><font color="gray" size="-3">&nbsp;&nbsp;Produced by IDLdoc 2.0.</font></p>
283
284  </body>
285</html>
Note: See TracBrowser for help on using the repository browser.