Linux dateコマンドの日付フォーマット一覧|前日・1ヶ月前・月末の罠
date コマンドで日付を好きな形に整えるときは、+ のあとにフォーマット指定子を並べます。
$ date '+%Y-%m-%d %H:%M:%S'
2015-10-09 07:20:32
シェルでバッチを書くたびに書き方を忘れてしまうので、よく使う指定子と、前日・1ヶ月前の日付の出し方を早見表にまとめました。
後半では、1ヶ月前の計算が月末でずれる落とし穴と、Mac で --date が使えないときの書き方も扱います。
よく使うフォーマット指定子の早見表
年月日や時刻は、次の指定子を組み合わせて書きます。
| 指定子 | 意味 | 出力例 |
|---|---|---|
%Y | 西暦(4桁) | 2015 |
%y | 西暦の下2桁 | 15 |
%m | 月(01〜12) | 10 |
%d | 日(01〜31) | 09 |
%H | 時(00〜23) | 07 |
%M | 分(00〜59) | 20 |
%S | 秒(2桁) | 32 |
%F | %Y-%m-%d と同じ | 2015-10-09 |
%T | %H:%M:%S と同じ | 07:20:32 |
%a | 曜日の略称 | Fri(日本語環境では「金」) |
%u | 曜日の番号(月曜=1〜日曜=7) | 5 |
%j | 1月1日からの通算日 | 282 |
%s | UNIX時間(1970-01-01 00:00 UTC からの秒数) | 1444342832 |
%z | UTC との時差 | +0900 |
%Z | タイムゾーン名 | JST |
出力例は、日本時間の 2015-10-09 07:20:32 に実行した場合です。
よく使う組み合わせ
'+%Y%m%d'→ 20151009(ファイル名に日付を付けるとき)'+%Y%m%d%H%M%S'→ 20151009072032'+%Y/%m/%d %H:%M:%S'→ 2015/10/09 07:20:32'+%F %T'→ 2015-10-09 07:20:32(1行目の例と同じ結果を短く書ける)-Iseconds→ 2015-10-09T07:20:32+09:00(ISO 8601 形式)'+%s%3N'→ 1444342832123 のような13桁(ミリ秒単位の UNIX 時間)
-Iseconds とミリ秒を出す %N は GNU 版(Linux)の拡張で、Mac の date では使えません。
13桁のミリ秒と日時の変換は、エポックミリ秒の変換ツールでも確かめられます。
前日・翌日の日付を出すには
1日後(翌日)の日付です。
$ date '+%Y-%m-%d' --date '1 day'
2015-10-10
1日前(前日)の日付です。
$ date '+%Y-%m-%d' --date '1 days ago'
2015-10-08
--date は -d と短く書けて、yesterday や tomorrow という書き方も通ります。
1ヶ月前・1ヶ月後の日付を出すには
1ヶ月後の日付です。
$ date '+%Y-%m-%d' --date '1 month'
2015-11-09
ただし、1ヶ月後の同じ日が存在しないと、思った通りの結果になりません。
たとえば 10/31 の1ヶ月後は、存在しない 11/31 があふれて 12/1 に繰り越されます。
$ date '+%Y-%m-%d' --date '2015-10-31 1 month'
2015-12-01
1ヶ月前の日付です。
$ date '+%Y-%m-%d' --date '1 month ago'
2015-09-09
こちらも同じで、10/31 の1ヶ月前は存在しない 9/31 になり、10/1 に繰り越されます。
$ date '+%Y-%m-%d' --date '2015-10-31 1 month ago'
2015-10-01
月末をまたぐと何が起きるのか(誕生日通知の失敗談)
昔、誕生日の1ヶ月前になったらプッシュ通知を送る、という仕様を作ったことがあります。
「今日の1ヶ月後が誕生日の人」に送る単純な作りにしたところ、先ほどの繰り越しのせいで2つの失敗が起きました。
- 12/1 生まれの人に2回届く:10/31 と 11/1 のどちらから見ても、1ヶ月後が 12/1 になるため
- 12/31 生まれの人には一生届かない:1ヶ月後が 12/31 になる日がないため(11/30 の1ヶ月後は 12/30)
$ date '+%Y-%m-%d' --date '2015-10-31 1 month'
2015-12-01
$ date '+%Y-%m-%d' --date '2015-11-01 1 month'
2015-12-01
$ date '+%Y-%m-%d' --date '2015-11-30 1 month'
2015-12-30
$ date '+%Y-%m-%d' --date '2015-12-01 1 month'
2016-01-01
月の足し算は、月末をまたぐと同じ日が重なったり欠けたりします。
PHP など他の言語で書いても同じことが起きるので、あのときは「誕生日の30日前」に送る仕様に落ち着いた記憶があります(笑)
月をまたぐ計算を安全に書くには
「先月」や「先月末」を出したいときは、存在しない日付を経由しない書き方にします。
先月の年月は、今月15日の1ヶ月前から取るのが確実で、GNU coreutils のマニュアルでも紹介されている方法です。
# 2015-12-31 に実行した場合
$ date -d '1 month ago' '+%Y-%m'
2015-12
$ date -d "$(date +%Y-%m-15) 1 month ago" '+%Y-%m'
2015-11
単純に1ヶ月前を取ると 12/31 の前月が 12/1 になり、先月のつもりが今月を返してしまいます。
月末日は、毎月必ずある「1日」を起点にすると、ずれずに出せます。
# 2016-02-10 に実行した場合
# 先月末 = 今月1日の1日前
$ date -d "$(date +%Y-%m-01) -1 day" '+%F'
2016-01-31
# 今月末 = 今月1日の1ヶ月後の1日前
$ date -d "$(date +%Y-%m-01) +1 month -1 day" '+%F'
2016-02-29
こうした「月末・1日」の境界は、シェルスクリプトを cron で定期実行するときにも事故りやすいポイントです。
日本時間から各環境(Linux / GitHub Actions / EventBridge など)の cron を組むならcron式メーカー&次回実行チェッカーが便利です。
Mac(BSD 版の date)ではどう書くか
Mac に最初から入っている date は BSD 系なので、--date を使うこれまでの書き方はそのままでは動きません。
代わりに -v オプションで日付をずらします。
$ date -v-1d '+%Y-%m-%d' # 1日前
$ date -v+1d '+%Y-%m-%d' # 1日後
$ date -v-1m '+%Y-%m-%d' # 1ヶ月前
$ date -v+1m '+%Y-%m-%d' # 1ヶ月後
注意したいのは、月の計算の結果も GNU 版と違うことです。
FreeBSD のマニュアルでは、-v で月をずらした先にその日がなければ、その月の末日になると説明されています。
- BSD 版:5/31 の1ヶ月後 → 6/30
- GNU 版:5/31 の1ヶ月後 → 7/1(存在しない 6/31 が繰り越される)
Linux と Mac で同じスクリプトを動かしたいなら、Homebrew で coreutils を入れると、GNU 版が gdate という名前で使えます。
参考(出典)
- Time conversion specifiers(GNU Coreutils マニュアル)
- Relative items in date strings(GNU Coreutils マニュアル) ※15日を起点に前月を取る方法
- date(1)(FreeBSD Manual Pages) ※ -v オプションと月の調整
コマンドの出力は、GNU coreutils 8.32 の date で確認しました。
