| name | biff |
| description | Use this skill when the user wants to format, parse, add, subtract, or compare dates and times from the command line, or manipulate timestamps in log files. |
biff Plugin
Datetime arithmetic, parsing, formatting, timezone conversion, sequence generation, and log timestamp tagging for the command line. By BurntSushi (author of ripgrep, xsv, and jiff).
Commands
Time Formatting
biff time fmt — Format one or more timestamps
Time Arithmetic
biff time add — Add a duration to a timestamp
Duration Calculation
biff span since — Calculate the duration since a given timestamp
Utility
biff self version — Print biff version
biff _ _ — Passthrough to biff CLI
Usage Examples
- "What time is it now?"
- "Format this date as RFC 3339"
- "What will the date be 6 months from now?"
- "How long has it been since January 20th?"
- "Convert UTC timestamps in a log to my local timezone"
- "Generate the next 5 Mondays at 9am"
Installation
cargo install biff
Examples
biff _ _
biff time fmt -f rfc3339 now
biff time fmt -f rfc9557 now
biff -f now
biff -f now -1d
biff add -1w now
biff add now
biff add 6mo now
biff now | biff _ _ Asia/Bangkok | biff _ _ round -i 15 -s minute
biff span since 2025-01-20T12:00
biff span since 2025-01-20T12:00 -l year
biff span since 2025-01-20T12:00 | biff _ _ span round -l year -s day
biff _ _ day today -c5 -H 9 -w mon,wed,fri
biff _ _ daily -- $(biff _ _ end-of month now) today
biff _ _ -c12 monthly -w mon,tue,wed,thu,fri --set-position -1 | biff -f
biff _ _ tag lines /tmp/access.log | biff _ _ system | biff -f | -n3 | biff _ _ untag -s