Clock

: 特定のデバイスに存在する機能のみを表示するには、下の SmartDocs バーから 1 つまたは複数のフィルタを選択します。

言語に関する注: 入力フィールドには、英語のみを入力できます。

StageNow - 5.3

概要

Clock を使用すると、管理者はローカル時間または UTC 時間を使用して、デバイスの日付、時刻、タイム ゾーンを手動で設定できます。これらの設定は、ネットワークからデバイスが自動的に取得する (NTP サーバーから日付と時刻を取得する、携帯電話ネットワークから日付、時刻、タイムゾーンを取得するなど) こともできます。Clock では、管理者が 12 時間形式 (a.m./p.m.) または 24 時間形式を選択することもできます。

Zebra Android デバイスは、協定世界時 (UTC) 標準を使用して現在の日時を追跡します。この情報により、Clock は現地の日時を正確に計算して現地の時間座標 (LTC) で表すことができます。UTC は英国グリニッジの本初子午線における LTC と同等で、オフセットは適用されません。その他のほとんどの地域では、UTC を起点として、デバイスを使用している場所のタイム ゾーンに基づいて時間を加算または減算し、夏時間のオフセットがあればその時間も加算または減算して LTC を計算します。

Clock は協定世界時 (UTC) で日付と時刻の値を設定し、タイム ゾーンと夏時間のオフセットに基づいて現地時間への適切な変換が確実に行われるようにします。LTC が開始点として使用された場合、日付、時刻、およびタイム ゾーンの入力順序が結果の値に影響する可能性があります。詳細については、このガイドの末尾にある「LTC の計算例」を参照してください

主な機能

  • 現在のローカル時刻の設定
  • 現在の日付の設定
  • 現在の UTC 時刻の設定
  • 現在の UTC 日付の設定
  • 使用する時間座標系の設定 (ローカルまたは UTC)
  • タイム ゾーンの設定 (UTC 値から日時を計算するため)
  • 12 時間形式 (a.m./p.m.) または 24 時間形式での表示
  • ネットワークから日付、時刻、タイム ゾーンを取得するようにデバイスを設定 (可能な場合)
  • NTP サーバー アドレスの設定
  • AutoTime の同期間隔の設定

自動時刻設定 (チェックボックス)

デバイスの日付と時刻を携帯電話ネットワークまたは NTP サーバーの値を使用して設定するか、手動で設定するかを制御します。AutoTime が有効の場合、デバイスは、携帯電話ネットワーク (使用可能なものがある場合) から日時を取得しようとするか、または Syncinterval パラメータで指定された間隔で NTP サーバー (ある場合) に接続します。AutoTime が無効の場合は、日付と時刻を任意の有効な値に手動で設定できます。

パラメータ名: AutoTime

オプション 名前 説明注記 要件
false (オフ) AutoTime を無効にします。デバイスは、ネットワークから取得した値を使用して日付と時刻を自動的に設定できなくなります。

OSX: 1.3+

MX: 4.2+

true (オン) AutoTime を有効にします。デバイスは、ネットワークから取得した値を使用して日付と時刻を自動的に設定できます。

OSX: 1.3+

MX: 4.2+

NTP サーバー アドレス

AutoTime が有効になっている場合に、デバイスから接続可能な NTP サーバーの URL または IP アドレスを入力して、指定された同期間隔で日付と時刻を取得できるようにします。携帯電話ネットワーク上で動作しているデバイスは、通常、キャリア ネットワークから日時 (およびオプションでタイム ゾーン) を取得できます。携帯電話通信をサポートしていないデバイスや、サポートされている携帯電話ネットワークへのアクセスが一時的に途絶しているデバイスは、Wi-Fi やイーサネットなど、携帯電話以外のネットワーク経由で NTP サーバーから日時を取得できます (ただしタイム ゾーンは不可)。

パラメータ入力ルール:

  • NTP サーバーの有効な URL または IP アドレスを含む文字列
  • 空のままにすると (または XML にパラメータがない場合)、デフォルトの NTP サーバーが使用されます。

次の場合に表示: [自動時刻設定] チェックボックスがオンの場合

パラメータ名: NTPServer

要件:

  • MX: 4.2+
  • Android API: 19+

同期間隔の設定

AutoTime が有効の場合に、デバイスが指定された NTP サーバーと通信して日付と時刻を取得する間隔を入力するために使用されます。携帯電話ネットワーク上で動作しているデバイスの場合、AutoTime は通常、キャリア ネットワークから日付と時刻を取得します

次の場合に表示: [自動時刻設定] チェックボックスがオンの場合

パラメータ名: SyncInterval

オプション 名前 説明注記 要件
00:30:00 30 分 NTP サーバーに 30 分ごとに接続するようにデバイスを設定します。

