账户
open 指令创建一个账户,并让它从指令的日期起可以使用。close 指令结束它的使用。交易记账的每个账户都必须先开立。
YYYY-MM-DD [HH:MM[:SS]] open <Account> [<Commodity>[, <Commodity> …]] [<key>: <value>]YYYY-MM-DD [HH:MM[:SS]] close <Account>| 部分 | 必填 | 说明 |
|---|---|---|
| 日期和时间 | 是 | 账户开立或关闭的时间,可以附带一天中的时刻。 |
<Account> |
是 | 账户名,例如 Assets:Bank:Checking。 |
<Commodity>, … |
否 | 这个账户只能持有的商品,用逗号分隔。每种商品都必须已经定义。不写则允许任何商品。 |
<key>: <value> |
否 | 元数据行。张记账读取的键见元数据。 |
账户名以五种账户类型之一开头:Assets、Liabilities、Equity、Income 或 Expenses,后面跟一个或多个用 : 分隔的部分。每个部分可以是任何不含空格、引号、冒号、括号或逗号的文本,所以 Expenses:Food:餐饮 是有效的账户名。
2024-01-01 commodity USD2024-01-01 budget Food CNY
2024-01-01 open Assets:Bank:Checking CNY alias: "Main checking"2024-01-01 open Assets:Broker USD booking_method: "STRICT"2024-01-01 open Expenses:Food CNY budget: Food2024-01-01 open Equity:Opening-Balances
2024-12-31 close Assets:Broker| 键 | 作用 |
|---|---|
alias |
账户的显示名称。账户列表显示这个名称,并在它下方显示账户的全名。 |
booking_method |
账户的记账方法,见记账方法。 |
budget |
把账户关联到一个预算:它的记账行计入该预算的支出。重复这个键可以关联多个预算。 |
其他元数据会被保留。在查询中,#accounts 以 open.meta 给出 open 指令的元数据。
记账方法决定减仓(例如 -5 AAPL {})从哪个批次中扣除数量。没有这项元数据时,账户使用 default_booking_method 选项(未设置时为 FIFO)。
与 Beancount 相同,减仓匹配其成本所指定的批次,成本中没有写出的部分可以匹配任何值:{100 USD} 匹配所有以 100 USD 持有的批次,不论取得日期;{100 USD, 2024-01-01} 只匹配在该日取得的批次;{} 匹配所有按成本持有的批次。批次的取得日期是其成本中写明的日期,否则是建立该批次的交易的日期。
STRICT:Beancount 的默认方法。减仓必须只匹配一个批次,或者把匹配到的每个批次全部减完。否则账本报告AmbiguousLotMatch错误,并在匹配的批次中按FIFO记账。FIFO:先进先出,先减取得日期最早的匹配批次。LIFO:后进先出,先减取得日期最晚的匹配批次。
AVERAGE、AVERAGE_ONLY 和 NONE 尚未实现。使用其中之一的账户,或者值不是记账方法的账户,会在其 open 指令上得到一个错误(UnsupportedBookingMethod 或 ParseInvalidMeta),并按默认的记账方法记账。账本仍然可以加载。批次的用法见批次与成本。
账户何时可用
Section titled “账户何时可用”账户是否可用由同一条规则决定,所有使用账户的指令和网页界面都遵循它:
- 账户从
open起可用。在同一日期和时间内,open排在其他所有指令之前,所以open当天的交易没有问题。 - 账户在
close生效之前一直可用。只有日期的close在当天结束(24:00)时关闭账户,所以当天的所有指令都还可以使用它。在 zhang 文件中,带时间的close在该时刻关闭账户:正好在该时刻的指令还可以使用它,当天更晚的指令则不行。在 Beancount 文件中,与 Beancount 一样,close的time元数据只是普通元数据:账户在当天全天仍可使用。 - 在
close之后再写open会重新开立账户。 - 指令使用了从未开立、或者开立时间更晚的账户,会报告
AccountDoesNotExist。 - 在账户关闭之后记账,会报告
AccountClosed:记账行、pad或balance … with pad。 - 只做记录的指令可以出现在
close之后,与 Beancount 一样:普通的balance(例如断言已关闭的账户余额为零)、document(例如最后一期对账单)和note。 - 每个错误对每个账户和指令各报告一次,指令仍然有效:交易仍会记账,文档仍会列出。
- 开立一个账户不会开立它的父账户。不开立
Assets:Bank也可以使用Assets:Bank:Checking,但对Assets:Bank的余额断言需要Assets:Bank已经开立。
2024-01-01 open Assets:Wallet2024-03-31 close Assets:Wallet2024-03-31 18:00 * "Last coffee" ; 没有问题:账户在 3 月 31 日当天仍可用 Assets:Wallet -3 CNY Expenses:Coffee2024-04-01 * "Too late" ; AccountClosed Assets:Wallet -3 CNY Expenses:Coffee2024-04-02 balance Assets:Wallet -6 CNY ; 没有问题:余额断言只做记录账户列表按账本时钟,从账户的 close 生效的那一刻起把它显示为已关闭,在之后的 open 之后又显示为开立。按同一条规则,新建交易表单提供在交易的日期和时间处于开立状态的账户,余额工具提供当前开立的账户。被编辑的交易已经使用的账户仍会留在它的列表中。文档上传提供当前已经开立过的所有账户,包括已关闭的账户,因为文档可以出现在关闭之后。
open 中列出的商品必须在它之前定义;未定义的商品会在 open 上报告 CommodityDoesNotDefine。同一日期内,把 commodity 指令写在 open 上方。查询在 #accounts 中以 open.currencies 读取这个列表。
与 Beancount 一样,列表把账户限定在它列出的商品之内:商品不同的记账行、余额断言或补齐,每个写下的记账行各报告一次 CommodityNotAllowed,带有 account_name 和 commodity 元数据。账本仍会加载,交易仍会记账。
- 只检查记账行的数量,不检查它的成本和价格,所以以
AAPL开立的账户可以买入AAPL {90 EUR}。 - 没有列表的
open允许任何商品。限制只针对账户本身,子账户不受限制。 - 被重新开立的账户,以该指令之前最近一次
open的列表为准。
close在它生效的位置检查账户自身在每种商品上的余额,不含子账户:只有日期的close在当天所有其他条目之后,带时刻的close在该时刻。余额不为零时报告CloseNonZeroAccount。账户仍会被关闭。所以在close当天清空账户的交易,在文件中写在close之前或之后都可以。- 关闭从未开立的账户会报告
AccountDoesNotExist,关闭已关闭的账户会报告AccountClosed,以第一次close为准。 - 已关闭的账户保留它的余额和历史。账户列表把它标记为已关闭,并且可以隐藏它。它仍持有的资金计入每一个合计:账户页面和侧边栏中其上级账户及账户类型的合计,无论列表是否隐藏它。
close之后可以有普通的balance、document和note,不会报错。
| 错误 | 触发条件 |
|---|---|
CommodityDoesNotDefine |
open 中列出的商品未定义。 |
CommodityNotAllowed |
记账行、余额断言或补齐使用了账户的 open 没有列出的商品。 |
ParseInvalidMeta |
booking_method 不是一种记账方法。 |
UnsupportedBookingMethod |
booking_method 为 AVERAGE、AVERAGE_ONLY 或 NONE。 |
CloseNonZeroAccount |
账户关闭时仍持有某种商品。 |
AccountDoesNotExist |
指令使用了尚未开立的账户,或者关闭了从未开立的账户。 |
AccountClosed |
记账行、pad 或 balance … with pad 在账户关闭之后使用了它,或者已关闭的账户再次被关闭。 |
Beancount 兼容性
Section titled “Beancount 兼容性”-
Beancount 把记账方法写成商品之后的带引号字符串。张记账在 Beancount 文件中读取这种写法,并把它存为
booking_method元数据。在 zhang 文件中请改用元数据:商品后面的字符串是语法错误。2024-01-01 open Assets:Broker USD "FIFO" -
两者都会报告商品不在
open列表中的记账行,以及这种商品的余额断言。对按多个批次记账的卖出,Beancount 每个批次报告一次,张记账对写下的记账行报告一次。张记账允许重新开立账户,以最近一次open的列表为准;Beancount 会把第二次open报告为错误。 -
Beancount 的默认记账方法是
STRICT;张记账的是FIFO。 -
CloseNonZeroAccount是张记账自己的检查:Beancount 关闭这样的账户时不会报错。 -
两者都让账户在
close当天保持可用:Beancount 把close排在当天所有其他指令之后。Beancount 没有时间的概念;在 Beancount 文件中,张记账同样把close的time元数据当作普通元数据。 -
两者都接受
close之后的balance、document和note,并报告记账行或pad。
