hledger/hledger/Hledger/Cli/Commands/Incomestatement.md
2020-12-22 09:22:10 -08:00

57 lines
1.6 KiB
Markdown

incomestatement, is\
This command displays an
[income statement](http://en.wikipedia.org/wiki/Income_statement),
showing revenues and expenses during one or more periods.
Amounts are shown with normal positive sign, as in conventional
financial statements.
_FLAGS
The revenue and expense accounts shown are those accounts declared
with the `Revenue` or `Expense` type, or otherwise all accounts under
a top-level `revenue` or `income` or `expense` account (case
insensitive, plurals allowed).
(This report is essentially similar to
"hledger balance --change revenues expenses",
with revenues sign-flipped.)
Example:
```shell
$ hledger incomestatement
Income Statement
Revenues:
$-2 income
$-1 gifts
$-1 salary
--------------------
$-2
Expenses:
$2 expenses
$1 food
$1 supplies
--------------------
$2
Total:
--------------------
0
```
With a [reporting interval](#reporting-interval), multiple columns
will be shown, one for each report period.
Normally incomestatement shows revenues/expenses per period, though
as with [multicolumn balance reports](#multicolumn-balance-reports)
you can alter the report mode with `--change`/`--cumulative`/`--historical`.
Instead of absolute values [percentages](#percentages) can be displayed
with `-%`.
This command also supports the
[output destination](hledger.html#output-destination) and
[output format](hledger.html#output-format) options
The output formats supported are
`txt`, `csv`, `html`, and (experimental) `json`.