instance method Time#strftime

strftime(format) -> String[permalink][rdoc]

時刻を format 文字列に従って文字列に変換した結果を返します。

[PARAM] format:: フォーマット文字列を指定します。使用できるものは以下の通りです。

%A: 曜日の名称(Sunday, Monday ... )
%a: 曜日の省略名(Sun, Mon ... )
%B: 月の名称(January, February ... )
%b: 月の省略名(Jan, Feb ... )
%C: 世紀 (2009年であれば 20)
%c: 日付と時刻 (%a %b %e %T %Y)
%D: 日付 (%m/%d/%y)
%d: 日(01-31)
%e: 日。一桁の場合、半角空白で埋める ( 1..31)
%F: %Y-%m-%d と同等 (ISO 8601の日付フォーマット)
%G: ISO 8601の暦週の年
%g: ISO 8601の暦週の年の下2桁(00-99)
%H: 24時間制の時(00-23)
%h: %b と同等
%I: 12時間制の時(01-12)
%j: 年中の通算日(001-366)
%k: 24時間制の時。一桁の場合、半角空白で埋める ( 0..23)
%L: ミリ秒 (000..999)
%l: 12時間制の時。一桁の場合、半角空白で埋める ( 0..12)
%M: 分(00-59)
%m: 月を表す数字(01-12)
%n: 改行 (\n)
%N: 秒の小数点以下。桁の指定がない場合は9桁 (ナノ秒)、%6N: マイクロ秒 (6桁)、%3N: ミリ秒 (3桁)
%P: 午前または午後(am,pm)
%p: 午前または午後(AM,PM)
%Q: 1970-01-01 00:00:00 UTC からの経過ミリ秒 (Time#strftime は対応していませんが、Date#strftime で使えます)
%R: 24時間制の時刻。%H:%M と同等。
%r: 12時間制の時刻。%I:%M:%S %p と同等。
%S: 秒(00-60) (60はうるう秒)
%s: 1970-01-01 00:00:00 UTC からの経過秒
%T: 24時間制の時刻。%H:%M:%S と同等。
%t: タブ文字 (\t)
%U: 週を表す数。最初の日曜日が第1週の始まり(00-53)
%u: 月曜日を1とした、曜日の数値表現 (1..7)
%V: ISO 8601形式の暦週 (01..53)
%v: VMS形式の日付 (%e-%^b-%4Y)
%W: 週を表す数。最初の月曜日が第1週の始まり(00-53)
%w: 曜日を表す数。日曜日が0(0-6)
%X: 時刻 (%Tと同等)
%x: 日付 (%Dと同等)
%Y: 西暦を表す数
%y: 西暦の下2桁(00-99)
%Z: タイムゾーン (環境依存)
%z: タイムゾーン。UTCからのオフセット (例 +0900)
%:z: タイムゾーン。コロンが入ったUTCからのオフセット (例 +09:00)
%::z: タイムゾーン。コロンが入った秒まで含むUTCからのオフセット (例 +09:00:00)
%%: %自身
%+: date(1)の形式 (%a %b %e %H:%M:%S %Z %Y) (Time#strftime は対応していませんが、Date#strftime で使えます)

このメソッドは strftime(3) や glibcの仕様を参考に作成されており、以下のオプションが利用できます。

^: 大文字で出力を行なう
#: 小文字であれば大文字に、大文字であれば小文字に変更する
-: 左寄せにする(0埋めや空白埋めを行わない)
_: 空白埋めにする
0: 0埋めにする
数値: 表示桁数を指定する

EとOは無視されます。

例

t = Time.now                         #=> 2019-12-18 22:16:49 +0900
t.strftime("Printed on %m/%d/%Y")    #=> "Printed on 12/18/2019"
t.strftime("Printed on %m/%-d/%_6Y") #=> "Printed on 12/18/  2019"
t.strftime("at %I:%M%p")             #=> "at 10:16PM"
t.strftime("at %I:%M%#p")            #=> "at 10:16pm"

様々なISO 8601形式

t = Time.new(2001,2,3,4,5,6,"+09:00")
t.strftime("%Y%m%d")           # => 20010203                  Calendar date (basic)
t.strftime("%F")               # => 2001-02-03                Calendar date (extended)
t.strftime("%Y-%m")            # => 2001-02                   Calendar date, reduced accuracy, specific month
t.strftime("%Y")               # => 2001                      Calendar date, reduced accuracy, specific year
t.strftime("%C")               # => 20                        Calendar date, reduced accuracy, specific century
t.strftime("%Y%j")             # => 2001034                   Ordinal date (basic)
t.strftime("%Y-%j")            # => 2001-034                  Ordinal date (extended)
t.strftime("%GW%V%u")          # => 2001W056                  Week date (basic)
t.strftime("%G-W%V-%u")        # => 2001-W05-6                Week date (extended)
t.strftime("%GW%V")            # => 2001W05                   Week date, reduced accuracy, specific week (basic)
t.strftime("%G-W%V")           # => 2001-W05                  Week date, reduced accuracy, specific week (extended)
t.strftime("%H%M%S")           # => 040506                    Local time (basic)
t.strftime("%T")               # => 04:05:06                  Local time (extended)
t.strftime("%H%M")             # => 0405                      Local time, reduced accuracy, specific minute (basic)
t.strftime("%H:%M")            # => 04:05                     Local time, reduced accuracy, specific minute (extended)
t.strftime("%H")               # => 04                        Local time, reduced accuracy, specific hour
t.strftime("%H%M%S,%L")        # => 040506,000                Local time with decimal fraction, comma as decimal sign (basic)
t.strftime("%T,%L")            # => 04:05:06,000              Local time with decimal fraction, comma as decimal sign (extended)
t.strftime("%H%M%S.%L")        # => 040506.000                Local time with decimal fraction, full stop as decimal sign (basic)
t.strftime("%T.%L")            # => 04:05:06.000              Local time with decimal fraction, full stop as decimal sign (extended)
t.strftime("%H%M%S%z")         # => 040506+0900               Local time and the difference from UTC (basic)
t.strftime("%T%:z")            # => 04:05:06+09:00            Local time and the difference from UTC (extended)
t.strftime("%Y%m%dT%H%M%S%z")  # => 20010203T040506+0900      Date and time of day for calendar date (basic)
t.strftime("%FT%T%:z")         # => 2001-02-03T04:05:06+09:00 Date and time of day for calendar date (extended)
t.strftime("%Y%jT%H%M%S%z")    # => 2001034T040506+0900       Date and time of day for ordinal date (basic)
t.strftime("%Y-%jT%T%:z")      # => 2001-034T04:05:06+09:00   Date and time of day for ordinal date (extended)
t.strftime("%GW%V%uT%H%M%S%z") # => 2001W056T040506+0900      Date and time of day for week date (basic)
t.strftime("%G-W%V-%uT%T%:z")  # => 2001-W05-6T04:05:06+09:00 Date and time of day for week date (extended)
t.strftime("%Y%m%dT%H%M")      # => 20010203T0405             Calendar date and local time (basic)
t.strftime("%FT%R")            # => 2001-02-03T04:05          Calendar date and local time (extended)
t.strftime("%Y%jT%H%MZ")       # => 2001034T0405Z             Ordinal date and UTC of day (basic)
t.strftime("%Y-%jT%RZ")        # => 2001-034T04:05Z           Ordinal date and UTC of day (extended)
t.strftime("%GW%V%uT%H%M%z")   # => 2001W056T0405+0900        Week date and local time and difference from UTC (basic)
t.strftime("%G-W%V-%uT%R%:z")  # => 2001-W05-6T04:05+09:00    Week date and local time and difference from UTC (extended)