;update manuals

This commit is contained in:
Simon Michael 2021-05-18 10:48:42 -10:00
parent 031219e792
commit 6a3019c5a8
9 changed files with 594 additions and 571 deletions

View File

@ -97,10 +97,12 @@ do extra error checking (check that all posted accounts are declared)
hledger reporting options: hledger reporting options:
.TP .TP
\f[B]\f[CB]-b --begin=DATE\f[B]\f[R] \f[B]\f[CB]-b --begin=DATE\f[B]\f[R]
include postings/txns on or after this date include postings/txns on or after this date (will be adjusted to
preceding subperiod start when using a report interval)
.TP .TP
\f[B]\f[CB]-e --end=DATE\f[B]\f[R] \f[B]\f[CB]-e --end=DATE\f[B]\f[R]
include postings/txns before this date include postings/txns before this date (will be adjusted to following
subperiod end when using a report interval)
.TP .TP
\f[B]\f[CB]-D --daily\f[B]\f[R] \f[B]\f[CB]-D --daily\f[B]\f[R]
multiperiod/multicolumn report by day multiperiod/multicolumn report by day

View File

@ -107,10 +107,12 @@ the data.
hledger reporting options: hledger reporting options:
`-b --begin=DATE' `-b --begin=DATE'
include postings/txns on or after this date include postings/txns on or after this date (will be adjusted to
preceding subperiod start when using a report interval)
`-e --end=DATE' `-e --end=DATE'
include postings/txns before this date include postings/txns before this date (will be adjusted to
following subperiod end when using a report interval)
`-D --daily' `-D --daily'
multiperiod/multicolumn report by day multiperiod/multicolumn report by day
@ -529,23 +531,23 @@ Tag Table:
Node: Top82 Node: Top82
Node: OPTIONS1478 Node: OPTIONS1478
Ref: #options1575 Ref: #options1575
Node: KEYS5808 Node: KEYS5970
Ref: #keys5903 Ref: #keys6065
Node: SCREENS10199 Node: SCREENS10361
Ref: #screens10304 Ref: #screens10466
Node: Accounts screen10394 Node: Accounts screen10556
Ref: #accounts-screen10522 Ref: #accounts-screen10684
Node: Register screen12726 Node: Register screen12888
Ref: #register-screen12881 Ref: #register-screen13043
Node: Transaction screen14876 Node: Transaction screen15038
Ref: #transaction-screen15034 Ref: #transaction-screen15196
Node: Error screen15901 Node: Error screen16063
Ref: #error-screen16023 Ref: #error-screen16185
Node: ENVIRONMENT16265 Node: ENVIRONMENT16427
Ref: #environment16379 Ref: #environment16541
Node: FILES17184 Node: FILES17346
Ref: #files17283 Ref: #files17445
Node: BUGS17496 Node: BUGS17658
Ref: #bugs17573 Ref: #bugs17735
 
End Tag Table End Tag Table

View File

@ -92,10 +92,12 @@ OPTIONS
hledger reporting options: hledger reporting options:
-b --begin=DATE -b --begin=DATE
include postings/txns on or after this date include postings/txns on or after this date (will be adjusted to
preceding subperiod start when using a report interval)
-e --end=DATE -e --end=DATE
include postings/txns before this date include postings/txns before this date (will be adjusted to fol-
lowing subperiod end when using a report interval)
-D --daily -D --daily
multiperiod/multicolumn report by day multiperiod/multicolumn report by day

View File

@ -126,10 +126,12 @@ do extra error checking (check that all posted accounts are declared)
hledger reporting options: hledger reporting options:
.TP .TP
\f[B]\f[CB]-b --begin=DATE\f[B]\f[R] \f[B]\f[CB]-b --begin=DATE\f[B]\f[R]
include postings/txns on or after this date include postings/txns on or after this date (will be adjusted to
preceding subperiod start when using a report interval)
.TP .TP
\f[B]\f[CB]-e --end=DATE\f[B]\f[R] \f[B]\f[CB]-e --end=DATE\f[B]\f[R]
include postings/txns before this date include postings/txns before this date (will be adjusted to following
subperiod end when using a report interval)
.TP .TP
\f[B]\f[CB]-D --daily\f[B]\f[R] \f[B]\f[CB]-D --daily\f[B]\f[R]
multiperiod/multicolumn report by day multiperiod/multicolumn report by day

View File

@ -133,10 +133,12 @@ before options, as shown in the synopsis above.
hledger reporting options: hledger reporting options:
`-b --begin=DATE' `-b --begin=DATE'
include postings/txns on or after this date include postings/txns on or after this date (will be adjusted to
preceding subperiod start when using a report interval)
`-e --end=DATE' `-e --end=DATE'
include postings/txns before this date include postings/txns before this date (will be adjusted to
following subperiod end when using a report interval)
`-D --daily' `-D --daily'
multiperiod/multicolumn report by day multiperiod/multicolumn report by day
@ -608,19 +610,19 @@ Tag Table:
Node: Top84 Node: Top84
Node: OPTIONS1727 Node: OPTIONS1727
Ref: #options1832 Ref: #options1832
Node: PERMISSIONS9083 Node: PERMISSIONS9245
Ref: #permissions9222 Ref: #permissions9384
Node: EDITING UPLOADING DOWNLOADING10434 Node: EDITING UPLOADING DOWNLOADING10596
Ref: #editing-uploading-downloading10615 Ref: #editing-uploading-downloading10777
Node: RELOADING11446 Node: RELOADING11608
Ref: #reloading11580 Ref: #reloading11742
Node: JSON API12012 Node: JSON API12174
Ref: #json-api12126 Ref: #json-api12288
Node: ENVIRONMENT17615 Node: ENVIRONMENT17777
Ref: #environment17731 Ref: #environment17893
Node: FILES18463 Node: FILES18625
Ref: #files18563 Ref: #files18725
Node: BUGS18776 Node: BUGS18938
Ref: #bugs18854 Ref: #bugs19016
 
End Tag Table End Tag Table

View File

@ -115,10 +115,12 @@ OPTIONS
hledger reporting options: hledger reporting options:
-b --begin=DATE -b --begin=DATE
include postings/txns on or after this date include postings/txns on or after this date (will be adjusted to
preceding subperiod start when using a report interval)
-e --end=DATE -e --end=DATE
include postings/txns before this date include postings/txns before this date (will be adjusted to fol-
lowing subperiod end when using a report interval)
-D --daily -D --daily
multiperiod/multicolumn report by day multiperiod/multicolumn report by day

View File

