Shell/Linux
PR

Linux dateコマンドの日付フォーマット一覧|前日・1ヶ月前・月末の罠

saratogax
記事内に商品プロモーションを含む場合があります

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
%j1月1日からの通算日282
%sUNIX時間(1970-01-01 00:00 UTC からの秒数)1444342832
%zUTC との時差+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桁のミリ秒と日時の変換は、エポックミリ秒の変換ツールでも確かめられます。

前日・翌日の日付を出すには

ここから先の --date を使う書き方は GNU 版の date(Linux)のものです。

Mac では書き方が違うので、記事の最後の節を見てください。

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 という名前で使えます。

参考(出典)

コマンドの出力は、GNU coreutils 8.32 の date で確認しました。

ABOUT ME
saratoga
saratoga
フリーランスエンジニア
仕事にも趣味にも IT を駆使するフリーランスエンジニア。技術的な TIPS や日々の生活の中で深堀りしてみたくなったことを備忘録として残していきます。
記事URLをコピーしました