XCode 26.5 日本語化計画
元のドキュメント: developer.apple.com/documentation/watchkit/wkinterfacedate
現在の日付または時刻を表示するラベル。
class WKInterfaceDate
WatchKit 拡張機能側での追加の操作を必要とせずに日付や時刻の情報を表示したい場合は、WKInterfaceDate を使用します。実行時には、date オブジェクトを使用して、表示される日付・時刻情報の外観を構成します。
このクラスを自分でサブクラス化したり、インスタンス化したりしないでください。代わりに、インターフェイスコントローラクラスでアウトレットを定義し、それらをあなたのストーリーボードファイル内の対応するオブジェクトに接続します。例えば、インターフェイス内の date オブジェクトを参照するには、インターフェイスコントローラクラスで以下のような構文を使用してプロパティを定義します。
| Swift | Objective-C |
@IBOutlet weak var myDate: WKInterfaceDate!
@property (weak, nonatomic) IBOutlet WKInterfaceDate* myDate;
インターフェイスコントローラの初期化中に、WatchKit は必要な日付オブジェクトを作成し、それらを接続されたアウトレットに割り当てます。これらのオブジェクトが設定された後は、それらを使用して、画面上の日付や時刻の情報を変更することができます。
Xcode では、あなたのストーリーボードファイル内の日付インターフェイスオブジェクトに関する情報を構成できます。以下の表は、構成可能な属性とその意味をまとめたものです。
| 属性 | 説明 |
| Format (フォーマット) | 標準形式とカスタム形式のいずれかを選択するためのセレクターです。標準形式の場合、「日付」および「時刻」の属性を使用して、表示したい情報を構成します。この属性の値を「カスタム」に変更すると、データ書式設定ガイド (Data Formatting Guide)に記載されている書式設定オプションに基づき、日付を正しく思い通りの形式に構成できるようになります。 | Date (日付) | 表示する日付情報。日付のオプションは、DateFormatter.Style 型の値に対応しています。 |
| Time (時刻) | 表示する時刻情報。時刻のオプションは、DateFormatter.Style 型の値に対応しています。 |
| Preview (プレビュー) | 日付と時刻がどのように表示されるかのプレビュー。 |
日付オブジェクトは、そのテキストを直接設定できないカスタムラベルです。ただし、Xcode 内の Attributes inspector を使用すれば、日付オブジェクトの外観をカスタマイズできます。構成可能なラベル属性の詳細については、WKInterfaceLabel を参照してください。
日付と時刻のテキストの色を設定します。
時刻情報を表示する際に使用するタイムゾーンを設定します。
日付情報を書式化する際に使用するカレンダーを設定します。
NSObjectProtocol
静的なテキストを表示するインターフェース要素。
カウントダウンまたはカウントアップタイマーを表示するラベル。
class WKInterfaceButton
あなたの watchOS アプリのユーザーインターフェイスにあるボタン。
class WKInterfacePaymentButton
Apple Pay による支払いを行うために使用できるボタン。
class WKInterfaceTextField
編集可能なテキスト領域を表示するインターフェース要素。
class WKInterfaceSwitch
オンとオフの状態を切り替えるインターフェース要素。
class WKInterfaceSlider
ユーザーが値の範囲から単一の浮動小数点数を選択できるようにするインターフェース要素。
class WKInterfaceActivityRing
HealthKit のアクティビティサマリーオブジェクトのデータを表示するビュー。
class WKInterfaceMap
あなたが指定した場所の、操作不可能な地図を表示するインターフェイス要素。