@ -119,10 +119,12 @@ do extra error checking (check that all posted accounts are declared)
General reporting options: General reporting options:
.TP .TP
\f[B]\f[CB]-b --begin=DATE\f[B]\f[R] \f[B]\f[CB]-b --begin=DATE\f[B]\f[R]
include postings/txns on or after this date include postings/txns on or after this date (will be adjusted to
preceding subperiod start when using a report interval)
.TP .TP
\f[B]\f[CB]-e --end=DATE\f[B]\f[R] \f[B]\f[CB]-e --end=DATE\f[B]\f[R]
include postings/txns before this date include postings/txns before this date (will be adjusted to following
subperiod end when using a report interval)
.TP .TP
\f[B]\f[CB]-D --daily\f[B]\f[R] \f[B]\f[CB]-D --daily\f[B]\f[R]
multiperiod/multicolumn report by day multiperiod/multicolumn report by day
@ -780,6 +782,9 @@ The effective report start and end dates are the intersection of the
start/end dates from options and that from \f[C]date:\f[R] queries. start/end dates from options and that from \f[C]date:\f[R] queries.
That is, \f[C]date:2019-01 date:2019 -p\[aq]2000 to 2030\[aq]\f[R] That is, \f[C]date:2019-01 date:2019 -p\[aq]2000 to 2030\[aq]\f[R]
yields January 2019, the smallest common time span. yields January 2019, the smallest common time span.
.IP \[bu] 2
A report interval (see below) will adjust start/end dates, when needed,
so that they fall on subperiod boundaries.
.PP .PP
Examples: Examples:
.PP .PP
@ -1207,6 +1212,8 @@ Examples: \f[C]date:2016\f[R], \f[C]date:thismonth\f[R],
\f[C]date:2000/2/1-2/15\f[R], \f[C]date:lastweek-\f[R]. \f[C]date:2000/2/1-2/15\f[R], \f[C]date:lastweek-\f[R].
If the \f[C]--date2\f[R] command line flag is present, this matches If the \f[C]--date2\f[R] command line flag is present, this matches
secondary dates instead. secondary dates instead.
(Report intervals will adjust start/end dates to preceding/following
subperiod boundaries.)
.TP .TP
\f[B]\f[R]\f[C]date2:PERIODEXPR\f[R]\f[B]\f[R] \f[B]\f[R]\f[C]date2:PERIODEXPR\f[R]\f[B]\f[R]
match secondary dates within the specified period. match secondary dates within the specified period.

View File

