はじめに

Swift における日付の取り扱いが、他の言語と比較すると少しわかりにくいと感じるのは筆者だけでしょうか？

今回は、Swift における現在日時の取得方法について見ていきます。

環境

Xcode: 10.2.1

Swift: 5.0.1

目次

• 現在の日時を取得するには？
  • 現在日時取得のダメな例
  • 現在日時の正しい取得例
• 日付の書式について
  

現在の日時を取得するには？

現在日時取得のダメな例

Date型を使用することで、現在の日時を取得することができます。

最初にダメな例を示します。

この例では Date型の変数 dt に Date のインスタンスを代入しています。このようにすると、変数 dt には日時情報が代入されますが表示してみると現在日時ではないことがわかります。

// NG例
import UIKit

let dt : Date = Date()

print(dt)

実行例を以下に示します。

正しく表示されているように見えますが、現在よりも9時間前の時刻で表示されていることがわかります（サンプルコードを実行したのは2019/6/22 23:08頃です）

なぜ9時間前の時刻が表示されたのか？

これは、UTC(協定世界時)が表示されているからです。UTCは世界共通時であり、日本時間から見て9時間前に設定されています。言い換えれば、日本時間はUTC+9時間ということになります。

現在日時の正しい取得例

現在日時を正しく取得したい場合は、DateFormatter を使用します。

DateFormatter を使用すると、表示書式とロケールを指定することができます。

「ロケール」とは、システムにおける言語や国、地域のことです。ロケールを設定することでその地域における時刻を取得することができます。例えば、ロケールを「ja_JP」にすると日本における時刻を取得することができます。ちなみに「ja-JP」は「言語コード-国コード」を表しています。

主な言語コードを以下に示します。

主な国コードを以下に示します。

DateFormatterの書式を以下に示します。

class func dateFormat(fromTemplate: String,
options opts: Int,
locale: Locale?) -> String?

第1引数：表示したい日付書式を指定します。書式は後述します。
第2引数：オプションは現在定義されていないので 0 を指定してください。
第3引数：ロケールを文字列で指定します。

以下に現在日時を正しく取得する例を示します。

let dt = Date()
let dateFormatter = DateFormatter()

// DateFormatter を使用して書式とロケールを指定する
dateFormatter.dateFormat = DateFormatter.dateFormat(fromTemplate: "yMMMdHms", options: 0, locale: Locale(identifier: "ja_JP"))

print(dateFormatter.string(from: dt))

実行例を以下に示します。

日付の書式について

使用可能な日付の書式を以下表に示します（間違いがある場合はコメント欄から報告いただけると幸いです）。