账户名称示例

Assets:US:BofA:Checking

账户类型

类型借方贷方
Assets (资产)+-
Liabilities (负债)-+
Income (收入)-+
Expenses (支出)+-
Equity (权益)-+

货币/商品 (Commodities)

全部使用大写字母:

  • 法定货币:USD, EUR, CAD, AUD
  • 股票代码:GOOG, AAPL, RBF1005
  • 自定义:HOME_MAYST, AIRMILES, HOURS

指令 (Directives)

通用语法

YYYY-MM-DD <指令> <参数...>

开户与销户

2001-05-29 open Expenses:Restaurant

2001-05-29 open Assets:Checking     USD,EUR  ; 货币约束

2015-04-23 close Assets:Checking

声明商品/货币

这是可选的;仅当你需要为某种货币附加元数据时使用。

1998-07-22 commodity AAPL
  name: "Apple Computer Inc."

价格

可多次使用以填充历史价格数据库:

2015-04-30 price AAPL   125.15 USD
2015-05-30 price AAPL   130.28 USD

备注 (Notes)

2013-03-20 note Assets:Checking "Called to ask about rebate"

文档 (Documents)

2013-03-20 document Assets:Checking "path/to/statement.pdf"

交易 (Transactions)

基本格式

2015-05-30 * "Some narration about this transaction"
  Liabilities:CreditCard   -101.23 USD
  Expenses:Restaurant       101.23 USD

完整格式(含收款人、标签、链接、元数据)

2015-05-30 ! "Cable Co" "Phone Bill" #tag ^link
  id: "TW378743437"               ; 元数据
  Expenses:Home:Phone  87.45 USD
  Assets:Checking                 ; 可以省略一个金额

说明:

  • * 表示已确认的交易
  • ! 表示待确认/标记的交易

记账行 (Postings) 格式

...    123.45 USD                             ; 简单格式

...        10 GOOG {502.12 USD}               ; 含单位成本

...        10 GOOG {{5021.20 USD}}            ; 含总成本

...        10 GOOG {502.12 # 9.95 USD}        ; 含单位成本和总成本

...   1000.00 USD   @ 1.10 CAD                ; 含单位价格

...        10 GOOG {502.12 USD} @ 1.10 CAD    ; 含成本和价格

...        10 GOOG {502.12 USD, 2014-05-12}   ; 含日期

! ...   123.45 USD ...                        ; 含标记

余额断言与填充 (Balance Assertions and Padding)

余额断言

仅断言指定货币的金额:

2015-06-01 balance Liabilities:CreditCard  -634.30 USD

填充

自动插入交易以满足后续的余额断言:

YYYY-MM-DD pad Assets:Checking Equity:Opening-Balances

事件 (Events)

YYYY-MM-DD event "location" "New York, USA"
YYYY-MM-DD event "address" "123 May Street"

选项 (Options)

option "title" "My Personal Ledger"

完整选项列表请参考:http://furius.ca/beancount/doc/options


其他

标签入栈/出栈

pushtag #trip-to-peru
...
poptag #trip-to-peru

注释

; 注释以分号开头

#Code/Beancount #Finance/DoubleEntry

Beancount 语法速查表

作者

Sawa

发布日期

2026 - 03 - 10

Avatar
Sawa

Don't Panic

分类