@ -149,10 +149,12 @@ by most hledger commands, run `hledger -h'.
General reporting options: General reporting options:
`-b --begin=DATE' `-b --begin=DATE'
include postings/txns on or after this date include postings/txns on or after this date (will be adjusted to
preceding subperiod start when using a report interval)
`-e --end=DATE' `-e --end=DATE'
include postings/txns before this date include postings/txns before this date (will be adjusted to
following subperiod end when using a report interval)
`-D --daily' `-D --daily'
multiperiod/multicolumn report by day multiperiod/multicolumn report by day
@ -726,6 +728,9 @@ these accept the smart date syntax.
That is, `date:2019-01 date:2019 -p'2000 to 2030'' yields January That is, `date:2019-01 date:2019 -p'2000 to 2030'' yields January
2019, the smallest common time span. 2019, the smallest common time span.
* A report interval (see below) will adjust start/end dates, when
needed, so that they fall on subperiod boundaries.
Examples: Examples:
`-b begin on St. Patrick's day 2016 `-b begin on St. Patrick's day 2016
@ -982,7 +987,8 @@ also be prefixed with *`not:'*, eg to exclude a particular subaccount.
expression (with no report interval). Examples: `date:2016', expression (with no report interval). Examples: `date:2016',
`date:thismonth', `date:2000/2/1-2/15', `date:lastweek-'. If the `date:thismonth', `date:2000/2/1-2/15', `date:lastweek-'. If the
`--date2' command line flag is present, this matches secondary `--date2' command line flag is present, this matches secondary
dates instead. dates instead. (Report intervals will adjust start/end dates to
preceding/following subperiod boundaries.)
*`date2:PERIODEXPR'* *`date2:PERIODEXPR'*
match secondary dates within the specified period. match secondary dates within the specified period.
@ -8691,447 +8697,447 @@ Node: OPTIONS2449
Ref: #options2550 Ref: #options2550
Node: General options2692 Node: General options2692
Ref: #general-options2817 Ref: #general-options2817
Node: Command options6386 Node: Command options6548
Ref: #command-options6537 Ref: #command-options6699
Node: Command arguments6936 Node: Command arguments7098
Ref: #command-arguments7094 Ref: #command-arguments7256
Node: Special characters7972 Node: Special characters8134
Ref: #special-characters8135 Ref: #special-characters8297
Node: Single escaping shell metacharacters8298 Node: Single escaping shell metacharacters8460
Ref: #single-escaping-shell-metacharacters8539 Ref: #single-escaping-shell-metacharacters8701
Node: Double escaping regular expression metacharacters8941 Node: Double escaping regular expression metacharacters9103
Ref: #double-escaping-regular-expression-metacharacters9252 Ref: #double-escaping-regular-expression-metacharacters9414
Node: Triple escaping for add-on commands9778 Node: Triple escaping for add-on commands9940
Ref: #triple-escaping-for-add-on-commands10038 Ref: #triple-escaping-for-add-on-commands10200
Node: Less escaping10684 Node: Less escaping10846
Ref: #less-escaping10838 Ref: #less-escaping11000
Node: Unicode characters11164 Node: Unicode characters11326
Ref: #unicode-characters11329 Ref: #unicode-characters11491
Node: Regular expressions12738 Node: Regular expressions12900
Ref: #regular-expressions12878 Ref: #regular-expressions13040
Node: ENVIRONMENT14619 Node: ENVIRONMENT14781
Ref: #environment14735 Ref: #environment14897
Node: DATA FILES15717 Node: DATA FILES15879
Ref: #data-files15836 Ref: #data-files15998
Node: Data formats16377 Node: Data formats16539
Ref: #data-formats16495 Ref: #data-formats16657
Node: Multiple files17977 Node: Multiple files18139
Ref: #multiple-files18119 Ref: #multiple-files18281
Node: Strict mode18589 Node: Strict mode18751
Ref: #strict-mode18704 Ref: #strict-mode18866
Node: TIME PERIODS19355 Node: TIME PERIODS19517
Ref: #time-periods19472 Ref: #time-periods19634
Node: Smart dates19570 Node: Smart dates19732
Ref: #smart-dates19696 Ref: #smart-dates19858
Node: Report start & end date21000 Node: Report start & end date21162
Ref: #report-start-end-date21175 Ref: #report-start-end-date21337
Node: Report intervals22719 Node: Report intervals23007
Ref: #report-intervals22887 Ref: #report-intervals23175
Node: Period expressions24161 Node: Period expressions24449
Ref: #period-expressions24301 Ref: #period-expressions24589
Node: DEPTH28680 Node: DEPTH28968
Ref: #depth28780 Ref: #depth29068
Node: QUERIES29111 Node: QUERIES29399
Ref: #queries29210 Ref: #queries29498
Node: COSTING33162 Node: COSTING33547
Ref: #costing33265 Ref: #costing33650
Node: VALUATION33538 Node: VALUATION33923
Ref: #valuation33646 Ref: #valuation34031
Node: -V Value34369 Node: -V Value34754
Ref: #v-value34493 Ref: #v-value34878
Node: -X Value in specified commodity34687 Node: -X Value in specified commodity35072
Ref: #x-value-in-specified-commodity34880 Ref: #x-value-in-specified-commodity35265
Node: Valuation date35029 Node: Valuation date35414
Ref: #valuation-date35191 Ref: #valuation-date35576
Node: Market prices35628 Node: Market prices36013
Ref: #market-prices35809 Ref: #market-prices36194
Node: --infer-market-price market prices from transactions36991 Node: --infer-market-price market prices from transactions37376
Ref: #infer-market-price-market-prices-from-transactions37255 Ref: #infer-market-price-market-prices-from-transactions37640
Node: Valuation commodity38604 Node: Valuation commodity38989
Ref: #valuation-commodity38814 Ref: #valuation-commodity39199
Node: Simple valuation examples40039 Node: Simple valuation examples40424
Ref: #simple-valuation-examples40235 Ref: #simple-valuation-examples40620
Node: --value Flexible valuation40897 Node: --value Flexible valuation41282
Ref: #value-flexible-valuation41099 Ref: #value-flexible-valuation41484
Node: More valuation examples42741 Node: More valuation examples43126
Ref: #more-valuation-examples42942 Ref: #more-valuation-examples43327
Node: Effect of valuation on reports44948 Node: Effect of valuation on reports45333
Ref: #effect-of-valuation-on-reports45130 Ref: #effect-of-valuation-on-reports45515
Node: PIVOTING53027 Node: PIVOTING53412
Ref: #pivoting53132 Ref: #pivoting53517
Node: OUTPUT54811 Node: OUTPUT55196
Ref: #output54913 Ref: #output55298
Node: Output destination54964 Node: Output destination55349
Ref: #output-destination55097 Ref: #output-destination55482
Node: Output format55753 Node: Output format56138
Ref: #output-format55876 Ref: #output-format56261
Node: COMMANDS58039 Node: COMMANDS58424
Ref: #commands58151 Ref: #commands58536
Node: accounts61541 Node: accounts61926
Ref: #accounts61641 Ref: #accounts62026
Node: activity62333 Node: activity62718
Ref: #activity62445 Ref: #activity62830
Node: add62827 Node: add63212
Ref: #add62930 Ref: #add63315
Node: aregister65725 Node: aregister66110
Ref: #aregister65839 Ref: #aregister66224
Node: aregister and custom posting dates68034 Node: aregister and custom posting dates68419
Ref: #aregister-and-custom-posting-dates68200 Ref: #aregister-and-custom-posting-dates68585
Node: balance69021 Node: balance69406
Ref: #balance69140 Ref: #balance69525
Node: balance features70053 Node: balance features70438
Ref: #balance-features70193 Ref: #balance-features70578
Node: Simple balance report71863 Node: Simple balance report72248
Ref: #simple-balance-report72045 Ref: #simple-balance-report72430
Node: Filtered balance report73493 Node: Filtered balance report73878
Ref: #filtered-balance-report73680 Ref: #filtered-balance-report74065
Node: List or tree mode73977 Node: List or tree mode74362
Ref: #list-or-tree-mode74145 Ref: #list-or-tree-mode74530
Node: Depth limiting75462 Node: Depth limiting75847
Ref: #depth-limiting75628 Ref: #depth-limiting76013
Node: Multi-period balance report76386 Node: Multi-period balance report76771
Ref: #multi-period-balance-report76578 Ref: #multi-period-balance-report76963
Node: Sorting by amount78834 Node: Sorting by amount79219
Ref: #sorting-by-amount79003 Ref: #sorting-by-amount79388
Node: Percentages79465 Node: Percentages79850
Ref: #percentages79621 Ref: #percentages80006
Node: Balance change end balance80553 Node: Balance change end balance80938
Ref: #balance-change-end-balance80744 Ref: #balance-change-end-balance81129
Node: Balance report types82168 Node: Balance report types82553
Ref: #balance-report-types82358 Ref: #balance-report-types82743
Node: Useful balance reports86522 Node: Useful balance reports86907
Ref: #useful-balance-reports86703 Ref: #useful-balance-reports87088
Node: Budget report87787 Node: Budget report88172
Ref: #budget-report87971 Ref: #budget-report88356
Node: Budget report start date93140 Node: Budget report start date93525
Ref: #budget-report-start-date93309 Ref: #budget-report-start-date93694
Node: Nested budgets94636 Node: Nested budgets95021
Ref: #nested-budgets94785 Ref: #nested-budgets95170
Node: Customising single-period balance reports98172 Node: Customising single-period balance reports98557
Ref: #customising-single-period-balance-reports98381 Ref: #customising-single-period-balance-reports98766
Node: balancesheet100538 Node: balancesheet100923
Ref: #balancesheet100676 Ref: #balancesheet101061
Node: balancesheetequity101974 Node: balancesheetequity102359
Ref: #balancesheetequity102125 Ref: #balancesheetequity102510
Node: cashflow103505 Node: cashflow103890
Ref: #cashflow103629 Ref: #cashflow104014
Node: check104775 Node: check105160
Ref: #check104880 Ref: #check105265
Node: Basic checks105513 Node: Basic checks105898
Ref: #basic-checks105631 Ref: #basic-checks106016
Node: Strict checks106164 Node: Strict checks106549
Ref: #strict-checks106305 Ref: #strict-checks106690
Node: Other checks106609 Node: Other checks106994
Ref: #other-checks106749 Ref: #other-checks107134
Node: Custom checks107106 Node: Custom checks107491
Ref: #custom-checks107226 Ref: #custom-checks107611
Node: close107644 Node: close108029
Ref: #close107748 Ref: #close108133
Node: close usage109265 Node: close usage109650
Ref: #close-usage109360 Ref: #close-usage109745
Node: codes112168 Node: codes112553
Ref: #codes112278 Ref: #codes112663
Node: commodities112991 Node: commodities113376
Ref: #commodities113120 Ref: #commodities113505
Node: descriptions113202 Node: descriptions113587
Ref: #descriptions113332 Ref: #descriptions113717
Node: diff113636 Node: diff114021
Ref: #diff113744 Ref: #diff114129
Node: files114789 Node: files115174
Ref: #files114891 Ref: #files115276
Node: help115037 Node: help115422
Ref: #help115139 Ref: #help115524
Node: import115862 Node: import116247
Ref: #import115978 Ref: #import116363
Node: Deduplication116840 Node: Deduplication117225
Ref: #deduplication116965 Ref: #deduplication117350
Node: Import testing118853 Node: Import testing119238
Ref: #import-testing119018 Ref: #import-testing119403
Node: Importing balance assignments119508 Node: Importing balance assignments119893
Ref: #importing-balance-assignments119714 Ref: #importing-balance-assignments120099
Node: Commodity display styles120361 Node: Commodity display styles120746
Ref: #commodity-display-styles120534 Ref: #commodity-display-styles120919
Node: incomestatement120663 Node: incomestatement121048
Ref: #incomestatement120798 Ref: #incomestatement121183
Node: notes122099 Node: notes122484
Ref: #notes122214 Ref: #notes122599
Node: payees122581 Node: payees122966
Ref: #payees122689 Ref: #payees123074
Node: prices123215 Node: prices123600
Ref: #prices123323 Ref: #prices123708
Node: print123662 Node: print124047
Ref: #print123774 Ref: #print124159
Node: print-unique129084 Node: print-unique129469
Ref: #print-unique129212 Ref: #print-unique129597
Node: register129498 Node: register129883
Ref: #register129627 Ref: #register130012
Node: Custom register output134071 Node: Custom register output134456
Ref: #custom-register-output134202 Ref: #custom-register-output134587
Node: register-match135539 Node: register-match135924
Ref: #register-match135675 Ref: #register-match136060
Node: rewrite136023 Node: rewrite136408
Ref: #rewrite136140 Ref: #rewrite136525
Node: Re-write rules in a file138046 Node: Re-write rules in a file138431
Ref: #re-write-rules-in-a-file138209 Ref: #re-write-rules-in-a-file138594
Node: Diff output format139359 Node: Diff output format139744
Ref: #diff-output-format139542 Ref: #diff-output-format139927
Node: rewrite vs print --auto140634 Node: rewrite vs print --auto141019
Ref: #rewrite-vs.-print---auto140794 Ref: #rewrite-vs.-print---auto141179
Node: roi141344 Node: roi141729
Ref: #roi141444 Ref: #roi141829
Node: Semantics of --inv and --pnl143079 Node: Semantics of --inv and --pnl143464
Ref: #semantics-of---inv-and---pnl143261 Ref: #semantics-of---inv-and---pnl143646
Node: IRR and TWR explained145107 Node: IRR and TWR explained145492
Ref: #irr-and-twr-explained145267 Ref: #irr-and-twr-explained145652
Node: stats148329 Node: stats148714
Ref: #stats148430 Ref: #stats148815
Node: tags149217 Node: tags149602
Ref: #tags149317 Ref: #tags149702
Node: test149834 Node: test150219
Ref: #test149950 Ref: #test150335
Node: About add-on commands150695 Node: About add-on commands151080
Ref: #about-add-on-commands150832 Ref: #about-add-on-commands151217
Node: JOURNAL FORMAT151965 Node: JOURNAL FORMAT152350
Ref: #journal-format152093 Ref: #journal-format152478
Node: Transactions154273 Node: Transactions154658
Ref: #transactions154388 Ref: #transactions154773
Node: Dates155405 Node: Dates155790
Ref: #dates155521 Ref: #dates155906
Node: Simple dates155586 Node: Simple dates155971
Ref: #simple-dates155706 Ref: #simple-dates156091
Node: Secondary dates156213 Node: Secondary dates156598
Ref: #secondary-dates156361 Ref: #secondary-dates156746
Node: Posting dates157695 Node: Posting dates158080
Ref: #posting-dates157818 Ref: #posting-dates158203
Node: Status159187 Node: Status159572
Ref: #status159304 Ref: #status159689
Node: Description161009 Node: Description161394
Ref: #description161139 Ref: #description161524
Node: Payee and note161457 Node: Payee and note161842
Ref: #payee-and-note161565 Ref: #payee-and-note161950
Node: Comments161899 Node: Comments162284
Ref: #comments162021 Ref: #comments162406
Node: Tags163214 Node: Tags163599
Ref: #tags-1163325 Ref: #tags-1163710
Node: Postings164723 Node: Postings165108
Ref: #postings164847 Ref: #postings165232
Node: Virtual postings165871 Node: Virtual postings166256
Ref: #virtual-postings165982 Ref: #virtual-postings166367
Node: Account names167284 Node: Account names167669
Ref: #account-names167421 Ref: #account-names167806
Node: Amounts167907 Node: Amounts168292
Ref: #amounts168042 Ref: #amounts168427
Node: Decimal marks digit group marks169000 Node: Decimal marks digit group marks169385
Ref: #decimal-marks-digit-group-marks169175 Ref: #decimal-marks-digit-group-marks169560
Node: Commodity170047 Node: Commodity170432
Ref: #commodity170205 Ref: #commodity170590
Node: Commodity directives171155 Node: Commodity directives171540
Ref: #commodity-directives171327 Ref: #commodity-directives171712
Node: Commodity display style171813 Node: Commodity display style172198
Ref: #commodity-display-style171990 Ref: #commodity-display-style172375
Node: Rounding174098 Node: Rounding174483
Ref: #rounding174216 Ref: #rounding174601
Node: Transaction prices174626 Node: Transaction prices175011
Ref: #transaction-prices174792 Ref: #transaction-prices175177
Node: Lot prices lot dates177222 Node: Lot prices lot dates177607
Ref: #lot-prices-lot-dates177405 Ref: #lot-prices-lot-dates177790
Node: Balance assertions177892 Node: Balance assertions178277
Ref: #balance-assertions178070 Ref: #balance-assertions178455
Node: Assertions and ordering179100 Node: Assertions and ordering179485
Ref: #assertions-and-ordering179282 Ref: #assertions-and-ordering179667
Node: Assertions and included files179979 Node: Assertions and included files180364
Ref: #assertions-and-included-files180216 Ref: #assertions-and-included-files180601
Node: Assertions and multiple -f options180547 Node: Assertions and multiple -f options180932
Ref: #assertions-and-multiple--f-options180797 Ref: #assertions-and-multiple--f-options181182
Node: Assertions and commodities180928 Node: Assertions and commodities181313
Ref: #assertions-and-commodities181154 Ref: #assertions-and-commodities181539
Node: Assertions and prices182309 Node: Assertions and prices182694
Ref: #assertions-and-prices182517 Ref: #assertions-and-prices182902
Node: Assertions and subaccounts182958 Node: Assertions and subaccounts183343
Ref: #assertions-and-subaccounts183181 Ref: #assertions-and-subaccounts183566
Node: Assertions and virtual postings183505 Node: Assertions and virtual postings183890
Ref: #assertions-and-virtual-postings183741 Ref: #assertions-and-virtual-postings184126
Node: Assertions and precision183882 Node: Assertions and precision184267
Ref: #assertions-and-precision184069 Ref: #assertions-and-precision184454
Node: Balance assignments184334 Node: Balance assignments184719
Ref: #balance-assignments184504 Ref: #balance-assignments184889
Node: Balance assignments and prices185667 Node: Balance assignments and prices186052
Ref: #balance-assignments-and-prices185833 Ref: #balance-assignments-and-prices186218
Node: Directives186059 Node: Directives186444
Ref: #directives186222 Ref: #directives186607
Node: Directives and multiple files191627 Node: Directives and multiple files192012
Ref: #directives-and-multiple-files191823 Ref: #directives-and-multiple-files192208
Node: Comment blocks192485 Node: Comment blocks192870
Ref: #comment-blocks192662 Ref: #comment-blocks193047
Node: Including other files192837 Node: Including other files193222
Ref: #including-other-files193011 Ref: #including-other-files193396
Node: Default year193935 Node: Default year194320
Ref: #default-year194093 Ref: #default-year194478
Node: Declaring payees194500 Node: Declaring payees194885
Ref: #declaring-payees194666 Ref: #declaring-payees195051
Node: Declaring commodities194911 Node: Declaring commodities195296
Ref: #declaring-commodities195092 Ref: #declaring-commodities195477
Node: Commodity error checking197468 Node: Commodity error checking197853
Ref: #commodity-error-checking197618 Ref: #commodity-error-checking198003
Node: Default commodity197874 Node: Default commodity198259
Ref: #default-commodity198054 Ref: #default-commodity198439
Node: Declaring market prices198928 Node: Declaring market prices199313
Ref: #declaring-market-prices199117 Ref: #declaring-market-prices199502
Node: Declaring accounts199975 Node: Declaring accounts200360
Ref: #declaring-accounts200155 Ref: #declaring-accounts200540
Node: Account error checking201362 Node: Account error checking201747
Ref: #account-error-checking201528 Ref: #account-error-checking201913
Node: Account comments202705 Node: Account comments203090
Ref: #account-comments202889 Ref: #account-comments203274
Node: Account subdirectives203315 Node: Account subdirectives203700
Ref: #account-subdirectives203500 Ref: #account-subdirectives203885
Node: Account types203815 Node: Account types204200
Ref: #account-types203989 Ref: #account-types204374
Node: Declaring account types204724 Node: Declaring account types205109
Ref: #declaring-account-types204903 Ref: #declaring-account-types205288
Node: Auto-detected account types205554 Node: Auto-detected account types205939
Ref: #auto-detected-account-types205795 Ref: #auto-detected-account-types206180
Node: Interference from auto-detected account types206761 Node: Interference from auto-detected account types207146
Ref: #interference-from-auto-detected-account-types207038 Ref: #interference-from-auto-detected-account-types207423
Node: Old account type syntax207521 Node: Old account type syntax207906
Ref: #old-account-type-syntax207718 Ref: #old-account-type-syntax208103
Node: Account display order208019 Node: Account display order208404
Ref: #account-display-order208179 Ref: #account-display-order208564
Node: Rewriting accounts209330 Node: Rewriting accounts209715
Ref: #rewriting-accounts209509 Ref: #rewriting-accounts209894
Node: Basic aliases210268 Node: Basic aliases210653
Ref: #basic-aliases210404 Ref: #basic-aliases210789
Node: Regex aliases211106 Node: Regex aliases211491
Ref: #regex-aliases211268 Ref: #regex-aliases211653
Node: Combining aliases211988 Node: Combining aliases212373
Ref: #combining-aliases212171 Ref: #combining-aliases212556
Node: Aliases and multiple files213448 Node: Aliases and multiple files213833
Ref: #aliases-and-multiple-files213647 Ref: #aliases-and-multiple-files214032
Node: end aliases214228 Node: end aliases214613
Ref: #end-aliases214375 Ref: #end-aliases214760
Node: Default parent account214477 Node: Default parent account214862
Ref: #default-parent-account214667 Ref: #default-parent-account215052
Node: Periodic transactions215551 Node: Periodic transactions215936
Ref: #periodic-transactions215734 Ref: #periodic-transactions216119
Node: Periodic rule syntax217651 Node: Periodic rule syntax218036
Ref: #periodic-rule-syntax217851 Ref: #periodic-rule-syntax218236
Node: Two spaces between period expression and description!218554 Node: Two spaces between period expression and description!218939
Ref: #two-spaces-between-period-expression-and-description218867 Ref: #two-spaces-between-period-expression-and-description219252
Node: Forecasting with periodic transactions219552 Node: Forecasting with periodic transactions219937
Ref: #forecasting-with-periodic-transactions219851 Ref: #forecasting-with-periodic-transactions220236
Node: Budgeting with periodic transactions221897 Node: Budgeting with periodic transactions222282
Ref: #budgeting-with-periodic-transactions222130 Ref: #budgeting-with-periodic-transactions222515
Node: Auto postings222537 Node: Auto postings222922
Ref: #auto-postings222673 Ref: #auto-postings223058
Node: Auto postings and multiple files224856 Node: Auto postings and multiple files225241
Ref: #auto-postings-and-multiple-files225054 Ref: #auto-postings-and-multiple-files225439
Node: Auto postings and dates225262 Node: Auto postings and dates225647
Ref: #auto-postings-and-dates225530 Ref: #auto-postings-and-dates225915
Node: Auto postings and transaction balancing / inferred amounts / balance assertions225705 Node: Auto postings and transaction balancing / inferred amounts / balance assertions226090
Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions226051 Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions226436
Node: Auto posting tags226396 Node: Auto posting tags226781
Ref: #auto-posting-tags226605 Ref: #auto-posting-tags226990
Node: CSV FORMAT227242 Node: CSV FORMAT227627
Ref: #csv-format227370 Ref: #csv-format227755
Node: Examples229951 Node: Examples230336
Ref: #examples230054 Ref: #examples230439
Node: Basic230261 Node: Basic230646
Ref: #basic230363 Ref: #basic230748
Node: Bank of Ireland230907 Node: Bank of Ireland231292
Ref: #bank-of-ireland231044 Ref: #bank-of-ireland231429
Node: Amazon232509 Node: Amazon232894
Ref: #amazon232629 Ref: #amazon233014
Node: Paypal234350 Node: Paypal234735
Ref: #paypal234446 Ref: #paypal234831
Node: CSV rules242094 Node: CSV rules242479
Ref: #csv-rules242212 Ref: #csv-rules242597
Node: skip242524 Node: skip242909
Ref: #skip242619 Ref: #skip243004
Node: fields242991 Node: fields243376
Ref: #fields243115 Ref: #fields243500
Node: Transaction field names244276 Node: Transaction field names244661
Ref: #transaction-field-names244438 Ref: #transaction-field-names244823
Node: Posting field names244549 Node: Posting field names244934
Ref: #posting-field-names244703 Ref: #posting-field-names245088
Node: field assignment247064 Node: field assignment247449
Ref: #field-assignment247209 Ref: #field-assignment247594
Node: separator248023 Node: separator248408
Ref: #separator248160 Ref: #separator248545
Node: if block248702 Node: if block249087
Ref: #if-block248829 Ref: #if-block249214
Node: Matching the whole record249227 Node: Matching the whole record249612
Ref: #matching-the-whole-record249404 Ref: #matching-the-whole-record249789
Node: Matching individual fields250207 Node: Matching individual fields250592
Ref: #matching-individual-fields250413 Ref: #matching-individual-fields250798
Node: Combining matchers250637 Node: Combining matchers251022
Ref: #combining-matchers250835 Ref: #combining-matchers251220
Node: Rules applied on successful match251149 Node: Rules applied on successful match251534
Ref: #rules-applied-on-successful-match251342 Ref: #rules-applied-on-successful-match251727
Node: if table251999 Node: if table252384
Ref: #if-table252120 Ref: #if-table252505
Node: end253856 Node: end254241
Ref: #end253970 Ref: #end254355
Node: date-format254194 Node: date-format254579
Ref: #date-format254328 Ref: #date-format254713
Node: decimal-mark255078 Node: decimal-mark255463
Ref: #decimal-mark255223 Ref: #decimal-mark255608
Node: newest-first255560 Node: newest-first255945
Ref: #newest-first255703 Ref: #newest-first256088
Node: include256386 Node: include256771
Ref: #include256519 Ref: #include256904
Node: balance-type256961 Node: balance-type257346
Ref: #balance-type257083 Ref: #balance-type257468
Node: Tips257783 Node: Tips258168
Ref: #tips257874 Ref: #tips258259
Node: Rapid feedback258173 Node: Rapid feedback258558
Ref: #rapid-feedback258292 Ref: #rapid-feedback258677
Node: Valid CSV258751 Node: Valid CSV259136
Ref: #valid-csv258883 Ref: #valid-csv259268
Node: File Extension259075 Node: File Extension259460
Ref: #file-extension259229 Ref: #file-extension259614
Node: Reading multiple CSV files259658 Node: Reading multiple CSV files260043
Ref: #reading-multiple-csv-files259845 Ref: #reading-multiple-csv-files260230
Node: Valid transactions260085 Node: Valid transactions260470
Ref: #valid-transactions260265 Ref: #valid-transactions260650
Node: Deduplicating importing260893 Node: Deduplicating importing261278
Ref: #deduplicating-importing261074 Ref: #deduplicating-importing261459
Node: Setting amounts262106 Node: Setting amounts262491
Ref: #setting-amounts262263 Ref: #setting-amounts262648
Node: Amount signs264482 Node: Amount signs264867
Ref: #amount-signs264636 Ref: #amount-signs265021
Node: Setting currency/commodity265323 Node: Setting currency/commodity265708
Ref: #setting-currencycommodity265511 Ref: #setting-currencycommodity265896
Node: Amount decimal places266691 Node: Amount decimal places267076
Ref: #amount-decimal-places266883 Ref: #amount-decimal-places267268
Node: Referencing other fields267195 Node: Referencing other fields267580
Ref: #referencing-other-fields267394 Ref: #referencing-other-fields267779
Node: How CSV rules are evaluated268292 Node: How CSV rules are evaluated268677
Ref: #how-csv-rules-are-evaluated268467 Ref: #how-csv-rules-are-evaluated268852
Node: TIMECLOCK FORMAT269916 Node: TIMECLOCK FORMAT270301
Ref: #timeclock-format270056 Ref: #timeclock-format270441
Node: TIMEDOT FORMAT272124 Node: TIMEDOT FORMAT272509
Ref: #timedot-format272262 Ref: #timedot-format272647
Node: COMMON TASKS276525 Node: COMMON TASKS276910
Ref: #common-tasks276654 Ref: #common-tasks277039
Node: Getting help277061 Node: Getting help277446
Ref: #getting-help277195 Ref: #getting-help277580
Node: Constructing command lines277746 Node: Constructing command lines278131
Ref: #constructing-command-lines277940 Ref: #constructing-command-lines278325
Node: Starting a journal file278639 Node: Starting a journal file279024
Ref: #starting-a-journal-file278839 Ref: #starting-a-journal-file279224
Node: Setting opening balances280026 Node: Setting opening balances280411
Ref: #setting-opening-balances280224 Ref: #setting-opening-balances280609
Node: Recording transactions283357 Node: Recording transactions283742
Ref: #recording-transactions283539 Ref: #recording-transactions283924
Node: Reconciling284096 Node: Reconciling284481
Ref: #reconciling284241 Ref: #reconciling284626
Node: Reporting286486 Node: Reporting286871
Ref: #reporting286628 Ref: #reporting287013
Node: Migrating to a new file290548 Node: Migrating to a new file290933
Ref: #migrating-to-a-new-file290698 Ref: #migrating-to-a-new-file291083
Node: LIMITATIONS290996 Node: LIMITATIONS291381
Ref: #limitations291124 Ref: #limitations291509
Node: TROUBLESHOOTING291865 Node: TROUBLESHOOTING292250
Ref: #troubleshooting291980 Ref: #troubleshooting292365
 
