[Ruby/Rails] strptimeのよく使うテンプレート

こんにちは、hachi8833です。昨日のstrftimeテンプレート記事に続き、strptimeのよく使うオプションをテンプレート用にまとめてみました。

注意: コード例はすべてRuby 2.3.1の場合です。

RailsであればActiveSupportを使うことが多いと思いますが、タイムゾーンの扱いに注意する必要があります。

strptime

Time.strptimeは、日時を表す文字列をTimeオブジェクトに変換します。名前の「p」の由来は見つけられませんでしたが、parseのpではないかと推測しました。

Time.strptimeはTimeクラスを拡張するRubyのライブラリなのでrequireして使います。昨日のstrftimeは組み込みのTimeクラスのメソッドですので、その点が異なります。

C言語のstrptime(3)やglibcを参考に作られています。

追記（2020/06/26）:ParseDateは現在のRubyでは使えなくなっています。
参考: Rubyのparsedateは1.9以降使えなくなっていた - 煮卵もんすたー

個別のパラメータについてはDate#strftimeやstrptime(3)をご覧ください。

⚓Apacheログなどの「2016-10-07T04:05:06+09:00」を変換したいとき

Time.strptimeの例そのままですが、よく使われるパターンです。

require 'time'
Time.strptime('2016-10-07T04:05:06+09:00', '%Y-%m-%dT%H:%M:%S%z')

⚓「2016年10月07日 12:13:23」を変換したいとき

require 'time'
Time.strptime("2016年10月07日 12:13:23", '%Y年%m月%d日 %H:%M:%S')

⚓ゼロがスペースになっている「2016年 1月 1日 1: 3: 3」を変換したいとき

require 'time'
Time.strptime("2016年 1月 1日  1: 3: 3", '%Y年 %m月 %d日 %H: %M: %S')

少々極端な例ですが、フォーマットの%mなどの前にスペースを置くことで、上位桁のゼロがスペースになっている文字列を変換できます。

スペースの部分に数字が入っても正常に処理されます。

参考: 日本語表記の日時をTimeオブジェクトに変換（Time.strptimeメソッド）

⚓「2016-10-07 午後 04:18」を変換したいとき

「2016-10-07」の形式にはショートハンドの%Fが便利です。

午前と午後の表示は手を加える必要があります。めったに使わないと思いますが。

require 'time'
datetime = '2016-10-07 午後 04:18'.sub(/午前/, 'AM').sub(/午後/, 'PM')
pry(main)> Time.strptime(datetime, '%F %p %H:%M')

なお、%pと%Pでは同じ結果でした。

関連記事

[Ruby/Rails] strftimeのよく使うテンプレート

ActiveRecordで日付・時刻の範囲検索をシンプルに書く方法

RailsでTimeZoneを設定する