MX: 4.2+

Android API: 16+

00:60:00 60 分 NTP サーバーに 60 分ごとに接続するようにデバイスを設定します。

MX: 4.2+

Android API: 16+

06:00:00 6 時間 NTP サーバーに 6 時間ごとに接続するようにデバイスを設定します。

MX: 4.2+

Android API: 16+

24:00:00 24 時間 NTP サーバーに 24 時間ごとに接続するようにデバイスを設定します。

MX: 4.2+

Android API: 16+

座標系

システム クロックを設定するためにデバイスに入力する時刻と日付の座標を選択するために使用します。ユニバーサル (オプション 1) を選択すると、UTCDate および UTCTime パラメータを使用して入力した値は、Clock CSP により、タイム ゾーンおよび夏時間のオフセットに基づいてローカル時刻に変換されます。

また、このガイドにある「LTC の計算例」セクションも参照してください

次の場合に表示: [自動時刻設定] チェックボックスが [オフ] の場合

パラメータ名: CoordinateSystem

オプション 名前 説明注記 要件
0 ローカル タイム ゾーンに対して調整されたローカル時間 (デバイスの位置に対する相対値) を受理するようにデバイスを設定します。

MX: 10.2+

1 ユニバーサル 本初子午線での絶対時刻である協定世界時 (UTC) を受理するようにデバイスを設定します。

MX: 10.2+

日付の設定

デバイスのローカル日付を手動で設定するために使用します。空の値を入力すると (または XML にこのパラメータがない場合)、以前に設定されていた日付は変更されません。

パラメータ入力ルール:

  • 0 文字または 10 文字ちょうどの文字列のみ使用可能
  • 10 文字の文字列はかならず「YYYY-MM-DD」の形式

注: このパラメータでは、タイム ゾーンまたは夏時間のオフセットに基づく UTC 値の調整は行いません。このような機能を有効にするには、座標系パラメータで [ユニバーサル] を選択し、UTCDate および UTCTime パラメータを使用して日付と時刻を入力してください。

次の場合に表示: [自動時刻設定] チェックボックスが [オフ] であり、かつ [座標系] がローカルに設定されている場合

パラメータ名: 日付

要件:

  • MX: 4.1+
  • Android API: 26+

時刻の設定

デバイスのローカル時刻を設定するために使用します。空の値を入力すると (または XML にこのパラメータがない場合)、以前に設定されていた時刻は変更されません。

パラメータ入力ルール:

  • 0 文字または 8 文字ちょうどの文字列のみ使用可能
  • 8 文字の文字列は、24 時間形式の「HH:MM:SS」にする必要があります (つまり深夜 0 時の 1 秒前ならば「23:59:59」)。

注: このパラメータでは、タイム ゾーンまたは夏時間のオフセットに基づく UTC 値の調整は行いません。このような機能を有効にするには、座標系パラメータで [ユニバーサル] を選択し、UTCDate および UTCTime パラメータを使用して日付と時刻を入力してください。

次の場合に表示: [自動時刻設定] チェックボックスが [オフ] であり、かつ [座標系] がローカルに設定されている場合

パラメータ名: 時間

要件:

  • MX: 4.1+
  • Android API: 26+

UTC 日付の設定

デバイス上の日付を自動的に計算するための UTC 日付の設定に使用します。このパラメータを使用して Clock に渡される日時の値は、UTC で表す必要があります (「概要」を参照)。空の値を入力すると (または XML にこのパラメータがない場合)、以前に設定した日付が保持されます。

詳細については、このガイドにある「LTC の計算例」セクションを参照してください

パラメータ入力ルール:

  • 0 文字または 10 文字ちょうどの文字列のみ使用可能
  • 10 文字の文字列はかならず「YYYY-MM-DD」の形式
  • 日付は UTC 値で表す必要があります (「概要」を参照)。

次の場合に表示: [自動時刻設定] チェックボックスが [オフ] であり、かつ [座標系] がユニバーサルに設定されている場合

パラメータ名: UTCDate

要件:

  • MX: 10.2+

UTC 時刻の設定

デバイス上のローカル時刻を自動的に計算するための UTC 時刻の設定に使用します。このパラメータを使用して Clock に渡される日時の値は、UTC で表す必要があります (「概要」を参照)。空の値を入力すると (または XML にこのパラメータがない場合)、以前に設定した時刻が保持されます。

詳細については、このガイドにある「LTC の計算例」セクションを参照してください

パラメータ入力ルール:

  • 0 文字または 8 文字ちょうどの文字列のみ使用可能
  • 8 文字の文字列は、24 時間形式の「HH:MM:SS」にする必要があります (つまり深夜 0 時の 1 秒前ならば「23:59:59」)。
  • 時刻は UTC 値で表す必要があります (「概要」を参照)。

