From 39c162fdd15ed7ebc8215b037e6a6049719f326b Mon Sep 17 00:00:00 2001 From: Lander Brandt Date: Sun, 18 May 2025 18:24:25 -0700 Subject: [PATCH] biff: add page (#16485) * biff: add page --------- Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> Co-authored-by: Fazle Arefin --- pages/common/biff.md | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 pages/common/biff.md diff --git a/pages/common/biff.md b/pages/common/biff.md new file mode 100644 index 0000000000..350323788c --- /dev/null +++ b/pages/common/biff.md @@ -0,0 +1,36 @@ +# biff + +> A simple utility for doing datetime arithmetic, parsing and formatting. +> More information: . + +- Print the current time in a format of your choosing: + +`biff time fmt {{[-f|--format]}} rfc3339 now` + +- Print multiple relative times in one command: + +`biff time fmt {{[-f|--format]}} '%c' now -1d 'next sat' 'last monday' '9pm last mon'` + +- Print the current time in another time zone, and round it the nearest 15 minute increment: + +`biff time in Asia/Bangkok now | biff time round {{[-i|--increment]}} 15 {{[-s|--smallest]}} minute` + +- Convert a time between two different time zone: + +`TZ='Japan' biff time in America/New_York 02:30` + +- Print a past or future time relative to current time: + +`biff time add {{-1d|1d|1w|-1m|1y|...}} now` + +- Add a complex duration to the current time: + +`biff time add '1 week, 12 hours ago' now` + +- Find the duration since a date in the past and round it to the desired precision: + +`biff span since 2025-01-20T12:00 {{[-l|--largest]}} year` + +- Find timestamps in a log file and reformat them into your local time in place: + +`biff tag lines /tmp/access.log | biff time in system | biff time fmt {{[-f|--format]}} '%c' | head {{[-n|--lines]}} 3 | biff untag {{[-s|--substitute]}}`