Info
hledger is friendly, fast, and dependable accounting software for tracking money, investments, cryptocurrencies, time, or any countable commodity. It uses human-readable plain text data that you control.
hledger manual (1.51) » Journal
hledger’s usual data source is a plain text file containing journal entries in hledger
journalformat.
1 | brew install hledger |
基本使用
bal / balance
A flexible, general purpose “summing” report that shows accounts with some kind of numeric data.
例行核对。检查每笔 transition 以及 balance assertions。
1 | hledger bal [-f xxx.journal] |
reg / register
Show postings and their running total.
如果某个账户余额核对出错，可以列出其相关交易以便排查：
1 | hledger reg [-f xxx.journal] -I 'Assets:Online:WeChat$' cur:CNY |
check
Check for various kinds of errors in your data.
检查 transactions 是按日期有序排列的：
1 | hledger check ordereddates [-f xxx.journal] |
areg / aregister
Show the transactions and running balances in one account, with each transaction on one line.
aregisteris best when reconciling real-world asset/liability accountsregisteris best when reviewing individual revenues/expenses.
用接近与银行流水单的形式，列出某个账户的交易和 running balances 历史：
1 | hledger areg [-f xxx.journal] 'Assets:Checking:ICBC' |
好像不能像 register 那样通过 $ exclude sub-accounts。
Show full journal entries, representing transactions.
打印 transactions，补全空缺的金额：
1 | hledger print [-f xxx.journal] -x 'Assets:XXX' |
更新注意
1.50 - Transaction Balancing
Transaction balancing is now done in a more robust way, using local precisions only (like Ledger) #2402. Until now, a transaction was required to balance using its commodities’s global display precisions. Small imbalances were tolerated by configuring display precisions for the whole journal (with
commoditydirectives).
比如这条 transaction 在 1.50+ 就不行：
1 | 339 | 2013-01-30 计算持仓均价 |
因为后两条的总额相当于 37.4725 CNY，除以 6 无法除尽，@ 6.2454167 CNY 无论保留多少位都没办法。
对于这种场景，直接不做这种均价化的处理了（至少不在除不尽的时候做），缺点是要自己管理「先入先出」。
另一种情况：
1 | 292 | 2024-02-01 饮料 |
这里的误差就没法避免了，因为银行在记账的时候做了舍入处理。考虑引入特殊的 account 来 absorb the imbalance：
1 | 2024-02-01 饮料 |
如果前两行的 @ UNITPRICE 都没有问题，也可以省略 Expenses:Misc:Rounding 的金额，让 hledger 自动计算。
或者使用 @@ TOTALPRICE 语法，避开除不尽的 @ UNITPRICE：
1 | 2024-02-01 饮料 |
实践
按年拆分 Journal
一年一个 Journal 文件，日常只处理当年的文件，需要的时候可以把连续若干年的文件「连」起来一并处理。
用 hledger close 命令生成 closing 文件和 opening 文件。
设起始年是 2000 年，记录于 2000.journal 文件。在 2000 年结束后，运行：
1 | hledger close -f 2000.journal \ |
👆
Assets Liabilities是默认会带到 closing 或 opening 的 accounts，可以指定任何 accounts。
生成 2000 年的 closing journal 和 2001 年的 opening journal：
1 | 2000-12-31 closing balances ; clopen:2001 |
1 | 2001-01-01 opening balances ; clopen:2001 |
在 2001.journal 开头 include 其 opening journal：
1 | include share/commodities.journal |
可以创建一个文件，比如叫作 active.journal：
1 | include share/accounts.journal |
可以设定环境变量 LEDGER_FILE 的值为此文件的路径，那么执行 hledger 命令时就默认使用这个文件。
如果想把所有年份的 journal 放在一起处理，可以创建一个文件，比如 all.journal：
1 | include share/accounts.journal |
股票类交易记账
Track investments (2020) - hledger
主要的问题是多次买卖过程中的 存货估价法。常见的方法有先进先出（FIFO）、后进先出（LIFO）、加权平均（Weighted Average Cost），参见 FIFO vs. LIFO vs Average Cost Method。
考虑对于非高频交易使用 FIFO（加权平均要处理舍入误差）。每次买入都放进一个单独的 sub-account，以便追踪和核验。
例子：
1 | 2013-01-28 买入 |
Caution
Balance assertion 的时候要带单位（如 = 0 XAGg）。只写 = 0 可能会被解读为 = 0.00 CNY（CNY 是默认币种），在此例中恒为真，失去了 assertion 应有的效果。
