slaesvuo/hledger
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity

;doc:queries: edits

Browse Source
This commit is contained in:
Simon Michael 2023-12-24 10:56:20 -10:00
parent d11158f53b
commit 1ac5237d54
1 changed files with 18 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
hledger/hledger.m4.md
View File

@ -4770,48 +4770,47 @@ The syntax is as follows:
`car:fuel`\ `car:fuel`\
`dining groceries` `dining groceries`
- Patterns containing spaces or other [special characters](#special-characters) must be enclosed in quotes: - Patterns containing spaces or other [special characters](#special-characters) must be enclosed in single or double quotes:
`"personal care"` `'personal care'`
- These patterns are actually [regular expressions](#regular-expressions), - These patterns are actually [regular expressions](#regular-expressions),
so you can add regular expression metacharacters for more precision so you can add regular expression metacharacters for more precision
(see "Regular expressions" for more details): (see "Regular expressions" above for more details):
`"^expenses\b"`\ `'^expenses\b'`\
`"food$"`\ `'food$'`\
`"fuel|repair"`\ `'fuel|repair'`\
`"accounts (payable|receivable)"` `'accounts (payable|receivable)'`
- Add a query type prefix to match other parts of the data: - Add a query type prefix to match things other than account names (see "Query types" below):
`date:202312-`\ `date:202312-`\
`status:`\ `status:`\
`desc:amazon`\ `desc:amazon`\
`cur:USD`\ `cur:USD`\
`cur:\\$`\ `cur:\\$`\
`"amt:>0"` `amt:'>0'`
- Add a `not:` prefix to negate: - Add a `not:` prefix to negate a term:
`not:cur:USD`\ `not:cur:USD`\
`not:desc:opening|closing` `not:desc:'opening|closing'`
- Multiple unlike terms are AND-ed, multiple like terms are OR-ed - Terms with different types are AND-ed, terms with the same type are OR-ed (mostly; see "Combining query terms" below).
The following query means\
*date is in 2022 AND ( description contains "amazon" OR "amzn" )* :
`date:2022 desc:amazon desc:amzn`\ `date:2022 desc:amazon desc:amzn`
(all transactions with "amazon" or "amzn" in description during 2022)
## Query types ## Query types
Here are the types of query term available. Here are the types of query term available.
Remember these can also be prefixed with **`not:`** to convert them into a negative match. Remember these can also be prefixed with **`not:`** to convert them into a negative match.
**`acct:REGEX`, `REGEX`**\ **`acct:REGEX`** or **`REGEX`**\
Match account names containing this (case insensitive) [regular expression]. Match account names containing this case insensitive [regular expression].
This is the default query type when there is no prefix, This is the default query type, so we usually don't bother writing the "acct:" prefix.
and regular expression syntax is typically not needed,
so usually we just write an account name substring, like `expenses` or `food`.
**`amt:N, amt:<N, amt:<=N, amt:>N, amt:>=N`**\ **`amt:N, amt:<N, amt:<=N, amt:>N, amt:>=N`**\
Match postings with a single-commodity amount equal to, less than, or greater than N. Match postings with a single-commodity amount equal to, less than, or greater than N.