hledger 命令

常用示例

说明

hledger is a plain text accounting tool that reads journal files and produces financial reports. It implements double-entry accounting, where every transaction must balance (debits equal credits). The default journal file is ~/.hledger.journal or the file specified by the LEDGER_FILE environment variable. Journal entries consist of a date, description, and two or more postings (account name and amount). The tool supports multiple currencies, commodity prices, periodic transactions, and CSV import rules. Reports can be filtered by date range, account name patterns, and description queries. Multi-period reports (--monthly, --quarterly) show changes over time for trend analysis.

参数

balance, bal

Show account balances.

register, reg

Show transaction register with running total.

print

Print journal entries in standard format.

add

Add a transaction interactively.

incomestatement, is

Show income statement (revenues and expenses).

balancesheet, bs

Show balance sheet (assets, liabilities, equity).

cashflow, cf

Show cash flow statement.

accounts

List account names.

stats

Show journal statistics.

import

Import new transactions from CSV or other files.

-f _FILE_

Read this journal file instead of the default ($LEDGER_FILE or ~/.hledger.journal).

-b _DATE_

Begin date (include transactions on or after this date).

-e _DATE_

End date (include transactions before this date).

-p _PERIOD_

Period expression (e.g., "monthly", "quarterly", "2024").

--monthly, --quarterly, --yearly

Show amounts per time period.

--depth _N_

Limit account display depth.

--cost, -B

Convert to cost using transaction prices.

--market, -V

Convert to market value using market prices.

--output-format _FMT_

Output format: txt, csv, json, html.

--help

Display help information.