• 2023/1/19
• 3分

【Swift UIKit】UIDatePickerの使い方！和暦や西暦、時間の表示方法と日本語化

＼ アプリをリリースしました ／

友達や家族の誕生日をメモ！通知も届く-みんなの誕生日-

posted withアプリーチ

SwiftのUIKitでUIDatePickerを使用して日付を選択できるビューを実装する方法や和暦や西暦などの指定方法をまとめていきます。

公式リファレンス：UIDatePicker

UIDatePicker

@MainActor  class UIDatePicker : UIControl

UIDatePickerはUIControlを継承しているUI部品の1つで日付を選択できる機能を提供するクラスです。

SwiftUIではDatePicker使用して同じようなビューを実装します。実装方法は大きく異なるので詳しくは以下の記事を参考にしてください。

おすすめ記事：【SwiftUI】DatePickerの使い方!ロケールを日本語設定にする方法

普通のUI部品と同じでStoryboardもしくはコードから追加するだけで簡単に実装することができます。

let picker = UIDatePicker()
picker.center = self.view.center
view.addSubview(picker)

プロパティから変更できる設定

UIDatePickerクラスのプロパティからロケールや設定などを変更することができます。何も設定をしないとLocalizationsに設定されている言語が適応されます。ここを「Japanese」にすることでアプリ全体を日本語化することができるのでカレンダーも日本語表記になります。

おすすめ記事：【Swift/Xcode】アプリを日本語化する方法！Localizationsの設定

ロケール(日本語化)

カレンダーの表記を明示的に日本語にするためにはlocaleプロパティにja_JPを渡します。

picker.locale = Locale(identifier: "ja_JP")

タイムゾーン

表示する時間の場所を設定できます。

picker.timeZone = TimeZone(identifier: "Asia/Tokyo")

カレンダーの種類(和暦や西暦)

カレンダーの種類(暦法)を変更するにはcalendarプロパティにCalendar構造体を渡します。西暦(2023年)はgregorian、和暦(令和5年)にしたい場合はjapaneseを指定します。

picker.calendar = Calendar(identifier: .gregorian)
// picker.calendar = Calendar(identifier: .japanese)

デバイスの設定(暦法)を無視して表示させる

カレンダーの暦法を明示的に指定していない場合デバイスの「設定」＞「言語と地域」＞「暦法」に指定されている値が適応されます。calendarプロパティに値を渡した場合はデバイスの設定を無視して指定した値で表示させることができます。

デザインを変更する

DatePickerのデザインを変更するにはpreferredDatePickerStyleプロパティにUIDatePickerStyle型の任意の値を渡します。

公式リファレンス：UIDatePickerStyle

<č class="fas fa-check"> automatic

picker.preferredDatePickerStyle = .automatic

wheels

picker.preferredDatePickerStyle = .wheels

inline

picker.preferredDatePickerStyle = .inline

compact

picker.preferredDatePickerStyle = .compact

日付や時間のみにする

デフォルトでは日付と時間の両方が表示されていますが、日付のみや時間のみに変更する場合はdatePickerModeプロパティにUIDatePicker.Mode型の値を渡します。

enum Mode : Int, @unchecked  Sendable {
  case time           // 時間のみ
  case date           // 日付のみ
  case dateAndTime    // 両方
  case countDownTimer // カウントダウンタイマー
}

例：カウントダウンタイマーの場合

picker.datePickerMode = .countDownTimer

まだまだ勉強中ですので間違っている点や至らぬ点がありましたら教えていただけると助かります。

ご覧いただきありがとうございました。