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
|
/*
* Copyright (C) 1995. Bill Brown <brown@gis.uiuc.edu> & Michael Shapiro
*
* This program is free software under the GPL (>=v2)
* Read the file GPL.TXT coming with GRASS for details.
*/
#include <grass/datetime.h>
/*!
* \brief
*
* Returns:
* <b>datetime_check_increment</b>(src, incr) == 0
*
* \param src
* \param incr
* \return int
*/
int datetime_is_valid_increment(const DateTime *src, const DateTime *incr)
{
return datetime_check_increment(src, incr) == 0;
}
/*!
* \brief
*
* This checks if the type of 'incr' is valid for incrementing/decrementing
'src'.
* The type (mode/from/to) of the 'src' can be anything.
* The incr.mode must be RELATIVE
* A timezone in 'src' is allowed - it's presence is ignored.
* To aid in setting the 'incr' type, see <b>datetime_get_increment_type()</b>.
* Returns:
* <ul>
<li> 0 valid increment
</li>
<li> 1 src is not a legal DateTime, error code/msg are those set by
* <b>datetime_is_valid_type()</b>
</li>
<li> 2 incr is not a legal DateTime, error code/msg are those set by
* <b>datetime_is_valid_type()</b>
</li>
<li> -1 incr.mode not relative
</li>
<li> -2 incr more precise that src
</li>
<li> -3 illegal incr, must be YEAR-MONTH
</li>
<li> -4 illegal incr, must be DAY-SECOND
</li></ul>
*
* \param src
* \param incr
* \return int
*/
int datetime_check_increment(const DateTime *src, const DateTime *incr)
{
if (!datetime_is_valid_type(src))
return 1;
if (!datetime_is_valid_type(incr))
return 2;
if (!datetime_is_relative(incr))
return datetime_error(-1, "datetime increment mode not relative");
if (incr->to > src->to)
return datetime_error(-2, "datetime increment too precise");
if (datetime_in_interval_year_month(src->to) &&
!datetime_in_interval_year_month(incr->to))
return datetime_error(-3, "illegal datetime increment interval");
if (datetime_in_interval_day_second(src->to) &&
!datetime_in_interval_day_second(incr->to))
return datetime_error(-4, "illegal datetime increment interval");
return 0;
}
|
