annotate main/time/datenum.m @ 0:6b33357c7561 octave-forge

Initial revision
author pkienzle
date Wed, 10 Oct 2001 19:54:49 +0000
parents
children 8adaa495124c
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
1 ## Copyright (C) 2000 Paul Kienzle
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
2 ##
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
3 ## This program is free software; you can redistribute it and/or modify
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
4 ## it under the terms of the GNU General Public License as published by
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
5 ## the Free Software Foundation; either version 2 of the License, or
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
6 ## (at your option) any later version.
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
7 ##
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
8 ## This program is distributed in the hope that it will be useful,
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
9 ## but WITHOUT ANY WARRANTY; without even the implied warranty of
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
10 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
11 ## GNU General Public License for more details.
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
12 ##
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
13 ## You should have received a copy of the GNU General Public License
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
14 ## along with this program; if not, write to the Free Software
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
15 ## Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
16
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
17 ## -*- texinfo -*-
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
18 ## @deftypefn {Function File} {} datenum(Y, M, D [, h , m [, s]])
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
19 ## @deftypefnx {Function File} {} datenum('date' [, P])
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
20 ## Returns the specified local time as a number of days since Jan 1, 0000.
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
21 ## By this reckoning, Jan 1, 1970 is day number 719529. The fractional
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
22 ## portion, corresponds to the portion of the specified day.
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
23 ##
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
24 ## Note: 32-bit architectures only handle times between Dec 14, 1901
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
25 ## and Jan 19, 2038, with special handling for 0000-01-01. datenum
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
26 ## returns -1 in case of a range error.
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
27 ##
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
28 ## @seealso{date,clock,now,datestr,datevec,calendar,weekday}
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
29 ## @end deftypefn
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
30
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
31 ## 2001-08-30 Paul Kienzle <pkienzle@users.sf.net>
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
32 ## * make it independent of time zone
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
33
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
34 function n = datenum(Y,M,D,h,m,s)
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
35 if nargin == 0 || (nargin > 2 && isstr(Y)) || nargin > 6
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
36 usage("n=datenum('date' [, P]) or n=datenum(Y, M, D [, h, m [, s]])");
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
37 endif
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
38 if isstr(Y)
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
39 if nargin < 2, M=[]; endif
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
40 [Y,M,D,h,m,s] = datevec(Y,M);
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
41 else
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
42 if nargin < 6, s = zeros(size(Y)); endif
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
43 if nargin < 5, m = s; endif
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
44 if nargin < 4, h = s; endif
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
45 endif
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
46
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
47 n = zeros(size(Y));
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
48 lt = localtime(0);
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
49 t0 = mktime(lt);
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
50 h = h+lt.hour-24;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
51 for i=1:prod(size(Y))
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
52 tm.usec = 1e6*rem(s(i),1);
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
53 tm.sec = floor(s(i));
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
54 tm.min = m(i);
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
55 tm.hour = h(i);
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
56 tm.mday = D(i);
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
57 tm.mon = M(i)-1;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
58 tm.year = Y(i)-1900;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
59 tm.zone = "GMT";
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
60 tm.wday = 0;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
61 tm.yday = 0;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
62 tm.isdst = 0;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
63 if (Y(i) == 0 && M(i) == 1 && d(i) == 1)
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
64 n(i) = (h(i)*3600 + m(i)*60 + s(i))/86400;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
65 else
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
66 t = mktime(tm);
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
67 if (t==-1 && Y(i) != 1969)
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
68 n(i) = -1;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
69 else
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
70 n(i) = (t-t0) / 86400 + 719529;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
71 endif
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
72 endif
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
73 endfor
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
74 endfunction
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
75