| Oracle® Data Provider for .NET開発者ガイド リリース9.2.0.4 部品番号 B13807-01 |
|
Oracle.DataAccess.Typesネームスペース(ODP.NET型)、5/19
OracleIntervalDS構造体は、データベースに対して格納または取得されるOracleのINTERVAL DAY TO SECONDデータ型を表します。各OracleIntervalDSには、日、時間、分、秒および小数秒で表現される時間間隔が格納されています。
Object
ValueType
OracleIntervalDS
// C# public struct OracleIntervalDS : IComparable
インスタンス・メソッドではスレッド・セーフティを保証しませんが、すべてのpublic staticメソッドはスレッド・セーフです。
// C# // Illustrates usage of OracleIntervalDS OracleIntervalDS idsMax = OracleIntervalDS.MaxValue; double maxDays = idsMax.TotalDays; maxDays -= 1; OracleIntervalDS idsMax_1 = new OracleIntervalDS(maxDays); // Calculate the difference. It should be 1 +/- epsilon days // where epsilon for OracleIntervalDS = 0.000000001 seconds. OracleIntervalDS idsDiff = idsMax - idsMax_1; // If the difference isnt exactly 1 day, display the difference if (idsDiff.TotalDays != 1) Console.WriteLine(idsDiff.ToString());
ネームスペース: Oracle.DataAccess.Types
アセンブリ: Oracle.DataAccess.dll
OracleIntervalDSのメンバーを次の表に示します。
OracleIntervalDSのコンストラクタを表5-48に示します。
| コンストラクタ | 説明 |
|---|---|
|
OracleIntervalDS構造体の新規インスタンスをインスタンス化します(オーバーロード)。 |
OracleIntervalDSのstaticフィールドを表5-49に示します。
| フィールド | 説明 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
OracleIntervalDSのstaticメソッドを表5-50に示します。
OracleIntervalDSのstatic演算子を表5-51に示します。
OracleIntervalDSの型変換を表5-52に示します。
| 演算子 | 説明 |
|---|---|
|
|
|
|
文字列を |
|
|
|
OracleIntervalDSのプロパティを表5-53に示します。
OracleIntervalDSのメソッドを表5-54に示します。
OracleIntervalDSのコンストラクタは、OracleIntervalDS構造体の新規インスタンスを作成します。
このコンストラクタは、OracleIntervalDS構造体の新規インスタンスを作成し、TimeSpan構造体を使用してその値を設定します。
このコンストラクタは、OracleIntervalDS構造体の新規インスタンスを作成し、時間間隔を示す文字列を使用してその値を設定します。
このコンストラクタは、OracleIntervalDS構造体の新規インスタンスを作成し、合計日数を使用してその値を設定します。
このコンストラクタは、OracleIntervalDS構造体の新規インスタンスを作成し、指定された日、時間、分、秒およびミリ秒を使用してその値を設定します。
このコンストラクタは、OracleIntervalDS構造体の新規インスタンスを作成し、指定された日、時間、分、秒およびナノ秒を使用してその値を設定します。
このコンストラクタは、OracleIntervalDS構造体の新規インスタンスを作成し、指定されたバイト配列にその値を設定します。このバイト配列はOracleのINTERVAL DAY TO SECONDの内部形式です。
このコンストラクタは、OracleIntervalDS構造体の新規インスタンスを作成し、TimeSpan構造体を使用してその値を設定します。
// C# public OracleIntervalDS(TimeSpan ts);
このコンストラクタは、OracleIntervalDS構造体の新規インスタンスを作成し、時間間隔を示す文字列を使用してその値を設定します。
// C# public OracleIntervalDS(string intervalStr);
ArgumentException: intervalStrパラメータが有効な書式ではないか、無効な値を持ちます。
ArgumentNullException: intervalStrパラメータがnullです。
指定されたintervalStrに設定される値は、Day HH:MI:SSxFF書式である必要があります。
"1 2:3:4.99"は、1日2時間3分4秒990ミリ秒または1日2時間3分4秒990000000ナノ秒を表します。
このコンストラクタは、OracleIntervalDS構造体の新規インスタンスを作成し、合計日数を使用してその値を設定します。
// C# public OracleIntervalDS(double totalDays);
ArgumentOutOfRangeException: 1つ以上のパラメータの引数値が指定された範囲内の値ではありません。
ArgumentException: 有効なOracleIntervalDSの構成にパラメータの引数値を使用できません。
このコンストラクタは、OracleIntervalDS構造体の新規インスタンスを作成し、指定された日、時間、分、秒およびミリ秒を使用してその値を設定します。
// C# public OracleIntervalDS (int days, int hours, int minutes, int seconds, double milliSeconds);
days
指定された日数。日数の範囲は-999,999,999〜999,999,999です。
hours
指定された時間数。時間数の範囲は-23〜23です。
minutes
指定された分数。分数の範囲は-59〜59です。
seconds
指定された秒数。秒数の範囲は-59〜59です。
milliSeconds
指定されたミリ秒。ミリ秒数の範囲は-999.999999〜999.999999です。
ArgumentOutOfRangeException: 1つ以上のパラメータの引数値が指定された範囲内の値ではありません。
ArgumentException: 有効なOracleIntervalDSの構成にパラメータの引数値を使用できません。
すべての引数の符号は同じである必要があります。
このコンストラクタは、OracleIntervalDS構造体の新規インスタンスを作成し、指定された日、時間、分、秒およびナノ秒を使用してその値を設定します。
// C# public OracleIntervalDS (int days, int hours, int minutes, int seconds, int nanoseconds);
days
指定された日数。日数の範囲は-999,999,999〜999,999,999です。
hours
指定された時間数。時間数の範囲は-23〜23です。
minutes
指定された分数。分数の範囲は-59〜59です。
seconds
指定された秒数。秒数の範囲は-59〜59です。
nanoseconds
指定されたナノ秒数。ナノ秒数の範囲は-999,999,999〜999,999,999です。
ArgumentOutOfRangeException: 1つ以上のパラメータの引数値が指定された範囲内の値ではありません。
ArgumentException: 有効なOracleIntervalDSの構成にパラメータの引数値を使用できません。
すべての引数の符号は同じである必要があります。
このコンストラクタは、OracleIntervalDS構造体の新規インスタンスを作成し、指定されたバイト配列にその値を設定します。このバイト配列はOracleのINTERVAL DAY TO SECONDの内部形式です。
// C# public OracleIntervalDS (byte[ ] bytes);
ArgumentException: bytesがOracleのINTERVAL DAY TO SECONDの内部形式ではないか、有効なOracleのINTERVAL DAY TO SECONDではありません。
ArgumentNullException: bytesがnullです。
OracleIntervalDSのstaticフィールドを表5-55に示します。
| フィールド | 説明 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
このstaticフィールドは、OracleIntervalDS構造体の最大値を表します。
// C# public static readonly OracleIntervalDS MaxValue;
最大値は次のとおりです。
このstaticフィールドは、OracleIntervalDS構造体の最小値を表します。
// C# public static readonly OracleIntervalDS MinValue;
最小値は次のとおりです。
このstaticフィールドは、OracleIntervalDSインスタンスに割り当てられるnull値を表します。
// C# public static readonly OracleIntervalDS Null;
このstaticフィールドは、OracleIntervalDS構造体の0値を表します。
// C# public static readonly OracleIntervalDS Zero;
OracleIntervalDSのstaticメソッドを表5-56に示します。
このstaticメソッドは、2つのOracleIntervalDS値が等しいかどうかを判断します。
// C# public static bool Equals(OracleIntervalDS val1, OracleIntervalDS val2);
2つのOracleIntervalDS構造体が同じ時間間隔を表す場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalDSは、null値を持つOracleIntervalDSより大きいことになります。
OracleIntervalDSがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、2つのOracleIntervalDS値の1つ目の値が2つ目の値より大きいかどうかを判断します。
// C# public static bool GreaterThan(OracleIntervalDS val1, OracleIntervalDS val2);
2つのOracleIntervalDS値の1つ目の値が2つ目の値より大きい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalDSは、null値を持つOracleIntervalDSより大きいことになります。
OracleIntervalDSがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、2つのOracleIntervalDS値の1つ目の値が2つ目の値以上かどうかを判断します。
// C# public static bool GreaterThanOrEqual(OracleIntervalDS val1, OracleIntervalDS val2);
2つのOracleIntervalDS値の1つ目の値が2つ目の値以上の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalDSは、null値を持つOracleIntervalDSより大きいことになります。
OracleIntervalDSがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、2つのOracleIntervalDS値の1つ目の値が2つ目の値より小さいかどうかを判断します。
// C# public static bool LessThan(OracleIntervalDS val1, OracleIntervalDS val2);
2つのOracleIntervalDS値の1つ目の値が2つ目の値より小さい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalDSは、null値を持つOracleIntervalDSより大きいことになります。
OracleIntervalDSがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、2つのOracleIntervalDS値の1つ目の値が2つ目の値以下かどうかを判断します。
// C# public static bool LessThanOrEqual(OracleIntervalDS val1, OracleIntervalDS val2);
2つのOracleIntervalDS値の1つ目の値が2つ目の値以下の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalDSは、null値を持つOracleIntervalDSより大きいことになります。
OracleIntervalDSがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、2つのOracleIntervalDS値が等しくないかどうかを判断します。
// C# public static bool NotEquals(OracleIntervalDS val1, OracleIntervalDS val2);
2つのOracleIntervalDS値が等しくない場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalDSは、null値を持つOracleIntervalDSより大きいことになります。
OracleIntervalDSがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、OracleIntervalDSインスタンスを返し、文字列を使用して時間間隔の値を設定します。
// C# public static OracleIntervalDS Parse(string intervalStr);
指定された文字列で時間間隔を表すOracleIntervalDSインスタンスを返します。
ArgumentException: intervalStrパラメータが有効な書式ではないか、無効な値を持ちます。
ArgumentNullException: intervalStrパラメータがnullです。
intervalStrに設定される値は、Day HH:MI:SSxFF書式である必要があります。
"1 2:3:4.99"は、1日2時間3分4秒990ミリ秒または1日2時間3分4秒990000000ナノ秒を表します。
このstaticメソッドは、指定された日の精度および小数秒の精度でOracleIntervalDSの新規インスタンスを返します。
// C# public static OracleIntervalDS SetPrecision(OracleIntervalDS value1,int dayPrecision, int fracSecPrecision);
value1
OracleIntervalDS構造体。
dayPrecision
指定された日の精度。日の精度の範囲は0〜9です。
fracSecPrecision
指定された小数秒の精度。小数秒の精度の範囲は0〜9です。
OracleIntervalDSインスタンス
ArgumentOutOfRangeException: 引数値が指定された範囲内の値ではありません。
指定されたdayPrecisionに設定される値に応じて、0個以上の先行ゼロがToString()によって返される文字列に表示されます。
指定されたfracSecPrecisionに設定される値を使用し、指定されたOracleIntervalDS値に対して四捨五入の操作が実行されます。この値に応じて、0個以上の後続ゼロがToString()によって返される文字列に表示されます。
値"1 2:3:4.99"のOracleIntervalDSは、日の精度を3に、小数秒を5に設定してSetPrecision()をコールした場合、文字列"001 2:3:4.99000"という結果になります。
OracleIntervalDSのstatic演算子を表5-57に示します。
このstatic演算子は、2つのOracleIntervalDS値を加算します。
// C# public static OracleIntervalDS operator + (OracleIntervalDS val1, OracleIntervalDS val2);
OracleIntervalDS
いずれかの引数がnull値を持つ場合、返されるOracleIntervalDS構造体はnull値を持ちます。
このstatic演算子は、2つのOracleIntervalDS値が等しいかどうかを判断します。
// C# public static bool operator == (OracleIntervalDS val1, OracleIntervalDS val2);
2つのOracleIntervalDS値が等しい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalDSは、null値を持つOracleIntervalDSより大きいことになります。
OracleIntervalDSがnull値を持つ場合、2つは等しいことになります。
このstatic演算子は、2つのOracleIntervalDS値の1つ目の値が2つ目の値より大きいかどうかを判断します。
// C# public static bool operator > (OracleIntervalDS val1, OracleIntervalDS val2);
一方のOracleIntervalDS値が他方の値より大きい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalDSは、null値を持つOracleIntervalDSより大きいことになります。
OracleIntervalDSがnull値を持つ場合、2つは等しいことになります。
このstatic演算子は、2つのOracleIntervalDS値の1つ目の値が2つ目の値以上かどうかを判断します。
// C# public static bool operator >= (OracleIntervalDS val1, OracleIntervalDS val2);
2つのOracleIntervalDS値の1つ目の値が2つ目の値以上の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalDSは、null値を持つOracleIntervalDSより大きいことになります。
OracleIntervalDSがnull値を持つ場合、2つは等しいことになります。
このstatic演算子は、2つのOracleIntervalDS値が等しくないかどうかを判断します。
// C# public static bool operator != (OracleIntervalDS val1, OracleIntervalDS val2);
2つのOracleIntervalDS値が等しくない場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalDSは、null値を持つOracleIntervalDSより大きいことになります。
OracleIntervalDSがnull値を持つ場合、2つは等しいことになります。
このstatic演算子は、2つのOracleIntervalDS値の1つ目の値が2つ目の値より小さいかどうかを判断します。
// C# public static bool operator < (OracleIntervalDS val1, OracleIntervalDS val2);
2つのOracleIntervalDS値の1つ目の値が2つ目の値より小さい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalDSは、null値を持つOracleIntervalDSより大きいことになります。
OracleIntervalDSがnull値を持つ場合、2つは等しいことになります。
このstatic演算子は、2つのOracleIntervalDS値の1つ目の値が2つ目の値以下かどうかを判断します。
// C# public static bool operator <= (OracleIntervalDS val1, OracleIntervalDS val2);
2つのOracleIntervalDS値の1つ目の値が2つ目の値以下の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalDSは、null値を持つOracleIntervalDSより大きいことになります。
OracleIntervalDSがnull値を持つ場合、2つは等しいことになります。
このstatic演算子は、一方のOracleIntervalDS構造体を他方から減算します。
// C# public static OracleIntervalDS operator - (OracleIntervalDS val1, OracleIntervalDS val2);
OracleIntervalDS構造体
いずれかの引数がnull値を持つ場合、返されるOracleIntervalDS構造体はnull値を持ちます。
このstatic演算子は、指定されたOracleIntervalDS構造体を否定します。
// C# public static OracleIntervalDS operator - (OracleIntervalDS val);
OracleIntervalDS構造体
指定されたOracleIntervalDS構造体がnull値を持つ場合、返されるOracleIntervalDS構造体はnull値を持ちます。
このstatic演算子は、OracleIntervalDS値と数値を乗算します。
// C# public static OracleIntervalDS operator * (OracleIntervalDS val1, int multiplier);
新しいOracleIntervalDSインスタンス
OracleIntervalDS構造体がnull値を持つ場合、返されるOracleIntervalDS構造体はnull値を持ちます。
このstatic演算子は、OracleIntervalDS値を数値で除算します。
// C# public static OracleIntervalDS operator / (OracleIntervalDS val1, int divisor);
OracleIntervalDS構造体
OracleIntervalDS構造体がnull値を持つ場合、返されるOracleIntervalDS構造体はnull値を持ちます。
OracleIntervalDSの型変換を表5-58に示します。
| 演算子 | 説明 |
|---|---|
|
|
|
|
文字列を |
|
|
|
この型変換演算子は、OracleIntervalDS構造体をTimeSpan構造体に変換します。
// C# public static explicit operator TimeSpan(OracleIntervalDS val);
TimeSpan構造体
OracleNullValueException: OracleIntervalDS構造体がnull値を持ちます。
この型変換演算子は、文字列をOracleIntervalDS構造体に変換します。
// C# public static explicit operator OracleIntervalDS (string intervalStr);
OracleIntervalDS構造体
ArgumentException: 指定されたintervalStrパラメータが適切な書式ではないか、無効な値を持ちます。
ArgumentNullException: intervalStrパラメータがnullです。
返されるOracleIntervalDS構造体には、指定されたintervalStrによって表されるのと同じ時間間隔が含まれます。指定されたintervalStrに設定される値は、Day HH:MI:SSxFF書式である必要があります。
"1 2:3:4.99"は、1日2時間3分4秒990ミリ秒または1日2時間3分4秒990000000ナノ秒を表します。
この型変換演算子は、TimeSpan構造体をOracleIntervalDS構造体に変換します。
// C# public static implicit operator OracleIntervalDS(TimeSpan val);
OracleIntervalDS構造体
返されるOracleIntervalDS構造体には、指定されたTimeSpan valと同じ日、時間、秒、ミリ秒が含まれます。
OracleIntervalDSのプロパティを表5-59に示します。
このプロパティは、OracleのINTERVAL DAY TO SECONDをOracleの内部形式で表すバイト配列を返します。
// C# public byte[] BinData {get;}
OracleのINTERVAL DAY TO SECONDをOracleの内部形式で表すバイト配列
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleIntervalDSの日の構成要素を取得します。
// C# public int Days {get;}
日の構成要素を表すint
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleIntervalDSの時間の構成要素を取得します。
// C# public int Hours {get;}
時間の構成要素を表すint
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、現在のインスタンスがnull値を持つかどうかを示します。
// C# public bool IsNull {get;}
現在のインスタンスがnull値を持つ場合、trueを返します。それ以外の場合、falseを返します。
このプロパティは、OracleIntervalDSのミリ秒の構成要素を取得します。
// C# public double Milliseconds {get;}
ミリ秒の構成要素を表すdouble
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleIntervalDSの分の構成要素を取得します。
// C# public int Minutes {get;}
分の構成要素を表すint
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleIntervalDSのナノ秒の構成要素を取得します。
// C# public int Nanoseconds {get;}
ナノ秒の構成要素を表すint
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleIntervalDSの秒の構成要素を取得します。
// C# public int Seconds {get;}
秒の構成要素を表すint
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleIntervalDS構造体の時間間隔を表す合計数を日数で返します。
// C# public double TotalDays {get;}
合計日数を表すdouble
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleIntervalDS構造体に格納されている時間間隔を指定します。
// C# public TimeSpan Value {get;}
時間間隔
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
OracleIntervalDSのメソッドを表5-60に示します。
このメソッドは、現在のOracleIntervalDSインスタンスをオブジェクトと比較し、その相対値を表す整数を返します。
// C# public int CompareTo(object obj);
このメソッドは、次の数値を返します。
OracleIntervalDSがobjより短い時間間隔を表す場合
OracleIntervalDSとobjが同じ時間間隔を表す場合
OracleIntervalDSがobjより長い時間間隔を表す場合
IComparable
ArgumentException: objパラメータがOracleIntervalDS型ではありません。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalDS同士で行う必要があります。たとえば、OracleIntervalDSインスタンスとOracleBinaryインスタンスを比較することはできません。OracleIntervalDSを異なる型と比較すると、ArgumentExceptionがスローされます。
OracleIntervalDSは、null値を持つOracleIntervalDSより大きいことになります。
OracleIntervalDSがnull値を持つ場合、2つは等しいことになります。
このメソッドは、指定されたオブジェクトが現在のインスタンスと同じ時間間隔を持つかどうかを判断します。
// C# public override bool Equals(object obj);
objがOracleIntervalDS型で、現在のインスタンスと同じ時間間隔を持つ場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleIntervalDSは、null値を持つOracleIntervalDSより大きいことになります。
OracleIntervalDSがnull値を持つ場合、2つは等しいことになります。
Objectをオーバーライドします。
このメソッドは、OracleIntervalDSインスタンスのハッシュ・コードを返します。
// C# public override int GetHashCode();
Objectをオーバーライドします。
このメソッドは、現在のOracleIntervalDS構造体を文字列に変換します。
// C# public override string ToString();
文字列を返します。
現在のインスタンスがnull値を持つ場合、返される文字列にはnullが含まれます。
|
|
![]() Copyright © 2002, 2003 Oracle Corporation. All Rights Reserved. |
|