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

;doc:areg,ui: note how separately-dated postings get combined

Browse Source
This commit is contained in:
Simon Michael 2023-10-19 09:50:50 +01:00
parent 8bfde51ae8
commit 7970ce7434
2 changed files with 19 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
hledger-ui/hledger-ui.m4.md
View File

@ -266,6 +266,12 @@ Each line represents one transaction, and shows:
- or the historical total, which includes any undisplayed transactions before the start of the report period (and matching the filter query if any). - or the historical total, which includes any undisplayed transactions before the start of the report period (and matching the filter query if any).
This will be the running historical balance (what you would see on a bank's website, eg) if not disturbed by a query. This will be the running historical balance (what you would see on a bank's website, eg) if not disturbed by a query.
Note, this screen combines each transaction's in-period postings to a
single line item, dated with the earliest in-period transaction or
posting date (like hledger's `aregister`). So custom posting dates can
cause the running balance to be temporarily inaccurate.
(See [hledger manual > aregister and posting dates](hledger.md#aregister-and-posting-dates).)
Transactions affecting this account's subaccounts will be included in the register Transactions affecting this account's subaccounts will be included in the register
if the accounts screen is in tree mode, if the accounts screen is in tree mode,
or if it's in list mode but this account has subaccounts which are not shown due to a depth limit. or if it's in list mode but this account has subaccounts which are not shown due to a depth limit.

23
hledger/Hledger/Cli/Commands/Aregister.md
View File

@ -64,16 +64,19 @@ This command also supports the
[output format](hledger.html#output-format) options. [output format](hledger.html#output-format) options.
The output formats supported are `txt`, `csv`, and `json`. The output formats supported are `txt`, `csv`, and `json`.
### aregister and custom posting dates ### aregister and posting dates
Transactions whose date is outside the report period can still be aregister always shows one line (and date and amount) per transaction.
shown, if they have a posting to this account dated inside the report But sometimes transactions have postings with different dates. Also,
period. (And in this case it's the posting date that is shown.) not all of a transaction's postings may be within the report period.
This ensures that `aregister` can show an accurate historical running To resolve this, aregister shows the earliest of the transaction's
balance, matching the one shown by `register -H` with the same date and posting dates that is in-period, and the sum of the in-period
arguments. postings. In other words it will show a combined line item with just
the earliest date, and the running balance will (temporarily, until
the transaction's last posting) be inaccurate. Use `register -H` if
you need to see the individual postings.
To filter strictly by transaction date instead, add the `--txn-dates` There is also a `--txn-dates` flag, which filters strictly by
flag. If you use this flag and some of your postings have custom transaction date, ignoring posting dates. This too can cause an
dates, it's probably best to assume the running balance is wrong. inaccurate running balance.