Files
cheatsheet-tldr/tldr/hledger-balance
2025-04-23 00:19:06 +00:00

43 lines
1.8 KiB
Plaintext

---
syntax: markdown
tags: [tldr, common]
source: https://github.com/tldr-pages/tldr.git
---
# hledger balance
> A flexible, general purpose "summing" report that shows accounts with some kind of numeric data.
> This can be balance changes per period, end balances, budget performance, unrealised capital gains, etc.
> More information: <https://hledger.org/hledger.html#balance>.
- Show the balance change in all accounts from all postings over all time:
`hledger {{[bal|balance]}}`
- Show the balance change in accounts named `*expenses*`, as a tree, summarising the top two levels only:
`hledger {{[bal|balance]}} {{expenses}} {{[-t|--tree]}} --depth {{2}}`
- Show expenses each month, and their totals and averages, sorted by total; and their monthly budget goals:
`hledger {{[bal|balance]}} {{expenses}} {{[-M|--monthly]}} {{[-T|--row-total]}} {{[-A|--average]}} {{[-S|--sort-amount]}} --budget`
- Similar to the above, shorter form, matching accounts by `Expense` type, as a two level tree without squashing boring accounts:
`hledger bal type:{{X}} -MTAS --budget -t -{{2}} --no-elide`
- Show end balances (including from postings before the start date), quarterly in 2024, in accounts named `*assets*` or `*liabilities*`:
`hledger {{[bal|balance]}} {{[-H|--historical]}} {{[-p|--period]}} '{{quarterly in 2024}}' {{assets}} {{liabilities}}`
- Similar to the above, shorter form; also show zero balances, sort by total and summarise to three levels:
`hledger bal -HQ date:{{2024}} type:{{AL}} -ES -{{3}}`
- Show investment assets' market value in base currency at the end of each quarter:
`hledger bal -HVQ {{assets:investments}}`
- Show unrealised capital gains/losses from market price changes in each quarter, for non-cryptocurrency investment assets:
`hledger bal --gain -Q {{assets:investments}} not:{{cryptocurrency}}`