次の場合に表示: [自動時刻設定] チェックボックスが [オフ] であり、かつ [座標系] がユニバーサルに設定されている場合

パラメータ名: UTCTime

要件:

  • MX: 10.2+

タイム ゾーンの設定

デバイスの現地時間座標 (LTC) の計算に使用するタイム ゾーンの設定に使用します。空の値を入力すると (または XML にこのパラメータがない場合)、以前に設定されていた設定はいずれも変更されません。

パラメータ入力ルール:

  • 最大 255 文字の文字列が使用できます
  • 空のままにすると (または XML にパラメータがない場合)、以前のタイム ゾーン設定が保持されます
  • 文字列は次のいずれかにする必要があります。
    • 「GMT」またはグリニッジ標準時に等しい値
    • 「UTC」 (GMT と同等) に等しい値
    • プレフィックス「GMT」で始まり、時間単位または時間および分単位のオフセットを含む値例:
      • GMT-10 (GMT から 10 時間を減算)
      • GMT+05:30 (GMT に 5 1/2 時間を加算)
    • Olsen/tz タイム ゾーン ID (すなわち「America/New_York」など)

詳細については、次の参照サイトを参照してください。

次の場合に表示: [自動タイム ゾーン設定] チェックボックスが [オフ] の場合

パラメータ名: TimeZone

要件:

  • MX: 4.1+

自動タイム ゾーン設定 (チェックボックス)

セルラー機能を搭載したデバイスが、所在地のタイム ゾーンをキャリア ネットワークから取得できるようにします (そのネットワークでサポートされている場合)。Clock は、デバイス上のローカル時刻を計算するためにタイム ゾーンを使用します。AutoTimeZone を無効にすると、UI を使用して手動で設定するか、または TimeZone パラメータを使用してプログラムで設定することができます。AutoTimeZone 機能は、セルラー機能を搭載したデバイスにのみ適用されます

警告: 自動タイム ゾーン設定の有効/無効を変更すると、Android の [最近使用したアプリ] リストから [設定] パネルを起動した場合に、新しい設定が反映されません。このような不正確な設定 (デバイスの正しい動作には影響しません) が表示されないようにするには、クロックを設定するために作成された任意のプロファイルに対して、関連する XML を App Manager から追加することで、[最近使用したアプリ] リストから設定アプリを消去できます。

パラメータ名: AutoTimeZone

オプション 名前 説明注記 要件
false (オフ) 自動タイム ゾーン設定を無効にして、デバイスがキャリア ネットワークから自動的にタイム ゾーンを取得できないようにします。

OSX: 1.3+

MX: 6.0+

true (オン) デバイスが現在のタイム ゾーンを自動的に取得できるようにします (キャリア ネットワークでサポートされている場合)。

OSX: 1.3+

MX: 6.0+

24 時間表示の有効化/無効化

デバイスの時刻を 24 時間形式で表示するかどうかを制御します。24 時間表示がオフの場合、時刻は標準的な 12 時間 (a.m./p.m.) 形式で表示されます。

パラメータ名: MilitaryTime

オプション 名前 説明注記 要件
0 変更しない この値 (またはこのパラメータが XML に存在しないこと) により時刻表示形式の設定が変更されることはありません。以前に選択した設定はすべて保持されます。

MX: 6.0+

1 オンにする 時刻を 24 時間形式で表示します。

MX: 6.0+

2 オフにする 時刻を 12 時間形式 (a.m./p.m.) で表示します。

MX: 6.0+

LTC の計算例

このセクションの例は、UTCDate および UTCTime パラメータにのみ適用されます。これは協定世界時 (UTC) 標準に基づいて値を受理します。

UTCDate パラメータおよび UTCTime パラメータを使用する場合、Clock に渡される値は UTC 値で表す必要があります。これにより、タイム ゾーンと夏時間 (ある場合) のオフセットに基づいてデバイスのローカル日時を計算するときに、正確な結果が確実に得られます。ローカル時刻が開始点として使用された場合、日付、時刻、およびタイム ゾーンの設定順序が結果の値に影響する可能性があります。以下の例では、これらの計算を正しく行う方法について説明します。

UTC は英国グリニッジの本初子午線における現地時間座標 (LTC) と同等で、オフセットは適用されません。その他のほとんどの地域では、UTC を起点として、デバイスを使用している場所のタイム ゾーンに基づいて時間を加算または減算し、夏時間のオフセットがあればその時間も加算または減算して LTC を計算します。

詳細については、次の参照サイトを参照してください。


例 #1

