Mercurial > p > roundup > code
comparison doc/user_guide.txt @ 1499:8ee69708da0c
added support for searching on ranges of dates
| author | Andrey Lebedev <kedder@users.sourceforge.net> |
|---|---|
| date | Sat, 08 Mar 2003 20:41:45 +0000 |
| parents | ebfd8dd1cce7 |
| children | 3f2e516b8de3 |
comparison
equal
deleted
inserted
replaced
| 1498:203f6a154b30 | 1499:8ee69708da0c |
|---|---|
| 1 ========== | 1 ========== |
| 2 User Guide | 2 User Guide |
| 3 ========== | 3 ========== |
| 4 | 4 |
| 5 :Version: $Revision: 1.13 $ | 5 :Version: $Revision: 1.14 $ |
| 6 | 6 |
| 7 .. contents:: | 7 .. contents:: |
| 8 | 8 |
| 9 Note: this document will refer to *issues* as the primary store of information | 9 Note: this document will refer to *issues* as the primary store of information |
| 10 in the tracker. This is the default of the classic template, bubt may vary in | 10 in the tracker. This is the default of the classic template, bubt may vary in |
| 102 | 102 |
| 103 Searching Page | 103 Searching Page |
| 104 -------------- | 104 -------------- |
| 105 | 105 |
| 106 XXX: some information about how searching works | 106 XXX: some information about how searching works |
| 107 | |
| 108 Some fields in the search page (e.g. "Activity" or "Creation date") accept | |
| 109 ranges of dates. You can specify range of dates in one of two formats: | |
| 110 | |
| 111 1. Native english syntax: | |
| 112 [[From] <value>][ To <value>] | |
| 113 Keywords "From" and "To" are case insensitive. Keyword "From" is optional. | |
| 114 | |
| 115 2. "Geek" syntax: | |
| 116 [<value>][; <value>] | |
| 117 | |
| 118 Either first or second <value> can be omitted in both syntaxes. | |
| 119 | |
| 120 For example: | |
| 121 | |
| 122 if you enter string "from 9:00" to "Creation date" field, roundup | |
| 123 will find all issues, that were created today since 9 AM. | |
| 124 | |
| 125 Searching of "-2m; -1m" on activity field gives you issues, which were | |
| 126 active between period of time since 2 months up-till month ago. | |
| 127 | |
| 128 Other possible examples (consider local time is Sat Mar 8 22:07:48 EET 2003): | |
| 129 | |
| 130 >>> Range("from 2-12 to 4-2") | |
| 131 <Range from 2003-02-12.00:00:00 to 2003-04-02.00:00:00> | |
| 132 | |
| 133 >>> Range("18:00 TO +2m") | |
| 134 <Range from 2003-03-08.18:00:00 to 2003-05-08.20:07:48> | |
| 135 | |
| 136 >>> Range("12:00") | |
| 137 <Range from 2003-03-08.12:00:00 to None> | |
| 138 | |
| 139 >>> Range("tO +3d") | |
| 140 <Range from None to 2003-03-11.20:07:48> | |
| 141 | |
| 142 >>> Range("2002-11-10; 2002-12-12") | |
| 143 <Range from 2002-11-10.00:00:00 to 2002-12-12.00:00:00> | |
| 144 | |
| 145 >>> Range("; 20:00 +1d") | |
| 146 <Range from None to 2003-03-09.20:00:00> | |
| 107 | 147 |
| 108 | 148 |
| 109 Under the covers | 149 Under the covers |
| 110 ---------------- | 150 ---------------- |
| 111 | 151 |