| Oracle® Data Provider for .NET開発者ガイド リリース9.2.0.4 部品番号 B13807-01 |
|
Oracle.DataAccess.Typesネームスペース(ODP.NET型)、6/19
OracleIntervalYM構造体は、データベースに対して格納または取得されるOracleのINTERVAL YEAR TO MONTHデータ型を表します。各OracleIntervalYMには、年および月で表現される時間間隔が格納されています。
Object
ValueType
OracleIntervalYM
// C# public struct OracleIntervalYM : IComparable
インスタンス・メソッドではスレッド・セーフティを保証しませんが、すべてのpublic staticメソッドはスレッド・セーフです。
// C# // Illustrates usage of OracleIntervalYM OracleIntervalYM iymMax = OracleIntervalYM.MaxValue; double maxYears = iymMax.TotalYears; maxYears -= 1; OracleIntervalYM iymMax_1 = new OracleIntervalYM(maxYears); // Calculate the difference. It should be 1 +/- epsilon years // where epsilon for OracleIntervalYM = 1 month. OracleIntervalYM iymDiff = iymMax - iymMax_1; // If the difference isnt exactly 1 day, display the difference if (iymDiff.TotalYears != 1) Console.WriteLine(iymDiff.ToString());
ネームスペース: Oracle.DataAccess.Types
アセンブリ: Oracle.DataAccess.dll
OracleIntervalYMのメンバーを次の表に示します。
OracleIntervalYMのコンストラクタを表5-61に示します。
| コンストラクタ | 説明 |
|---|---|
|
OracleIntervalYM構造体の新規インスタンスをインスタンス化します(オーバーロード)。 |
OracleIntervalYMのstaticフィールドを表5-62に示します。
| フィールド | 説明 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
OracleIntervalYMのstaticメソッドを表5-63に示します。
OracleIntervalYMのstatic演算子を表5-64に示します。
OracleIntervalYMの型変換を表5-65に示します。
| 演算子 | 説明 |
|---|---|
|
|
|
|
文字列を |
|
|
月数を |
OracleIntervalYMのプロパティを表5-66に示します。
OracleIntervalYMのメソッドを表5-67に示します。
OracleIntervalYMのコンストラクタは、OracleIntervalYM構造体の新規インスタンスを作成します。
このメソッドは、指定された時間間隔の合計月数を使用してOracleIntervalYM構造体の新規インスタンスを作成します。
このメソッドは、OracleIntervalYM構造体の新規インスタンスを作成し、指定された文字列を使用してその値を設定します。
このメソッドは、OracleIntervalYM構造体の新規インスタンスを作成し、合計年数を使用してその値を設定します。
このメソッドは、OracleIntervalYM構造体の新規インスタンスを作成し、年および月を使用してその値を設定します。
このメソッドは、OracleIntervalYM構造体の新規インスタンスを作成し、指定されたバイト配列にその値を設定します。このバイト配列はOracleのINTERVAL DAY TO SECONDの内部形式です。
このメソッドは、指定された時間間隔の合計月数を使用してOracleIntervalYM構造体の新規インスタンスを作成します。
// C# public OracleIntervalYM (long totalMonths);
ArgumentOutOfRangeException: totalMonthsパラメータが指定された範囲内にありません。
このメソッドは、OracleIntervalYM構造体の新規インスタンスを作成し、指定された文字列を使用してその値を設定します。
// C# public OracleIntervalYM (string intervalStr);
指定されたintervalStrに設定される値は、Year-Month書式である必要があります。
ArgumentException: intervalStrパラメータが有効な書式ではないか、無効な値を持ちます。
ArgumentNullException: intervalStrパラメータがnullです。
"1-2"は、1年2か月を表します。
このメソッドは、OracleIntervalYM構造体の新規インスタンスを作成し、合計年数を使用してその値を設定します。
// C# public OracleIntervalYM (double totalYears);
ArgumentOutOfRangeException: totalYearsパラメータが指定された範囲内にありません。
ArgumentException: 有効なOracleIntervalYMの構成にtotalYearsパラメータを使用できません。
このメソッドは、OracleIntervalYM構造体の新規インスタンスを作成し、年および月を使用してその値を設定します。
// C# public OracleIntervalYM (int years, int months);
すべての引数の符号は同じである必要があります。
ArgumentOutOfRangeException: 1つ以上のパラメータの引数値が指定された範囲内の値ではありません。
ArgumentException: 有効なOracleIntervalYMの構成にパラメータの引数値を使用できません。
このメソッドは、OracleIntervalYM構造体の新規インスタンスを作成し、指定されたバイト配列にその値を設定します。このバイト配列はOracleのINTERVAL DAY TO SECONDの内部形式です。
// C# public OracleIntervalYM (byte[] bytes);
ArgumentException: 指定されたバイト配列がOracleのINTERVAL YEAR TO MONTHの内部形式ではないか、無効な値を持ちます。
ArgumentNullException: bytesがnullです。
指定されたバイト配列はOracleのINTERVAL YEAR TO MONTHの内部形式である必要があります。
OracleIntervalYMのstaticフィールドを表5-68に示します。
| フィールド | 説明 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
このstaticフィールドは、OracleIntervalYM構造体の最大値を表します。
// C# public static readonly OracleIntervalYM MaxValue;
年は999999999、月は11です。
このstaticフィールドは、OracleIntervalYM構造体の最小値を表します。
// C# public static readonly OracleIntervalYM MinValue;
年は-999999999、月は-11です。
このstaticフィールドは、OracleIntervalYMインスタンスに割り当てられるnull値を表します。
// C# public static readonly OracleIntervalYM Null;
このstaticフィールドは、OracleIntervalYM構造体の0値を表します。
// C# public static readonly OracleIntervalDS Zero;
OracleIntervalYMのstaticメソッドを表5-69に示します。
このstaticメソッドは、2つのOracleIntervalYM値が等しいかどうかを判断します。
// C# public static bool Equals(OracleIntervalYM val1, OracleIntervalYM val2);
2つのOracleIntervalYM値が同じ時間間隔を表す場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalYMは、null値を持つOracleIntervalYMより大きいことになります。
OracleIntervalYMがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、2つのOracleIntervalYM値の1つ目の値が2つ目の値より大きいかどうかを判断します。
// C# public static bool GreaterThan(OracleIntervalYM val1, OracleIntervalYM val2);
2つのOracleIntervalYM値の1つ目の値が2つ目の値より大きい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalYMは、null値を持つOracleIntervalYMより大きいことになります。
OracleIntervalYMがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、2つのOracleIntervalYM値の1つ目の値が2つ目の値以上かどうかを判断します。
// C# public static bool GreaterThanOrEqual(OracleIntervalYM val1, OracleIntervalYM val2);
2つのOracleIntervalYM値の1つ目の値が2つ目の値以上の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalYMは、null値を持つOracleIntervalYMより大きいことになります。
OracleIntervalYMがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、2つのOracleIntervalYM値の1つ目の値が2つ目の値より小さいかどうかを判断します。
// C# public static bool LessThan(OracleIntervalYM val1, OracleIntervalYM val2);
2つのOracleIntervalYM値の1つ目の値が2つ目の値より小さい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalYMは、null値を持つOracleIntervalYMより大きいことになります。
OracleIntervalYMがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、2つのOracleIntervalYM値の1つ目の値が2つ目の値以下かどうかを判断します。
// C# public static bool LessThanOrEqual(OracleIntervalYM val1, OracleIntervalYM val2);
2つのOracleIntervalYM値の1つ目の値が2つ目の値以下の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalYMは、null値を持つOracleIntervalYMより大きいことになります。
OracleIntervalYMがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、2つのOracleIntervalYM値が等しくないかどうかを判断します。
// C# public static bool NotEquals(OracleIntervalYM val1, OracleIntervalYM val2);
2つのOracleIntervalYM値が等しくない場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalYMは、null値を持つOracleIntervalYMより大きいことになります。
OracleIntervalYMがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、OracleIntervalYM構造体を返し、文字列を使用して時間間隔の値を設定します。
// C# public static OracleIntervalYM Parse (string intervalStr);
OracleIntervalYM構造体を返します。
ArgumentException: intervalStrパラメータが有効な書式ではないか、無効な値を持ちます。
ArgumentNullException: intervalStrパラメータがnullです。
指定されたintervalStrに設定される値は、Year-Month書式である必要があります。
"1-2"は、1年2か月を表します。
このstaticメソッドは、指定された年の精度でOracleIntervalYMの新規インスタンスを返します。
// C# public static OracleIntervalYM SetPrecision(OracleIntervalYM value1,int yearPrecision);
OracleIntervalDSインスタンス
ArgumentOutOfRangeException: yearPrecisionが指定された範囲内にありません。
指定されたyearPrecisionに設定される値に応じて、0個以上の先行ゼロがToString()によって返される文字列に表示されます。
値"1-2"のOracleIntervalYMは、年の精度に3を設定してSetPrecision()をコールした場合、文字列"001-2"という結果になります。
OracleIntervalYMのstatic演算子を表5-70に示します。
このstatic演算子は、2つのOracleIntervalYM値を加算します。
// C# public static OracleIntervalYM operator + (OracleIntervalYM val1, OracleIntervalYM val2);
OracleIntervalYM
いずれかの引数がnull値を持つ場合、返されるOracleIntervalYM構造体はnull値を持ちます。
このstatic演算子は、2つのOracleIntervalYM値が等しいかどうかを判断します。
// C# public static bool operator == (OracleIntervalYM val1, OracleIntervalYM val2);
両方の値が等しい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalYMは、null値を持つOracleIntervalYMより大きいことになります。
OracleIntervalYMがnull値を持つ場合、2つは等しいことになります。
このstatic演算子は、2つのOracleIntervalYM値の1つ目の値が2つ目の値より大きいかどうかを判断します。
// C# public static bool operator > (OracleIntervalYM val1, OracleIntervalYM val2);
一方のOracleIntervalYM値が他方の値より大きい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalYMは、null値を持つOracleIntervalYMより大きいことになります。
OracleIntervalYMがnull値を持つ場合、2つは等しいことになります。
このstatic演算子は、2つのOracleIntervalYM値の1つ目の値が2つ目の値以上かどうかを判断します。
// C# public static bool operator >= (OracleIntervalYM val1, OracleIntervalYM val2);
一方のOracleIntervalYM値が他方の値以上の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalYMは、null値を持つOracleIntervalYMより大きいことになります。
OracleIntervalYMがnull値を持つ場合、2つは等しいことになります。
このstatic演算子は、2つのOracleIntervalYM値が等しくないかどうかを判断します。
// C# public static bool operator != (OracleIntervalYM val1, OracleIntervalYM val2)
2つのOracleIntervalYM値が等しくない場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalYMは、null値を持つOracleIntervalYMより大きいことになります。
OracleIntervalYMがnull値を持つ場合、2つは等しいことになります。
このstatic演算子は、2つのOracleIntervalYM値の1つ目の値が2つ目の値より小さいかどうかを判断します。
// C# public static bool operator < (OracleIntervalYM val1, OracleIntervalYM val2);
2つのOracleIntervalYM値の1つ目の値が2つ目の値より小さい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalYMは、null値を持つOracleIntervalYMより大きいことになります。
OracleIntervalYMがnull値を持つ場合、2つは等しいことになります。
このstatic演算子は、2つのOracleIntervalYM値の1つ目の値が2つ目の値以下かどうかを判断します。
// C# public static bool operator <= (OracleIntervalYM val1, OracleIntervalYM val2);
2つのOracleIntervalYM値の1つ目の値が2つ目の値以下の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalYMは、null値を持つOracleIntervalYMより大きいことになります。
OracleIntervalYMがnull値を持つ場合、2つは等しいことになります。
このstatic演算子は、一方のOracleIntervalYM構造体を他方から減算します。
// C# public static OracleIntervalYM operator - (OracleIntervalYM val1, OracleIntervalYM val2);
OracleIntervalYM構造体
いずれかの引数がnull値を持つ場合、返されるOracleIntervalYM構造体はnull値を持ちます。
このstatic演算子は、OracleIntervalYM構造体を否定します。
// C# public static OracleIntervalYM operator - (OracleIntervalYM val);
OracleIntervalYM構造体
指定されたOracleIntervalYM構造体がnull値を持つ場合、返されるOracleIntervalYM構造体はnull値を持ちます。
このstatic演算子は、OracleIntervalYM値と数値を乗算します。
// C# public static OracleIntervalYM operator * (OracleIntervalYM val1, int multiplier);
OracleIntervalYM構造体
指定されたOracleIntervalYM構造体がnull値を持つ場合、返されるOracleIntervalYM構造体はnull値を持ちます。
このstatic演算子は、OracleIntervalYM値を数値で除算します。
// C# public static OracleIntervalYM operator / (OracleIntervalYM val1, int divisor);
OracleIntervalYM構造体
指定されたOracleIntervalYM構造体がnull値を持つ場合、返されるOracleIntervalYM構造体はnull値を持ちます。
OracleIntervalYMの型変換を表5-71に示します。
| 演算子 | 説明 |
|---|---|
|
|
|
|
文字列を |
|
|
月数を |
この型変換演算子は、OracleIntervalYMを時間間隔の月数を表す数値に変換します。
// C# public static explicit operator long (OracleIntervalYM val);
月数を表すlong数値
OracleNullValueException: OracleIntervalYM構造体がnull値を持ちます。
この型変換演算子は、文字列intervalStrをOracleIntervalYM構造体に変換します。
// C# public static explicit operator OracleIntervalYM (string intervalStr);
OracleIntervalYM構造体
ArgumentException: 指定されたintervalStrパラメータが適切な書式ではないか、無効な値を持ちます。
ArgumentNullException: intervalStrパラメータがnullです。
返されるOracleIntervalDS構造体には、指定されたintervalStrによって表されるのと同じ時間間隔が含まれます。指定されたintervalStrに設定される値は、Year-Month書式である必要があります。
この型変換演算子は、時間間隔の合計月数をOracleIntervalYM構造体に変換します。
// C# public static implicit operator OracleIntervalYM (long months);
OracleIntervalYM構造体
ArgumentOutOfRangeException: monthsパラメータが指定された範囲内にありません。
OracleIntervalYMのプロパティを表5-72に示します。
このプロパティは、OracleのINTERVAL YEAR TO MONTHをOracleの内部形式で表すバイト配列を返します。
// C# public byte[] BinData {get;}
OracleのINTERVAL YEAR TO MONTHをOracleの内部形式で表すバイト配列
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、値にnull値が含まれているかどうかを示します。
// C# public bool IsNull {get;}
値にnull値が含まれている場合、trueを返します。それ以外の場合、falseを返します。
このプロパティは、OracleIntervalYMの月の構成要素を取得します。
// C# public int Months {get;}
月の構成要素を表すint
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、現在のOracleIntervalYM構造体の時間間隔を表す合計数を年数で返します。
// C# public double TotalYears {get;}
合計年数を表すdouble
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleIntervalYM構造体に格納されている合計月数を取得します。
// C# public long Value {get;}
時間間隔を表す合計月数
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleIntervalYMの年の構成要素を取得します。
// C# public int Years {get;}
年の構成要素を表すint
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
OracleIntervalYMのメソッドを表5-73に示します。
このメソッドは、現在のOracleIntervalYMインスタンスを指定されたオブジェクトと比較し、その相対値を表す整数を返します。
// C# public int CompareTo(object obj);
このメソッドは、次の数値を返します。
0より小さい値: 現在のOracleIntervalYMがobjより短い時間間隔を表す場合
0: 現在のOracleIntervalYMとobjが同じ時間間隔を表す場合
0より大きい値: 現在のOracleIntervalYMがobjより長い時間間隔を表す場合
IComparable
ArgumentException: objパラメータがOracleIntervalYM型ではありません。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalYM同士で行う必要があります。たとえば、OracleIntervalYMインスタンスとOracleBinaryインスタンスを比較することはできません。OracleIntervalYMを異なる型と比較すると、ArgumentExceptionがスローされます。
OracleIntervalYMは、null値を持つOracleIntervalYMより大きいことになります。
OracleIntervalYMがnull値を持つ場合、2つは等しいことになります。
Objectをオーバーライドします。
このメソッドは、指定されたオブジェクトが現在のインスタンスと同じ時間間隔を持つかどうかを判断します。
// C# public overridebool Equals(objectobj);
指定されたオブジェクトのインスタンスがOracleIntervalYM型で、同じ時間間隔を持つ場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalYMは、null値を持つOracleIntervalYMより大きいことになります。
OracleIntervalYMがnull値を持つ場合、2つは等しいことになります。
Objectをオーバーライドします。
このメソッドは、OracleIntervalYMインスタンスのハッシュ・コードを返します。
// C# public override int GetHashCode();
ハッシュ・コードを表すint
Objectをオーバーライドします。
このメソッドは、現在のOracleIntervalYM構造体を文字列に変換します。
// C# public override string ToString();
現在のOracleIntervalYM構造体を表す文字列
現在のインスタンスがnull値を持つ場合、返される文字列にはnullが含まれます。
|
|
![]() Copyright © 2002, 2003 Oracle Corporation. All Rights Reserved. |
|