この例では、UTC オフセットを反転します。UTC 時間は東部時間よりも遅い時刻になるため、目的の東部時間に時刻を加算すると、UTC と同等の時刻が計算されます。この数値をデバイスに入力する際に、Clock は値を再計算して、デバイスが表示したりアプリケーションで使用したりするために必要な現地時刻にします。

1.デバイスに必要な現地時刻をメモします。

  • デバイスの所在地 = 米国ニューヨーク州ニューヨーク市
  • 日付 = 2010 年 1 月 15 日
  • 時刻 = 午後 2 時 15 分 (14:15:00)

2.デバイスの所在地について、次の点を確認します。

  • デバイスの所在地は米国東部時間の地域
  • そのタイム ゾーンの GMT オフセットは -5 時間 (UTC の 5 時間前)
  • この日このタイム ゾーンでは夏時間を使用しない

3.目的の LTC から UTC 値を計算します。

  • 選択したタイム ゾーンに UTC オフセット (-05:00) を適用
    • 14:15:00 + 05:00 = 19:15:00 (UTC が米国東部時間よりも遅いため、時間を加算)
  • 夏時間のオフセットを検討 (この日は適用なし)
    • 夏時間は 2010 年 3 月 14 日に開始
    • 夏時間は 2010 年 11 月 7 日に終了
  • 時間オフセットでは "ロール オーバー" も "ロール アンダー" も発生しないため、日付オフセットは適用しない

4.したがって、Clock に対して次のような値が指定されます。

  • TimeZone = "America/New_York"
  • Date = "2010-01-15"
  • Time = "19:15:00"

これらの UTC 値は、Clock によって変換され、デバイス上で正しい LTC 値として表示されます。


例 #2

この例では、UTC オフセットも反転します。UTC 時間はインド時間よりも早い時刻になるため、バンガロール時間から時間を減算すると、UTC と同等の時間が計算され、その結果、本初子午線 (日付変更線) を (逆方向に) 超えることになります。この数値をデバイスに入力する際に、Clock は値を再計算して、表示やプログラム使用のために必要な現地時刻にします。

1.デバイスに必要な現地時刻をメモします。

  • デバイスの場所 = インド、バンガロール
  • 日付 = 2010 年 7 月 11 日
  • 時刻 = 午前 2 時 55 分(02:55:00)

2.デバイスの所在地について、次の点を確認します。

  • デバイスの所在地はインドのタイム ゾーン
  • そのタイム ゾーンの GMT オフセットは +05:30 (GMT より +5 1/2 時間先行)
  • このタイム ゾーンでは夏時間を使用しない

3.目的の LTC から UTC 値を計算します。

  • 選択したタイム ゾーンに GMT オフセット (+05:30) を適用
    • 02:55:00 - 05:30 = 21:25:00 (00:00 をさかのぼるので 1 日減算)
  • 夏時間オフセットの適用なし
    • インドでは夏時間を使用しない
  • 時刻オフセットで "ロール アンダー" が発生するため、日付にマイナス 1 日のオフセットを適用

4.したがって、Clock に対して次のような値が指定されます。

  • TimeZone = "Asia/Calcutta"
  • Date = "2010-07-10"
  • Time = "21:25:00"

日付は 2010 年 7 月 10 日で、目的の現地時間より 1 日になる点に注意してください。インド時間の 7 月 11 日午前 2 時 55 分において、UTC の起点である英国のグリニッジでは午後 9 時 25 分 (5 時間 30 分前) で、日付がまだ 7 月 10 日であるためです。

Clock によって変換されると、これらの UTC 値はバンガロールにあるデバイスでは正しい LTC 値として表示されます。

Clock コーディングの例

タイム ゾーン、日付、時刻の設定


<wap-provisioningdoc>
    <characteristic type="Clock" version="4.2" >
        <parm name="AutoTime" value="false"/>
        <parm name="TimeZone" value="GMT-5"/>
        <parm name="Date" value="2015-07-09"/>
        <parm name="Time" value="10:25:33"/>
    </characteristic>
</wap-provisioningdoc>

NTP サーバー間隔の設定


<wap-provisioningdoc>
    <characteristic type="Clock" version="4.2" >
        <parm name="AutoTime" value="true"/>
        <characteristic type="AutoTimeDetails">
            <parm name="SyncInterval" value="00:30:00"/>
        </characteristic>
    </characteristic>
</wap-provisioningdoc>

NTP サーバーの IP アドレスと間隔の設定


<wap-provisioningdoc>
    <characteristic type="Clock" version="4.2" >
        <parm name="AutoTime" value="true"/>
        <characteristic type="AutoTimeDetails">
            <parm name="NTPServer" value="1.2.3.4"/>
            <parm name="SyncInterval" value="00:30:00"/>
        </characteristic>
    </characteristic>
</wap-provisioningdoc>