;doc:journal: clarify valuation date, note bug #2084

This commit is contained in:
Simon Michael 2023-09-11 10:10:49 +01:00
parent b6325e067e
commit 4a2da0ba1b

View File

@ -5207,16 +5207,20 @@ currency you want to convert to, and it tries to convert everything to that.
## Valuation date ## Valuation date
Since market prices can change from day to day, market value reports Market prices can change from day to day.
have a valuation date (or more than one), which determines which hledger will use the prices on a particular valuation date (or on more than one date).
market prices will be used. By default hledger uses "end" dates for valuation. More specifically:
For single period reports, if an explicit - For single period reports (including normal print and register reports):
[report end date](#report-start-end-date) is specified, that will be - If an explicit [report end date](#report-start-end-date) is specified, that is used
used as the valuation date; otherwise the valuation date is the journal's end date. - Otherwise the latest transaction date or P directive date is used (even if it's in the future)
For [multiperiod reports](#report-intervals), each column/period is - For [multiperiod reports](#report-intervals), each period is valued on its last day.
valued on the last day of the period, by default.
This can be customised with the --value option described below,
which can select either "then", "end", "now", or "custom" dates.
(Note, this has a bug in hledger-ui <=1.31: turning on valuation with
the `V` key always resets it to "end".)
## Finding market price ## Finding market price