元のドキュメント： developer.apple.com/documentation/watchkit/wkinterfacetimer

クラス

WKInterfaceTimer

カウントダウンまたはカウントアップタイマーを表示するラベル。

watchOS 2.0+

class WKInterfaceTimer

概観

タイマーオブジェクトを使用して、タイマーの時間や表示テキストの量をを構成します。タイマーを開始すると、WatchKit は拡張機能による操作なしに、ユーザーの Apple Watch に表示されるテキストを自動的に更新します。タイマーが 0 になったことを知るには、タイマーの設定に使用したのと同じ日付をターゲット日付として Timer オブジェクトを構成します。

このクラスを自分でサブクラス化したり、インスタンスを作成したりしないでください。代わりに、インターフェースコントローラクラスでアウトレットを定義し、あなたのストーリーボードファイル内の対応するオブジェクトに接続してください。たとえば、あなたのインターフェース内のタイマーオブジェクトを参照するには、インターフェースコントローラクラスで以下の構文でプロパティを定義します。

Swift

Objective-C

@IBOutlet weak var myTimer: WKInterfaceTimer!!

@property (weak, nonatomic) IBOutlet WKInterfaceTimer* myTimer;

インターフェースコントローラの初期化中に、WatchKit は必要なタイマーオブジェクトを作成し、それらを接続されたアウトレットに割り当てます。この時、これらのオブジェクトを使用して、対応するタイマーを再構成できます。

重要

このクラスは、初期化時またはユーザーの Apple Watch 上でインターフェイスコントローラがアクティブなときに、インターフェイスオブジェクトを構成するためのメソッドを提供します。WatchKit は、同じ実行ループの反復処理中に行われたすべてのセッターメソッド呼び出しからのデータを統合し、実行ループの最後にデバイスに送信します。同じ実行ループの反復処理で属性に異なる値を設定した場合、最後に設定された値のみが送信されます。同じ実行ループの反復処理で属性に同じ値を設定した場合、WatchKit は重複した変更を追跡できるようにログメッセージを生成します。

Interface Builder の構成オプション

Xcode では、ストーリーボードファイル内でタイマーインターフェイスオブジェクトに関する情報を構成できます。以下の表に、構成可能な属性とその意味を示します。

属性	説明
Format (書式)	タイマー文字列の書式。あなたのストーリーボードシーン内のタイマーラベルの表示形式を更新するには、違うオプションを選択してください。
Enabled (有効)	インターフェースの初期化と同時にタイマーを開始するかどうかを示すチェックボックス。
Units (単位)	ラベルに表示する単位。このセクションのチェックボックスを有効にすると、タイマーは時間範囲内の対応する単位を表示します。つまり、残り時間が 2 分のタイマーは分と秒のみを表示し、時間、日、またはそれ以上の単位は表示しません。
Preview Secs (プレビュー秒数)	タイマーの初期秒数です。この値は、setDate(_:) メソッドを使用してプログラムで変更できます。