SimpleTimeZone クラス

定義

[Android.Runtime.Register("java/util/SimpleTimeZone", DoNotGenerateAcw=true)]
public class SimpleTimeZone : Java.Util.TimeZone

[<Android.Runtime.Register("java/util/SimpleTimeZone", DoNotGenerateAcw=true)>]
type SimpleTimeZone = class
    inherit TimeZone

継承

Object

JavaObject

Object

TimeZone

SimpleTimeZone

属性

RegisterAttribute

注釈

SimpleTimeZone は、グレゴリオ暦で使用するタイム ゾーンを表す TimeZone の具象サブクラスです。 このクラスは、GMT からのオフセット ( <em>raw offset</em> と呼ばれる) を保持し、夏時間スケジュールの開始規則と終了規則を保持します。 それぞれ 1 つの値しか保持されないので、GMT と夏時間スケジュールからのオフセットの履歴変更を処理できません。ただし、 #setStartYear setStartYear メソッドでは夏時間スケジュールが有効に開始される年を指定できる点が異なります。

夏時間スケジュールを使用して SimpleTimeZone を作成するには、スケジュールを一連のルール( <em>start-rule</em> と <em>end-rule</em>で記述できます。 夏時間が開始または終了する日は、 <em>month</em>、 <em>day-of-month</em>、および <em>day-of-week</em> 値の組み合わせによって指定されます。 <em>month</em> の値は、カレンダー Calendar#MONTH MONTH フィールドの値 (Calendar#MARCH など) で表されます。 <em>day-of-week</em> の値は、予定表のCalendar#DAY_OF_WEEK DAY_OF_WEEK値 (Calendar#SUNDAY SUNDAY など) で表されます。 値の組み合わせの意味は次のとおりです。

<ul><li><b>exact day of month</b><br> 正確な月の日を指定するには、 <em>month</em> と <em>day-of-month</em> を正確な値に設定し、 <em>day-of-week</em> を 0 に設定します。 たとえば、3 月 1 日を指定するには、 <em>month</em> を Calendar#MARCH MARCH、 <em>day-of-month</em> を 1、 <em>day-of-week</em> を 0.< に設定します。/li>

<li><b>月の曜日または後の曜日</b><br> 正確な月の日以降の曜日を指定するには、 <em>month</em> を正確な月の値に設定し、 <em>day-of-month</em> をルールが適用される日に設定し、 <em>day-of-week</em> を負の Calendar#DAY_OF_WEEK DAY_OF_WEEK フィールド値に設定します。 たとえば、4 月の第 2 日曜日を指定するには、 <em>month</em> を Calendar#APRIL APRIL、 <em>day-of-month</em> を 8、 <em>day-of-week</em> を -Calendar#SUNDAY SUNDAY.< に設定します。/li>

<li><b>月の曜日または前の曜日</b><br> 月の正確な日の前に曜日を指定するには、 <em>day-of-month</em> と <em>day-of-week</em> を負の値に設定します。 たとえば、3 月 21 日以前の最後の水曜日を指定するには、 <em>month</em> を Calendar#MARCH MARCH に設定し、 <em>day-of-month</em> を -21 し、 <em>day-of-week</em> を -Calendar#WEDNESDAY WEDNESDAYします。 </li>

<li><b>月の最後の曜日</b><br> 月の最後の曜日を指定するには、 <em>day-of-week</em> を Calendar#DAY_OF_WEEK DAY_OF_WEEK 値に設定し、 <em>day-of-month</em> -1 に設定します。 たとえば、10 月の最後の日曜日を指定するには、 <em>month</em> を Calendar#OCTOBER OCTOBER、 <em>day-of-week</em> を Calendar#SUNDAY SUNDAY に、 <em>day-of-month</em> を -1 に設定します。 </li>

</ul> 夏時間が開始または終了する時刻は、その日のミリ秒単位の値で指定されます。 時刻を指定する <em>mode</em>には、 #WALL_TIME、 #STANDARD_TIME 、 #UTC_TIMEの 3 種類があります。 たとえば、夏時間が壁時計時刻の午前 2 時に終了する場合、 #WALL_TIME モードでは 7200000 ミリ秒で指定できます。 この場合、 <em>end-rule</em> のウォール クロック時間は、夏時間と同じことを意味します。

タイム ゾーン オブジェクトを構築するためのパラメーターの例を次に示します。

<code>
                 // Base GMT offset: -8:00
                 // DST starts:      at 2:00am in standard time
                 //                  on the first Sunday in April
                 // DST ends:        at 2:00am in daylight time
                 //                  on the last Sunday in October
                 // Save:            1 hour
                 SimpleTimeZone(-28800000,
                                "America/Los_Angeles",
                                Calendar.APRIL, 1, -Calendar.SUNDAY,
                                7200000,
                                Calendar.OCTOBER, -1, Calendar.SUNDAY,
                                7200000,
                                3600000)

                 // Base GMT offset: +1:00
                 // DST starts:      at 1:00am in UTC time
                 //                  on the last Sunday in March
                 // DST ends:        at 1:00am in UTC time
                 //                  on the last Sunday in October
                 // Save:            1 hour
                 SimpleTimeZone(3600000,
                                "Europe/Paris",
                                Calendar.MARCH, -1, Calendar.SUNDAY,
                                3600000, SimpleTimeZone.UTC_TIME,
                                Calendar.OCTOBER, -1, Calendar.SUNDAY,
                                3600000, SimpleTimeZone.UTC_TIME,
                                3600000)
</code>

これらのパラメーター ルールは、 setStartRuleなどのセット ルール メソッドにも適用できます。

1.1 で追加されました。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。