End Tag Table End Tag Table

View File

@ -105,10 +105,12 @@ OPTIONS
General reporting options: General reporting options:
-b --begin=DATE -b --begin=DATE
include postings/txns on or after this date include postings/txns on or after this date (will be adjusted to
preceding subperiod start when using a report interval)
-e --end=DATE -e --end=DATE
include postings/txns before this date include postings/txns before this date (will be adjusted to fol-
lowing subperiod end when using a report interval)
-D --daily -D --daily
multiperiod/multicolumn report by day multiperiod/multicolumn report by day
@ -559,15 +561,18 @@ TIME PERIODS
date:2019-01 date:2019 -p'2000 to 2030' yields January 2019, the date:2019-01 date:2019 -p'2000 to 2030' yields January 2019, the
smallest common time span. smallest common time span.
o A report interval (see below) will adjust start/end dates, when
needed, so that they fall on subperiod boundaries.
Examples: Examples:
-b 2016/3/17 begin on St. Patrick's day 2016 -b 2016/3/17 begin on St. Patrick's day 2016
-e 12/1 end at the start of december 1st of the current year -e 12/1 end at the start of december 1st of the current year
(11/30 will be the last date included) (11/30 will be the last date included)
-b thismonth all transactions on or after the 1st of the current month -b thismonth all transactions on or after the 1st of the current month
-p thismonth all transactions in the current month -p thismonth all transactions in the current month
date:2016/3/17.. the above written as queries instead (.. can also be date:2016/3/17.. the above written as queries instead (.. can also be
replaced with -) replaced with -)
date:..12/1 date:..12/1
date:thismonth.. date:thismonth..
@ -583,37 +588,37 @@ TIME PERIODS
-D/--daily, -W/--weekly, -M/--monthly, -Q/--quarterly, -Y/--yearly. -D/--daily, -W/--weekly, -M/--monthly, -Q/--quarterly, -Y/--yearly.
These standard intervals always start on natural interval boundaries: These standard intervals always start on natural interval boundaries:
eg --weekly starts on mondays, --monthly starts on the first of the eg --weekly starts on mondays, --monthly starts on the first of the
month, --yearly always starts on January 1st, etc. month, --yearly always starts on January 1st, etc.
Certain more complex intervals, and more flexible boundary dates, can Certain more complex intervals, and more flexible boundary dates, can
be specified by -p/--period. These are described in period expres- be specified by -p/--period. These are described in period expres-
sions, below. sions, below.
Report intervals can only be specified by the flags above, and not by Report intervals can only be specified by the flags above, and not by
query arguments, currently. query arguments, currently.
Report intervals have another effect: multi-period reports are always Report intervals have another effect: multi-period reports are always
expanded to fill a whole number of subperiods. So if you use a report expanded to fill a whole number of subperiods. So if you use a report
interval (other than --daily), and you have specified a start or end interval (other than --daily), and you have specified a start or end
date, you may notice those dates being overridden (ie, the report date, you may notice those dates being overridden (ie, the report
starts earlier than your requested start date, or ends later than your starts earlier than your requested start date, or ends later than your
requested end date). This is done to ensure "full" first and last sub- requested end date). This is done to ensure "full" first and last sub-
periods, so that all subperiods' numbers are comparable. periods, so that all subperiods' numbers are comparable.
Period expressions Period expressions
The -p/--period option accepts period expressions, a shorthand way of The -p/--period option accepts period expressions, a shorthand way of
expressing a start date, end date, and/or report interval all at once. expressing a start date, end date, and/or report interval all at once.
Here's a basic period expression specifying the first quarter of 2009. Here's a basic period expression specifying the first quarter of 2009.
Note, hledger always treats start dates as inclusive and end dates as Note, hledger always treats start dates as inclusive and end dates as
exclusive: exclusive:
-p "from 2009/1/1 to 2009/4/1" -p "from 2009/1/1 to 2009/4/1"
Keywords like "from" and "to" are optional, and so are the spaces, as Keywords like "from" and "to" are optional, and so are the spaces, as
long as you don't run two dates together. "to" can also be written as long as you don't run two dates together. "to" can also be written as
".." or "-". These are equivalent to the above: ".." or "-". These are equivalent to the above:
@ -621,10 +626,11 @@ TIME PERIODS
-p2009/1/1to2009/4/1 -p2009/1/1to2009/4/1
-p2009/1/1..2009/4/1 -p2009/1/1..2009/4/1
Dates are smart dates, so if the current year is 2009, the above can Dates are smart dates, so if the current year is 2009, the above can
also be written as: also be written as:
-p "1/1 4/1" -p "1/1 4/1"
-p "january-apr" -p "january-apr"
-p "this year to 4/1" -p "this year to 4/1"
@ -637,34 +643,34 @@ TIME PERIODS
1, 2009 1, 2009
-p "from 2009/1" the same -p "from 2009/1" the same
-p "from 2009" the same -p "from 2009" the same
-p "to 2009" everything before january -p "to 2009" everything before january
1, 2009 1, 2009
A single date with no "from" or "to" defines both the start and end A single date with no "from" or "to" defines both the start and end
date like so: date like so:
-p "2009" the year 2009; equivalent -p "2009" the year 2009; equivalent
to "2009/1/1 to 2010/1/1" to "2009/1/1 to 2010/1/1"
-p "2009/1" the month of jan; equiva- -p "2009/1" the month of jan; equiva-
lent to "2009/1/1 to lent to "2009/1/1 to
2009/2/1" 2009/2/1"
-p "2009/1/1" just that day; equivalent -p "2009/1/1" just that day; equivalent
to "2009/1/1 to 2009/1/2" to "2009/1/1 to 2009/1/2"
Or you can specify a single quarter like so: Or you can specify a single quarter like so:
-p "2009Q1" first quarter of 2009, -p "2009Q1" first quarter of 2009,
equivalent to "2009/1/1 to equivalent to "2009/1/1 to
2009/4/1" 2009/4/1"
-p "q4" fourth quarter of the cur- -p "q4" fourth quarter of the cur-
rent year rent year
The argument of -p can also begin with, or be, a report interval The argument of -p can also begin with, or be, a report interval
expression. The basic report intervals are daily, weekly, monthly, expression. The basic report intervals are daily, weekly, monthly,
quarterly, or yearly, which have the same effect as the -D,-W,-M,-Q, or quarterly, or yearly, which have the same effect as the -D,-W,-M,-Q, or
-Y flags. Between report interval and start/end dates (if any), the -Y flags. Between report interval and start/end dates (if any), the
word in is optional. Examples: word in is optional. Examples:
@ -672,45 +678,45 @@ TIME PERIODS
-p "monthly in 2008" -p "monthly in 2008"
-p "quarterly" -p "quarterly"
Note that weekly, monthly, quarterly and yearly intervals will always Note that weekly, monthly, quarterly and yearly intervals will always
start on the first day on week, month, quarter or year accordingly, and start on the first day on week, month, quarter or year accordingly, and
will end on the last day of same period, even if associated period will end on the last day of same period, even if associated period
expression specifies different explicit start and end date. expression specifies different explicit start and end date.
For example: For example:
-p "weekly from 2009/1/1 starts on 2008/12/29, closest preceding Mon- -p "weekly from 2009/1/1 starts on 2008/12/29, closest preceding Mon-
to 2009/4/1" day to 2009/4/1" day
-p "monthly in starts on 2018/11/01 -p "monthly in starts on 2018/11/01
2008/11/25" 2008/11/25"
-p "quarterly from starts on 2009/04/01, ends on 2009/06/30, -p "quarterly from starts on 2009/04/01, ends on 2009/06/30,
2009-05-05 to 2009-06-01" which are first and last days of Q2 2009 2009-05-05 to 2009-06-01" which are first and last days of Q2 2009
-p "yearly from starts on 2009/01/01, first day of 2009 -p "yearly from starts on 2009/01/01, first day of 2009
2009-12-29" 2009-12-29"
The following more complex report intervals are also supported: The following more complex report intervals are also supported:
biweekly, fortnightly, bimonthly, every day|week|month|quarter|year, biweekly, fortnightly, bimonthly, every day|week|month|quarter|year,
every N days|weeks|months|quarters|years. every N days|weeks|months|quarters|years.
All of these will start on the first day of the requested period and All of these will start on the first day of the requested period and
end on the last one, as described above. end on the last one, as described above.
Examples: Examples:
-p "bimonthly from 2008" periods will have boundaries on 2008/01/01, -p "bimonthly from 2008" periods will have boundaries on 2008/01/01,
2008/03/01, ... 2008/03/01, ...
-p "every 2 weeks" starts on closest preceding Monday -p "every 2 weeks" starts on closest preceding Monday
-p "every 5 month from periods will have boundaries on 2009/03/01, -p "every 5 month from periods will have boundaries on 2009/03/01,
2009/03" 2009/08/01, ... 2009/03" 2009/08/01, ...
If you want intervals that start on arbitrary day of your choosing and If you want intervals that start on arbitrary day of your choosing and
span a week, month or year, you need to use any of the following: span a week, month or year, you need to use any of the following:
every Nth day of week, every WEEKDAYNAME (eg every Nth day of week, every WEEKDAYNAME (eg
mon|tue|wed|thu|fri|sat|sun), every Nth day [of month], every Nth WEEK- mon|tue|wed|thu|fri|sat|sun), every Nth day [of month], every Nth WEEK-
DAYNAME [of month], every MM/DD [of year], every Nth MMM [of year], DAYNAME [of month], every MM/DD [of year], every Nth MMM [of year],
every MMM Nth [of year]. every MMM Nth [of year].
Examples: Examples:
@ -719,42 +725,42 @@ TIME PERIODS
-p "every 2nd day of periods will go from Tue to Tue -p "every 2nd day of periods will go from Tue to Tue
week" week"
-p "every Tue" same -p "every Tue" same
-p "every 15th day" period boundaries will be on 15th of each -p "every 15th day" period boundaries will be on 15th of each
month month
-p "every 2nd Monday" period boundaries will be on second Monday of -p "every 2nd Monday" period boundaries will be on second Monday of
each month each month
-p "every 11/05" yearly periods with boundaries on 5th of Nov -p "every 11/05" yearly periods with boundaries on 5th of Nov
-p "every 5th Nov" same -p "every 5th Nov" same
-p "every Nov 5th" same -p "every Nov 5th" same
Show historical balances at end of 15th each month (N is exclusive end Show historical balances at end of 15th each month (N is exclusive end
date): date):
hledger balance -H -p "every 16th day" hledger balance -H -p "every 16th day"
Group postings from start of wednesday to end of next tuesday (N is Group postings from start of wednesday to end of next tuesday (N is
start date and exclusive end date): start date and exclusive end date):
hledger register checking -p "every 3rd day of week" hledger register checking -p "every 3rd day of week"
DEPTH DEPTH
With the --depth N option (short form: -N), commands like account, bal- With the --depth N option (short form: -N), commands like account, bal-
ance and register will show only the uppermost accounts in the account ance and register will show only the uppermost accounts in the account
tree, down to level N. Use this when you want a summary with less tree, down to level N. Use this when you want a summary with less
detail. This flag has the same effect as a depth: query argument (so detail. This flag has the same effect as a depth: query argument (so
-2, --depth=2 or depth:2 are equivalent). -2, --depth=2 or depth:2 are equivalent).
QUERIES QUERIES
One of hledger's strengths is being able to quickly report on precise One of hledger's strengths is being able to quickly report on precise
subsets of your data. Most commands accept an optional query expres- subsets of your data. Most commands accept an optional query expres-
sion, written as arguments after the command name, to filter the data sion, written as arguments after the command name, to filter the data
by date, account name or other criteria. The syntax is similar to a by date, account name or other criteria. The syntax is similar to a
web search: one or more space-separated search terms, quotes to enclose web search: one or more space-separated search terms, quotes to enclose
whitespace, prefixes to match specific fields, a not: prefix to negate whitespace, prefixes to match specific fields, a not: prefix to negate
the match. the match.
We do not yet support arbitrary boolean combinations of search terms; We do not yet support arbitrary boolean combinations of search terms;
instead most commands show transactions/postings/accounts which match instead most commands show transactions/postings/accounts which match
(or negatively match): (or negatively match):
o any of the description terms AND o any of the description terms AND
@ -775,31 +781,31 @@ QUERIES
o match all the other terms. o match all the other terms.
The following kinds of search terms can be used. Remember these can The following kinds of search terms can be used. Remember these can
also be prefixed with not:, eg to exclude a particular subaccount. also be prefixed with not:, eg to exclude a particular subaccount.
REGEX, acct:REGEX REGEX, acct:REGEX
match account names by this regular expression. (With no pre- match account names by this regular expression. (With no pre-
fix, acct: is assumed.) same as above fix, acct: is assumed.) same as above
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 that is equal to, match postings with a single-commodity amount that is equal to,
less than, or greater than N. (Multi-commodity amounts are not less than, or greater than N. (Multi-commodity amounts are not
tested, and will always match.) The comparison has two modes: if tested, and will always match.) The comparison has two modes: if
N is preceded by a + or - sign (or is 0), the two signed numbers N is preceded by a + or - sign (or is 0), the two signed numbers
are compared. Otherwise, the absolute magnitudes are compared, are compared. Otherwise, the absolute magnitudes are compared,
ignoring sign. ignoring sign.
code:REGEX code:REGEX
match by transaction code (eg check number) match by transaction code (eg check number)
cur:REGEX cur:REGEX
match postings or transactions including any amounts whose cur- match postings or transactions including any amounts whose cur-
rency/commodity symbol is fully matched by REGEX. (For a par- rency/commodity symbol is fully matched by REGEX. (For a par-
tial match, use .*REGEX.*). Note, to match characters which are tial match, use .*REGEX.*). Note, to match characters which are
regex-significant, like the dollar sign ($), you need to prepend regex-significant, like the dollar sign ($), you need to prepend
\. And when using the command line you need to add one more \. And when using the command line you need to add one more
level of quoting to hide it from the shell, so eg do: hledger level of quoting to hide it from the shell, so eg do: hledger
print cur:'\$' or hledger print cur:\\$. print cur:'\$' or hledger print cur:\\$.
desc:REGEX desc:REGEX
@ -807,10 +813,11 @@ QUERIES
date:PERIODEXPR date:PERIODEXPR
match dates within the specified period. PERIODEXPR is a period match dates within the specified period. PERIODEXPR is a period
expression (with no report interval). Examples: date:2016, expression (with no report interval). Examples: date:2016,
date:thismonth, date:2000/2/1-2/15, date:lastweek-. If the date:thismonth, date:2000/2/1-2/15, date:lastweek-. If the
--date2 command line flag is present, this matches secondary --date2 command line flag is present, this matches secondary
dates instead. dates instead. (Report intervals will adjust start/end dates to
preceding/following subperiod boundaries.)
date2:PERIODEXPR date2:PERIODEXPR
match secondary dates within the specified period. match secondary dates within the specified period.
@ -1196,6 +1203,8 @@ VALUATION
or today of journal end sums of post- or today of journal end sums of post-
sums of of sums of ings sums of of sums of ings
postings postings postings postings
budget like balance like balance like balance like bal- like balance budget like balance like balance like balance like bal- like balance
amounts changes changes changes ances changes amounts changes changes changes ances changes
(--budget) (--budget)
@ -1218,12 +1227,6 @@ VALUATION
is, bs postings in period at respec- each period, sums of post- is, bs postings in period at respec- each period, sums of post-
--change, cf period tive posting valued at ings --change, cf period tive posting valued at ings
--change) dates period ends --change) dates period ends
end balances sums of same as sums of values of period end value at end balances sums of same as sums of values of period end value at
(bal -H, is costs of --value=end postings from balances, DATE/today of (bal -H, is costs of --value=end postings from balances, DATE/today of
--H, bs, cf) postings before period valued at sums of post- --H, bs, cf) postings before period valued at sums of post-
@ -4405,11 +4408,6 @@ JOURNAL FORMAT
ment until end of cur- ment until end of cur-
rent file or end rent file or end
directive directive
commod- format declare a commodity and its number notation: commod- format declare a commodity and its number notation:
ity number notation & display following entries ity number notation & display following entries
style in that commodity style in that commodity