Calendar.Roll メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| Name | 説明 |
|---|---|
| Roll(CalendarField, Boolean) |
指定されたフィールドで 1 つの時間単位をロール (上/下) します。 |
| Roll(CalendarField, Int32) |
指定されたフィールドで、指定した時間をロール (上/下) します。 |
Roll(CalendarField, Boolean)
指定されたフィールドで 1 つの時間単位をロール (上/下) します。
[Android.Runtime.Register("roll", "(IZ)V", "", ApiSince=24)]
public void Roll(Android.Icu.Util.CalendarField field, bool up);
[<Android.Runtime.Register("roll", "(IZ)V", "", ApiSince=24)>]
member this.Roll : Android.Icu.Util.CalendarField * bool -> unit
パラメーター
- field
- CalendarField
ロールするカレンダー フィールド。
- up
- Boolean
は、指定した時間フィールドの値をロールアップまたはロールダウンするかどうかを示します。 ロールアップする場合は true を使用し、それ以外の場合 false 使用します。
- 属性
注釈
指定されたフィールドで 1 つの時間単位をロール (上/下) します。 フィールドが許容される最大値を超えてロールされている場合は、最小値に "ラップ" し、ローリングを続けます。 たとえば、現在の日付を 1 日分上げるには、次のコマンドを呼び出します。
roll({@link #DATE}, true)
#YEAR フィールドでローリングすると、1 から #getMaximum getMaximum(#YEAR) を呼び出して返される値の範囲で年の値がロールされます。
特定のフィールドでローリングする場合、他のフィールドの値が競合する可能性があり、変更する必要があります。 たとえば、グレゴリオ暦の日付 1/31/96 の MONTH フィールドを上方向に転がす場合、結果が無効な 2/31/96 ではなく 2/29/96 になるように、 DAY_OF_MONTH フィールドを調整する必要があります。
ローリング アップとは、常に時間単位でロールフォワードすることを意味します (フィールドの制限に達しない限り、ピン留めまたは折り返しが可能です)。グレゴリオ暦の暦では、BC 100 から始まり、年を 99 BC にロールアップします。 年号に明確な始まりと終わりがある場合 (中国の暦のように、または日本の暦のほとんどの時代号のように)、年号のいずれかの制限を過ぎた年を転がすと、年が折り返されます。 時代 (年号) の上限が一方の端にしかない場合、その制限を超えて年をロールしようとすると、その制限で年が固定されます。 時代 (仏教、ヘブライ語、イスラム教など) の時代 (仏教、ヘブライ語、イスラム教など) が進むほとんどのカレンダーでは、年号 0 の負の年が発生する可能性があることに注意してください (これは、このようなカレンダーの暦エポックの前の年を表す唯一の方法です)。
<b>Note:</b>roll(field, true) N 回の呼び出しは<em></em>呼び出しroll(field, N)と同じです。 たとえば、1995 年 1 月 31 日のグレゴリオ暦の日付から始めるとします。
roll(Calendar.MONTH, 2)を呼び出すと、結果は 1995 年 3 月 31 日になります。 ただし、 roll(Calendar.MONTH, true)を呼び出すと、結果は 1995 年 2 月 28 日になります。 もう一度呼び出すと、1995 年 3 月 28 日が表示されます。これは通常、望ましい結果ではありません。
<b>Note:</b>Calendarのフィールドに対して算術演算を直接実行するのではなく、常にrollとaddを使用する必要があります。
Calendarサブクラスには、非線形動作を持つフィールド (たとえば、閏年以外の月や日が不足しているなど) がある可能性があります。 サブクラスの add メソッドと roll メソッドはこれを考慮しますが、単純な算術操作では無効な結果が得られます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
Roll(CalendarField, Int32)
指定されたフィールドで、指定した時間をロール (上/下) します。
[Android.Runtime.Register("roll", "(II)V", "GetRoll_IIHandler", ApiSince=24)]
public virtual void Roll(Android.Icu.Util.CalendarField field, int amount);
[<Android.Runtime.Register("roll", "(II)V", "GetRoll_IIHandler", ApiSince=24)>]
abstract member Roll : Android.Icu.Util.CalendarField * int -> unit
override this.Roll : Android.Icu.Util.CalendarField * int -> unit
パラメーター
- field
- CalendarField
ロールするカレンダー フィールド。
- amount
- Int32
フィールドをロールする必要がある量。
- 属性
注釈
指定されたフィールドで、指定した時間をロール (上/下) します。 たとえば、現在の日付を 3 日分上げるには、 roll(Calendar.DATE, 3)を呼び出すことができます。 フィールドが許容される最大値を超えてロールされている場合は、最小値に "ラップ" し、ローリングを続けます。 たとえば、グレゴリオ暦で 4/25/96 に設定された roll(Calendar.DATE, 10) を呼び出すと、日付は 4/5/96 になります。
特定のフィールドでローリングする場合、他のフィールドの値が競合する可能性があり、変更する必要があります。 たとえば、グレゴリオ暦の日付 1/31/96 の #MONTH MONTH フィールドを +1 で転がす場合、結果が無効な 2/31/96 ではなく 2/29/96 になるように、 #DAY_OF_MONTH DAY_OF_MONTH フィールドを調整する必要があります。
正の値でローリングすることは、常に時間内にロールフォワードすることを意味します (フィールドの制限に達しない限り、ピン留めまたは折り返しになる可能性があります)。グレゴリオ暦では、BC 100 から始まり、年を + 1 で転がすことで、BC 99 になります。 年号に明確な始まりと終わりがある場合 (中国の暦のように、または日本の暦のほとんどの時代号のように)、年号のいずれかの制限を過ぎた年を転がすと、年が折り返されます。 時代 (年号) の上限が一方の端にしかない場合、その制限を超えて年をロールしようとすると、その制限で年が固定されます。 時代 (仏教、ヘブライ語、イスラム教など) の時代 (仏教、ヘブライ語、イスラム教など) が進むほとんどのカレンダーでは、年号 0 の負の年が発生する可能性があることに注意してください (これは、このようなカレンダーの暦エポックの前の年を表す唯一の方法です)。
<strong>[icu] Note:</strong> このメソッドの ICU 実装では、 #ERA ERA、 #DST_OFFSET DST_OFFSET、および #ZONE_OFFSET ZONE_OFFSETを除くすべてのフィールドをロールできます。 サブクラスは、もちろん、 rollのオーバーライドで追加のフィールドのサポートを追加できます。
<b>Note:</b>Calendarのフィールドに対して算術演算を直接実行するのではなく、常にrollとaddを使用する必要があります。
Calendarサブクラスには、非線形動作を持つフィールド (たとえば、閏年以外の月や日が不足しているなど) がある可能性があります。 サブクラスの add メソッドと roll メソッドはこれを考慮しますが、単純な算術操作では無効な結果が得られます。
<b>Subclassing:</b><br> この roll の実装では、フィールドの動作は、 #getActualMinimum getActualMinimum と #getActualMaximum getActualMaximumを呼び出すことによって検出される最小値と最大値の間で連続していることを前提としています。 このようなほとんどのフィールドでは、単純な加算、減算、および剰余演算でロールを実行するだけで十分です。 週関連のフィールドでは、 #getFirstDayOfWeek getFirstDayOfWeek と #getMinimalDaysInFirstWeek getMinimalDaysInFirstWeek の結果も必要です。 サブクラスの値が既定値と異なる場合、これらの 2 つのメソッドをオーバーライドできます。
連続性の前提が分解されるフィールドを持つサブクラスは、これらのフィールドを特別に処理するために roll をオーバーライドする必要があります。 たとえば、ヘブライ暦では、月 "Adar I" は閏年でのみ発生します。それ以外の年では、カレンダーは Shevat (月 #4) から Adar (月 #6) にジャンプします。
HebrewCalendar#roll HebrewCalendar.rollメソッドはこれを考慮に入れ、Shevat の月を 1 つずつローリングすると、閏年以外の適切な結果 (Adar) が得られます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。