1 |
.TH datelist
|
1 |
.TH datelist
|
2 |
.SH NAME
|
2 |
.SH NAME
|
3 |
.B datelist - handling of datelists
|
3 |
.B datelist - handling of datelists
|
4 |
.SH SYNOPSIS
|
4 |
.SH SYNOPSIS
|
5 |
.B datelist
|
5 |
.B datelist
|
6 |
.I filename
|
6 |
.I filename
|
7 |
.I mode
|
7 |
.I mode
|
8 |
.I [ parameters ]
|
8 |
.I [ parameters ]
|
9 |
.SH DESCRIPTION
|
9 |
.SH DESCRIPTION
|
10 |
A date list is a file of dates in the format {YYYYMMDD_HH}, e.g. 19900101_00 for 00 UTC, 1 January 1990. This command offers several ways how to create date lists and to work with them.
|
10 |
A date list is a file of dates in the format {YYYYMMDD_HH}, e.g. 19900101_00 for 00 UTC, 1 January 1990. This command offers several ways how to create date lists and to work with them.
|
11 |
.SH PARAMETERS
|
11 |
.SH PARAMETERS
|
12 |
.TP 10
|
12 |
.TP 10
|
13 |
.I filename
|
13 |
.I filename
|
14 |
name of the date list file. If the name
|
14 |
name of the date list file. If the name
|
15 |
.B 'stdout'
|
15 |
.B 'stdout'
|
16 |
or
|
16 |
or
|
17 |
.B 'screen'
|
17 |
.B 'screen'
|
18 |
is given, the output will be directed to standardoutput: no file will be created.
|
18 |
is given, the output will be directed to standardoutput: no file will be created.
|
19 |
.TP 10
|
19 |
.TP 10
|
20 |
.I mode
|
20 |
.I mode
|
21 |
one of several modes (see below).
|
21 |
one of several modes (see below).
|
22 |
.SH CREATING DATE LISTS
|
22 |
.SH CREATING DATE LISTS
|
23 |
.TP 5
|
23 |
.TP 5
|
24 |
.B -create stardate enddate
|
24 |
.B -create stardate enddate
|
25 |
create a datelist from startdate (in format {YYYYMMDD_HHMM}) to enddate; the time interval is per default 6 h (see option -interval). If the start and end date do not match with the analysis times, the date list will contain the enclosing analysis times: for instance, for
|
25 |
create a datelist from startdate (in format {YYYYMMDD_HHMM}) to enddate; the time interval is per default 6 h (see option -interval). If the start and end date do not match with the analysis times, the date list will contain the enclosing analysis times: for instance, for
|
26 |
.B -create 20100201_04 20100201_19
|
26 |
.B -create 20100201_04 20100201_19
|
27 |
the date list will contain the following dates: 20100201_00, 20100201_06, 20100201_12, 20100201_18, 20100202_00.
|
27 |
the date list will contain the following dates: 20100201_00, 20100201_06, 20100201_12, 20100201_18, 20100202_00.
|
28 |
.TP 5
|
28 |
.TP 5
|
29 |
.B -indir dirname
|
29 |
.B -indir dirname
|
30 |
search for dates (in format {YYYYMMDD_HH}) in the direcory given with {dirname} - the dates are written in ascending order to the datelist file and repeating dates are removed.
|
30 |
search for dates (in format {YYYYMMDD_HH}) in the direcory given with {dirname} - the dates are written in ascending order to the datelist file and repeating dates are removed.
|
31 |
.TP 5
|
31 |
.TP 5
|
32 |
.B -interval value
|
32 |
.B -interval value
|
33 |
change the interval to {value} hours, instead of the default 6 hours.
|
33 |
change the interval to {value} hours, instead of the default 6 hours.
|
34 |
.SH INFO ABOUT DATE LISTS
|
34 |
.SH INFO ABOUT DATE LISTS
|
35 |
.TP 5
|
35 |
.TP 5
|
36 |
.B -ndates
|
36 |
.B -ndates
|
37 |
write the number of dates in the list
|
37 |
write the number of dates in the list
|
38 |
.TP 5
|
38 |
.TP 5
|
39 |
.B -timerange
|
39 |
.B -timerange
|
40 |
write the time range {last date} - {first date} [in hours].
|
40 |
write the time range {last date} - {first date} [in hours].
|
41 |
.TP 5
|
41 |
.TP 5
|
42 |
.B -isin date
|
42 |
.B -isin date
|
43 |
check whether the date is in the list (1) or not (0).
|
43 |
check whether the date is in the list (1) or not (0).
|
44 |
.SH STEPPING THROUGH DATE LISTS
|
44 |
.SH STEPPING THROUGH DATE LISTS
|
45 |
.TP 5
|
45 |
.TP 5
|
46 |
.B -first
|
46 |
.B -first
|
47 |
write the first date of the date list
|
47 |
write the first date of the date list
|
48 |
.TP 5
|
48 |
.TP 5
|
49 |
.B -last
|
49 |
.B -last
|
50 |
write the last date of the date list
|
50 |
write the last date of the date list
|
51 |
.TP 5
|
51 |
.TP 5
|
52 |
.B -next date
|
52 |
.B -next date
|
53 |
find the date {date} in the list and write the
|
53 |
find the date {date} in the list and write the
|
54 |
.B next
|
54 |
.B next
|
55 |
date to screen; if no next date is in the list, i.e. the end of the list is reached, 'nil' will be returned.
|
55 |
date to screen; if no next date is in the list, i.e. the end of the list is reached, 'nil' will be returned.
|
56 |
.TP 5
|
56 |
.TP 5
|
57 |
.B -prev date
|
57 |
.B -prev date
|
58 |
find the date {date} in the list and write the
|
58 |
find the date {date} in the list and write the
|
59 |
.B previous
|
59 |
.B previous
|
60 |
date to screen; if no previous date is in the list, i.e. the beginning of the list is reached, 'nil' will be returned.
|
60 |
date to screen; if no previous date is in the list, i.e. the beginning of the list is reached, 'nil' will be returned.
|
61 |
.SH COMPARING DATE LISTS
|
61 |
.SH COMPARING DATE LISTS
|
62 |
.TP 5
|
62 |
.TP 5
|
63 |
.B -overlap file1 file1
|
63 |
.B -overlap file1 file1
|
64 |
determine the overlap of two date lists.
|
64 |
determine the overlap of two date lists.
|
65 |
.TP 5
|
65 |
.TP 5
|
66 |
.B -onlyin1 file1 file1
|
66 |
.B -onlyin1 file1 file1
|
67 |
determine the dates which only occur in date list 1, but not in datelist 2
|
67 |
determine the dates which only occur in date list 1, but not in datelist 2
|
68 |
.TP 5
|
68 |
.TP 5
|
69 |
.B -onlyin2 file1 file1
|
69 |
.B -onlyin2 file1 file1
|
70 |
determine the dates which only occur in date list 2, but not in datelist 1
|
70 |
determine the dates which only occur in date list 2, but not in datelist 1
|
71 |
.SH Examples
|
71 |
.SH Examples
|
72 |
.TP 5
|
72 |
.TP 5
|
73 |
.B [1] datelist screen -indir ./
|
73 |
.B [1] datelist screen -indir ./
|
74 |
look for dates in the current directory and write them to screen
|
74 |
look for dates in the current directory and write them to screen
|
75 |
.TP 5
|
75 |
.TP 5
|
76 |
.B [2] datelist dates -create 19890101_00 20110101_00 -interval 2
|
76 |
.B [2] datelist dates -create 19890101_00 20110101_00 -interval 2
|
77 |
creates dates from 00 UTC, 1 January 1989 to 00 UTC, 1 January 2011 with an interval of 2 hours. The output will be written to the file 'dates'.
|
77 |
creates dates from 00 UTC, 1 January 1989 to 00 UTC, 1 January 2011 with an interval of 2 hours. The output will be written to the file 'dates'.
|
78 |
.SH AUTHOR
|
78 |
.SH AUTHOR
|
79 |
Written by Michael Sprenger and Heini Wernli (January 2011)
|
79 |
Written by Michael Sprenger and Heini Wernli (January 2011)
|