Changeset 133 for trunk/SRC/Calendar/julday.pro
- Timestamp:
- 07/07/06 11:57:27 (18 years ago)
- File:
-
- 1 moved
Legend:
- Unmodified
- Added
- Removed
-
trunk/SRC/Calendar/julday.pro
r132 r133 1 ; $Id$2 ;3 ; Copyright (c) 1988-2003, Research Systems, Inc. All rights reserved.4 ; Unauthorized reproduction prohibited.5 6 1 ;+ 7 ; NAME: 8 ; JULDAY 9 ; 10 ; PURPOSE: 11 ; Calculate the Julian Day Number for a given month, day, and year. 2 ; 3 ; @file_comments 4 ; Calculate the Julian Day Number for a given month, day, and year. 12 5 ; This is the inverse of the library function CALDAT. 13 6 ; See also caldat, the inverse of this function. 14 7 ; 15 ; CATEGORY: 16 ; Misc. 17 ; 18 ; CALLING SEQUENCE: 19 ; Result = JULDAY([[[[Month, Day, Year], Hour], Minute], Second]) 20 ; 21 ; INPUTS: 22 ; MONTH: Number of the desired month (1 = January, ..., 12 = December). 23 ; 24 ; DAY: Number of day of the month. 25 ; 26 ; YEAR: Number of the desired year.Year parameters must be valid 8 ; @categories Calendar 9 ; 10 ; @param MONTH {in}{required} Number of the desired month (1 = January, ..., 12 = December). Can be scalar or array 11 ; 12 ; @param DAY {in}{required} Number of day of the month.Can be scalar or array 13 ; 14 ; @param YEAR {in}{required} Number of the desired year.Year parameters must be valid 27 15 ; values from the civil calendar. Years B.C.E. are represented 28 16 ; as negative integers. Years in the common era are represented 29 17 ; as positive integers. In particular, note that there is no 30 18 ; year 0 in the civil calendar. 1 B.C.E. (-1) is followed by 31 ; 1 C.E. (1). 32 ; 33 ; HOUR: Number of the hour of the day. 34 ; 35 ; MINUTE: Number of the minute of the hour. 36 ; 37 ; SECOND: Number of the second of the minute. 38 ; 39 ; Note: Month, Day, Year, Hour, Minute, and Second can all be arrays. 40 ; The Result will have the same dimensions as the smallest array, or 19 ; 1 C.E. (1). Can be scalar or array 20 ; 21 ; @param HOUR {in}{optional} Number of the hour of the day. Can be scalar or array 22 ; 23 ; @param MINUTE {in}{optional} Number of the minute of the hour. Can be scalar or array 24 ; 25 ; @param SECOND {in}{optional} Number of the second of the minute. Can be scalar or array 26 ; 27 ; @restrictions The Result will have the same dimensions as the smallest array, or 41 28 ; will be a scalar if all arguments are scalars. 42 ; 43 ; OPTIONAL INPUT PARAMETERS: 44 ; Hour, Minute, Second = optional time of day. 45 ; 46 ; KEYWORD PARAMETERS: 47 ; 48 ; NDAYSPM: for using a calendar with fixed number of days per 49 ; months. defaut value of NDAYSPM=30 50 ; 51 ; OUTPUTS: 52 ; JULDAY returns the Julian Day Number (which begins at noon) of the 29 ; 30 ; 31 ; @keywords NDAYSPM {default=30} for using a calendar with fixed number of days per 32 ; months. 33 ; 34 ; @ returns JULDAY: the Julian Day Number (which begins at noon) of the 53 35 ; specified calendar date. If Hour, Minute, and Second are not specified, 54 36 ; then the result will be a long integer, otherwise the result is a 55 37 ; double precision floating point number. 56 38 ; 57 ; COMMON BLOCKS: cm_4cal 58 ; 59 ; SIDE EFFECTS: 60 ; None. 61 ; 62 ; RESTRICTIONS: 63 ; Accuracy using IEEE double precision numbers is approximately 39 ; @uses cm_4cal 40 ; 41 ; @restrictions Accuracy using IEEE double precision numbers is approximately 64 42 ; 1/10000th of a second, with higher accuracy for smaller (earlier) 65 43 ; Julian dates. 66 44 ; 67 ; MODIFICATION HISTORY: 68 ; Translated from "Numerical Recipies in C", by William H. Press, 45 ; @history Translated from "Numerical Recipies in C", by William H. Press, 69 46 ; Brian P. Flannery, Saul A. Teukolsky, and William T. Vetterling. 70 47 ; Cambridge University Press, 1988 (second printing). … … 82 59 ; 83 60 ; CT, April 2000, Now accepts vectors or scalars. 61 ; 62 ; @version $Id$ 84 63 ;- 85 64 ;
Note: See TracChangeset
for help on using the changeset viewer.