日時の書式指定をする方法とその注意点(C#)

  • このエントリーをはてなブックマークに追加

スポンサーリンク

※サイト運営にサーバーは必須です※
~このサイトもエックスサーバーを使用しています~

目次

簡単な具体例

DateTime型を文字に変換する際に、書式を指定できます。

実行結果

2017/07/23
07:29:05

※簡単な説明

System.DateTime.Now

で現在の時刻をDateTime型で得られます。

ToStringメソッドで書式指定を行い、現在の時刻を文字列型として表示しています。

注意点

  • mとMの違いに注意

月(Month)を指定する場合は大文字のMで指定します。一方で、分(minute)を指定する場合は小文字のmを使用します。

この二つを間違えるとトンチンカンなことが起きます。

うっかり、yyyy/mm/ssと指定しないように。

  • 1文字だけしか指定しない場合は注意

日時の書式指定文字列には、「カスタム日時書式指定文字列」「標準の日時書式指定文字列」の2種類があります。

もしも、日時の書式指定文字列が1文字であった場合、「カスタム日時書式指定文字列」ではなく、「標準の日時書式指定文字列」として解釈されます。

そのため、「カスタム日時書式指定文字列」のつもりで1文字だけ書式指定を行うと、予期せぬ結果や、エラーが起きます。

カスタム日時書式指定子を1つしか使わない場合は先頭に%を付けることで回避できます。

カスタム日時書式指定文字列

カスタム日時書式指定文字列は以下のような書式指定子の組み合わせから成ります。

書式指定子 意味
yyyy(y,yy,yyy,yyyyy)
MM(M,MMM,MMMM)
dd(d)
ddd(dddd) 曜日
HH(H) 時(24時間表示)
hh(h) 時(12時間表示)
mm(m)
ss(s)
f(F) 秒以下を指定(fの数に応じて7桁まで指定可)
tt(t) 午前・午後
gg(g) 年号(「西暦」と表示)
K タイムゾーン(日本なら+9:00)
zzz(z,zz) UTC(協定世界時) を基準とする時間単位のオフセット(日本なら+9:00)
% カスタム書式指定子として認識する
”(“”) 書式指定子でなく、単なる文字として認識
\ 書式指定子でなく、単なる文字として認識

指定子の長さによって、結果は変わります。

例えば、「ss」(01~59)と「s」(1~59)は秒を指定するために使われます。

しかし、微妙に表示のされ方が変わることがあります。

5秒を表示するとき、「ss」であれば、「05」とゼロが付き、「s」であれば、「5」とゼロが省かれます。

また、上でも説明した通り、カスタム書式指定子を一文字で使用する場合は、前に「%」をつける必要があります。

なぜなら、1文字の場合、「カスタム日時書式指定文字列」でなく、「標準の日時書式指定文字列」として解釈されるからです。

ソースコード

実行結果

2017/07/23 20:31:05
2017/07/23
17/7/23
17
17
2017
2017
02017
7
07
7
7月
23
23

日曜日
2017/07(7)/23(日)
2017/07(7月)/23(日曜日)
20
20
(午)8
(午後)08
31:05
31:5
午後_8_31_5
08:31:05
08:31:05.6
08:31:05.6
08:31:05.6100481
08:31:05.6100481
08:31:05.7
08:31:05.7
08:31:05.7120862
08:31:05.7120862
西暦
西暦
+09:00
+9
+09
+09:00
8
 8
08
hh
時間08
時間08
31m(5s)
31m(5s)

標準の日時書式指定文字列

標準の日時書式指定文字列は以下の書式指定子を使って指定します。

書式指定子 意味 対応するカスタム書式指定子
d 年/月/日 yyyy/MM/dd
D ****年*月*日 yyyy’年’M’月’d’日’
t 時:分 H:mm
T 時:分:秒 H:mm:ss
g 年/月/日 時:分 yyyy/MM/dd H:mm
G 年/月/日 時:分:秒 yyyy/MM/dd H:mm:ss
f ****年*月*日 時:分 yyyy’年’M’月’d’日’ H:mm
F ****年*月*日 時:分:秒 yyyy’年’M’月’d’日’ H:mm:ss
y(Y) ****年*月 yyyy’年’M’月’
m(M) *月*日 M月d日
r(R) 曜日, 日 月 年 時:分:秒 GMT ddd, dd MMM yyyy HH’:’mm’:’ss ‘GMT’
s 年-月-日T時:分:秒 yyyy’-‘MM’-‘dd’T’HH’:’mm’:’ss
u 年-月-日 時:分:秒Z yyyy’-‘MM’-‘dd HH’:’mm’:’ss’Z’
U ****年*月*日 時:分:秒(協定世界時) yyyy’年’M’月’d’日’ H:mm:ss
o(O) 年-月-日T時:分:秒.(小数点)±協定世界時との差 yyyy’-‘MM’-‘dd’T’HH’:’mm’:’ss’.’fffffffK
(yyyy’-‘MM’-‘dd’T’HH’:’mm’:’ss’.’fffffffzzz)

国によって、対応するカスタム書式指定子は異なる可能性があります。

例えば、日本では、書式指定子「d」は、年/月/日の順番で表示されます。

一方、英語圏の一部では、日/月/年や月/日/年の順番だったりします。

ソースコード

実行結果

yyyy/MM/dd
2017/07/23
yyyy’年’M’月’d’日’
2017年7月23日
H:mm
20:33
H:mm:ss
20:33:19
yyyy/MM/dd H:mm
2017/07/23 20:33
yyyy/MM/dd H:mm:ss
2017/07/23 20:33:19
yyyy’年’M’月’d’日’ H:mm
2017年7月23日 20:33
yyyy’年’M’月’d’日’ H:mm:ss
2017年7月23日 20:33:19
yyyy’年’M’月’
2017年7月
2017年7月
M月d日
7月23日
7月23日
ddd, dd MMM yyyy HH’:’mm’:’ss ‘GMT’
Sun, 23 Jul 2017 20:33:19 GMT
Sun, 23 Jul 2017 20:33:19 GMT
yyyy’-‘MM’-‘dd’T’HH’:’mm’:’ss
2017-07-23T20:33:19
yyyy’-‘MM’-‘dd HH’:’mm’:’ss’Z’
2017-07-23 20:33:19Z
yyyy’年’M’月’d’日’ H:mm:ss
2017年7月23日 11:33:19
yyyy’-‘MM’-‘dd’T’HH’:’mm’:’ss’.’fffffffK
2017-07-23T20:33:19.5022747+09:00
2017-07-23T20:33:19.5052586+09:00
2017-07-23T20:33:19.5062598+09:00
2017-07-23T20:33:19.5062598+09:00
2017-07-23T20:33:19.5072646+09:00

関連記事

~プログラミングを勉強してみませんか?~

TechAcademy [テックアカデミー] 無料の体験講座が用意されているので、気軽に体験できます。

※私(サイト主)も無料体験講座を実際に受けてみました(→感想)

     

コメントを残す

*

日本語が含まれない投稿は無視されますのでご注意ください。(スパム対策)