| Oracle® Data Provider for .NET開発者ガイド リリース9.2.0.4 部品番号 B13807-01 |
|
Oracle.DataAccess.Typesネームスペース(ODP.NET型)、8/19
OracleTimeStamp構造体は、データベースに対して格納または取得されるOracleのTIMESTAMPデータ型を表します。各OracleTimeStampには、年、月、日、時、分、秒およびナノ秒の情報が格納されています。
Object
ValueType
OracleTimeStamp
// C# public struct OracleTimeStamp : IComparable
インスタンス・メソッドではスレッド・セーフティを保証しませんが、すべてのpublic staticメソッドはスレッド・セーフです。
// C# // Illustrates usage of OracleTimeStamp OracleTimeStamp tsCurrent1 = OracleTimeStamp.GetSysDate(); OracleTimeStamp tsCurrent2 = DateTime.Now; // Calculate the difference between tsCurrent1 and tsCurrent2 OracleIntervalDS idsDiff = tsCurrent2.GetDaysBetween(tsCurrent1); // Calculate the difference using AddNanoseconds() int nanoDiff = 0; while (tsCurrent2 > tsCurrent1) { nanoDiff += 10; tsCurrent1 = tsCurrent1.AddNanoseconds(10); } Console.WriteLine("idsDiff.Nanoseconds = " + idsDiff.Nanoseconds); Console.WriteLine("nanoDiff = " + nanoDiff);
ネームスペース: Oracle.DataAccess.Types
アセンブリ: Oracle.DataAccess.dll
OracleTimeStampのメンバーを次の表に示します。
OracleTimeStampのコンストラクタを表5-87に示します。
| コンストラクタ | 説明 |
|---|---|
|
OracleTimeStamp構造体の新規インスタンスをインスタンス化します(オーバーロード)。 |
OracleTimeStampのstaticフィールドを表5-88に示します。
| フィールド | 説明 |
|---|---|
|
|
|
|
|
|
|
|
OracleTimeStampのstaticメソッドを表5-89に示します。
OracleTimeStampのstatic演算子を表5-90に示します。
OracleTimeStampのstatic型変換を表5-91に示します。
| 演算子 | 説明 |
|---|---|
|
インスタンス値を |
|
|
インスタンス値を |
|
|
|
OracleTimeStampのプロパティを表5-92に示します。
OracleTimeStampのメソッドを表5-93に示します。
OracleTimeStampのコンストラクタは、OracleTimeStamp構造体の新規インスタンスを作成します。
このコンストラクタは、OracleTimeStamp構造体の新規インスタンスを作成し、指定されたDateTime値を使用してその日時の値を設定します。
このコンストラクタは、OracleTimeStamp構造体の新規インスタンスを作成し、指定された文字列を使用してその値を設定します。
このコンストラクタは、OracleTimeStamp構造体の新規インスタンスを作成し、年、月および日を使用してその日付の値を設定します。
このコンストラクタは、OracleTimeStamp構造体の新規インスタンスを作成し、年、月、日、時、分および秒を使用してその日時の値を設定します。
このコンストラクタは、OracleTimeStamp構造体の新規インスタンスを作成し、年、月、日、時、分、秒およびミリ秒を使用してその日時の値を設定します。
このコンストラクタは、OracleTimeStamp構造体の新規インスタンスを作成し、年、月、日、時、分、秒およびナノ秒を使用してその日時の値を設定します。
このコンストラクタは、OracleTimeStamp構造体の新規インスタンスを作成し、指定されたバイト配列にその値を設定します。このバイト配列はOracleのTIMESTAMPの内部形式です。
このコンストラクタは、OracleTimeStamp構造体の新規インスタンスを作成し、指定されたDateTime値を使用してその日時の値を設定します。
// C# public OracleTimeStamp (DateTime dt);
ArgumentException: 有効なOracleTimeStampの構成にdtパラメータを使用できません。
このコンストラクタは、OracleTimeStamp構造体の新規インスタンスを作成し、指定された文字列を使用してその値を設定します。
// C# public OracleTimeStamp (string tsStr);
ArgumentException: 指定されたtsStr値が無効な文字列表現のOracleのTIMESTAMPであるか、スレッドのOracleGlobalization.TimeStampFormatプロパティ(OracleのNLS_TIMESTAMP_FORMATパラメータを表す)によって指定されたタイムスタンプ書式ではありません。
ArgumentNullException: tsStr値がnullです。
月および日に使用される名前および略称には、スレッドのOracleGlobalizationオブジェクトのDateLanguageプロパティおよびCalendarプロパティによって指定された言語が使用されます。スレッドのグローバリゼーション・プロパティがnullまたは空の文字列に設定されている場合、クライアント・コンピュータの設定が使用されます。
// C# // Set the nls_timestamp_format for the OracleTimeStamp(string) constructor OracleGlobalization og = OracleGlobalization.GetClientInfo(); og.TimeStampFormat = "DD-MON-YYYY HH:MI:SS.FF AM"; OracleGlobalization.SetThreadInfo(og); // construct OracleTimeStamp from a string using the format specified. OracleTimeStamp ts = new OracleTimeStamp("11-NOV-1999 11:02:33.444 AM"); // Set the nls_timestamp_format for the ToString() method og.TimeStampFormat = "YYYY-MON-DD HH:MI:SS.FF AM"; OracleGlobalization.SetThreadInfo(og); Console.WriteLine(ts.ToString()); // Prints "1999-NOV-11 11:02:33.444000000 AM"
| 関連資料:
|
このコンストラクタは、OracleTimeStamp構造体の新規インスタンスを作成し、年、月および日を使用してその日付の値を設定します。
// C# public OracleTimeStamp(int year, int month, int day);
ArgumentOutOfRangeException: 1つ以上のパラメータの引数値が指定された範囲内の値ではありません。
ArgumentException: 有効なOracleTimeStampの構成にパラメータの引数値を使用できません(つまり、日がその月の範囲内の値ではありません)。
このコンストラクタは、OracleTimeStamp構造体の新規インスタンスを作成し、年、月、日、時、分および秒を使用してその日時の値を設定します。
// C# public OracleTimeStamp (int year, int month, int day, int hour, int minute, int second);
year
指定された年。yearの範囲は-4712〜9999です。
month
指定された月。monthの範囲は1〜12です。
day
指定された日。dayの範囲は1〜31です。
hour
指定された時。hourの範囲は0〜23です。
minute
指定された分。minuteの範囲は0〜59です。
second
指定された秒。secondの範囲は0〜59です。
ArgumentOutOfRangeException: 1つ以上のパラメータの引数値が指定された範囲内の値ではありません。
ArgumentException: 有効なOracleTimeStampの構成にパラメータの引数値を使用できません(つまり、日がその月の範囲内の値ではありません)。
このコンストラクタは、OracleTimeStamp構造体の新規インスタンスを作成し、年、月、日、時、分、秒およびミリ秒を使用してその日時の値を設定します。
// C# public OracleTimeStamp(int year, int month, int day, int hour, int minute, int second, double millisecond);
year
指定された年。yearの範囲は-4712〜9999です。
month
指定された月。monthの範囲は1〜12です。
day
指定された日。dayの範囲は1〜31です。
hour
指定された時。hourの範囲は0〜23です。
minute
指定された分。minuteの範囲は0〜59です。
second
指定された秒。secondの範囲は0〜59です。
milliSeconds
指定されたミリ秒。millisecondの範囲は0〜999.999999です。
ArgumentOutOfRangeException: 1つ以上のパラメータの引数値が指定された範囲内の値ではありません。
ArgumentException: 有効なOracleTimeStampの構成にパラメータの引数値を使用できません(つまり、日がその月の範囲内の値ではありません)。
このコンストラクタは、OracleTimeStamp構造体の新規インスタンスを作成し、年、月、日、時、分、秒およびナノ秒を使用してその日時の値を設定します。
// C#
public OracleTimeStamp (int year, int month, int day, int hour, int minute, int
second, int nanosecond);
year
指定された年。yearの範囲は-4712〜9999です。
month
指定された月。monthの範囲は1〜12です。
day
指定された日。dayの範囲は1〜31です。
hour
指定された時。hourの範囲は0〜23です。
minute
指定された分。minuteの範囲は0〜59です。
second
指定された秒。secondの範囲は0〜59です。
nanosecond
指定されたナノ秒。nanosecondの範囲は0〜999999999です。
ArgumentOutOfRangeException: 1つ以上のパラメータの引数値が指定された範囲内の値ではありません。
ArgumentException: 有効なOracleTimeStampの構成にパラメータの引数値を使用できません(つまり、日がその月の範囲内の値ではありません)。
このコンストラクタは、OracleTimeStamp構造体の新規インスタンスを作成し、指定されたバイト配列にその値を設定します。このバイト配列はOracleのTIMESTAMPの内部形式です。
// C#
public OracleTimeStamp (byte[] bytes);
ArgumentException: bytesがOracleのTIMESTAMPの内部形式ではないか、有効なOracleのTIMESTAMPではありません。
ArgumentNullException: bytesがnullです。
OracleTimeStampのstaticフィールドを表5-94に示します。
| フィールド | 説明 |
|---|---|
|
|
|
|
|
|
|
|
このstaticフィールドは、OracleTimeStamp構造体の有効日時の最大値を表します。最大値は9999年12月31日の23:59:59.999999999です。
// C# public static readonly OraTimestamp MaxValue;
このstaticフィールドは、OracleTimeStamp構造体の有効日時の最小値を表します。最小値は-4712年1月1日の0:0:0です。
// C# public static readonly OracleTimeStamp MinValue;
このstaticフィールドは、OracleTimeStamp構造体のインスタンスに割り当てられるnull値を表します。
// C# public static readonly OracleTimeStamp Null;
OracleTimeStampのstaticメソッドを表5-95に示します。
このstaticメソッドは、2つのOracleTimeStamp値が等しいかどうかを判断します。
// C# public static bool Equals(OracleTimeStamp value1, OracleTimeStamp value2);
2つのOracleTimeStamp値が等しい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampは、null値を持つOracleTimeStampより大きいことになります。
OracleTimeStampがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、2つのOracleTimeStamp値の1つ目の値が2つ目の値より大きいかどうかを判断します。
// C# public static bool GreaterThan(OracleTimeStamp value1, OracleTimeStamp value2);
2つのOracleTimeStamp値の1つ目の値が2つ目の値より大きい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampは、null値を持つOracleTimeStampより大きいことになります。
OracleTimeStampがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、2つのOracleTimeStamp値の1つ目の値が2つ目の値以上かどうかを判断します。
// C# public static bool GreaterThanOrEqual(OracleTimeStamp value1, OracleTimeStamp value2);
2つのOracleTimeStamp値の1つ目の値が2つ目の値以上の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampは、null値を持つOracleTimeStampより大きいことになります。
OracleTimeStampがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、2つのOracleTimeStamp値の1つ目の値が2つ目の値より小さいかどうかを判断します。
// C# public static bool LessThan(OracleTimeStamp value1, OracleTimeStamp value2);
2つのOracleTimeStamp値の1つ目の値が2つ目の値より小さい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampは、null値を持つOracleTimeStampより大きいことになります。
OracleTimeStampがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、2つのOracleTimeStamp値の1つ目の値が2つ目の値以下かどうかを判断します。
// C# public static bool LessThanOrEqual(OracleTimeStamp value1, OracleTimeStamp value2);
2つのOracleTimeStamp値の1つ目の値が2つ目の値以下の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampは、null値を持つOracleTimeStampより大きいことになります。
OracleTimeStampがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、2つのOracleTimeStamp値が等しくないかどうかを判断します。
// C# public static bool NotEquals(OracleTimeStamp value1, OracleTimeStamp value2);
2つのOracleTimeStamp値が等しくない場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampは、null値を持つOracleTimeStampより大きいことになります。
OracleTimeStampがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、現在の日時を表すOracleTimeStamp構造体を取得します。
// C# public static OracleTimeStamp GetSysDate();
現在の日時を表すOracleTimeStamp構造体
このstaticメソッドは、OracleTimeStamp構造体を取得し、指定された文字列を使用してその値を設定します。
// C# public static OracleTimeStamp Parse(string datetime);
OracleTimeStamp構造体
ArgumentException: 指定されたtsStrが無効な文字列表現のOracleのTIMESTAMPであるか、スレッドのOracleGlobalization.TimeStampFormatプロパティ(OracleのNLS_TIMESTAMP_FORMATパラメータを表す)によって指定されたタイムスタンプ書式ではありません。
ArgumentNullException: tsStr値がnullです。
月および日に使用される名前および略称には、スレッドのOracleGlobalizationオブジェクトのDateLanguageプロパティおよびCalendarプロパティによって指定された言語が使用されます。スレッドのグローバリゼーション・プロパティがnullまたは空の文字列に設定されている場合、クライアント・コンピュータの設定が使用されます。
// C# // Set the nls_timestamp_format for the Parse() method OracleGlobalization og = OracleGlobalization.GetClientInfo(); og.TimeStampFormat = "DD-MON-YYYY HH:MI:SS.FF AM"; OracleGlobalization.SetThreadInfo(og); // construct OracleTimeStamp from a string using the format specified. OracleTimeStamp ts = OracleTimeStamp.Parse("11-NOV-1999 11:02:33.444 AM"); // Set the nls_timestamp_format for the ToString() method og.TimeStampFormat = "YYYY-MON-DD HH:MI:SS.FF AM"; OracleGlobalization.SetThreadInfo(og); Console.WriteLine(ts.ToString()); // Prints "1999-NOV-11 11:02:33.444000000 AM"
このstaticメソッドは、指定された小数秒の精度でOracleTimeStampの新規インスタンスを返します。
// C# public static OracleTimeStamp SetPrecision(OracleTimeStamp value1, int fracSecPrecision);
指定された小数秒の精度のOracleTimeStamp構造体
ArgumentOutOfRangeException: fracSecPrecisionが指定された範囲内にありません。
指定されたfracSecPrecisionに設定される値を使用し、指定されたOracleTimeStamp値に対して四捨五入の操作が実行されます。この値に応じて、0個以上の後続ゼロがToString()によって返される文字列に表示されます。
値"December 31, 9999 23:59:59.99"のOracleTimeStampは、小数秒の精度を5に設定してSetPrecision()をコールした場合、文字列"December 31, 9999 23:59:59.99000"という結果になります。
OracleTimeStampのstatic演算子を表5-96に示します。
operator+は、指定されたオブジェクトをOracleTimeStampに加算し、新しいOracleTimeStamp構造体を返します。
このstatic演算子は、指定されたOracleIntervalDSをOracleTimeStampに加算し、新しいOracleTimeStamp構造体を返します。
このstatic演算子は、指定されたOracleIntervalYMを指定されたOracleTimeStampに加算し、新しいOracleTimeStamp構造体を返します。
このstatic演算子は、指定されたTimeSpanを指定されたOracleTimeStampに加算し、新しいOracleTimeStamp構造体を返します。
このstatic演算子は、指定されたOracleIntervalDSをOracleTimeStampに加算し、新しいOracleTimeStamp構造体を返します。
// C# public static operator + (OracleTimeStamp value1, OracleIntervalDS value2);
OracleTimeStamp
いずれかのパラメータがnull値を持つ場合、返されるOracleTimeStampはnull値を持ちます。
このstatic演算子は、指定されたOracleIntervalYMを指定されたOracleTimeStampに加算し、新しいOracleTimeStamp構造体を返します。
// C# public static operator + (OracleTimeStamp value1, OracleIntervalYM value2);
OracleTimeStamp
いずれかのパラメータがnull値を持つ場合、返されるOracleTimeStampはnull値を持ちます。
このstatic演算子は、指定されたTimeSpanを指定されたOracleTimeStampに加算し、新しいOracleTimeStamp構造体を返します。
// C# public static operator + (OracleTimeStamp value1, TimeSpan value2);
OracleTimeStamp
OracleTimeStampインスタンスがnull値を持つ場合、返されるOracleTimeStampはnull値を持ちます。
このstatic演算子は、2つのOracleTimeStamp値が等しいかどうかを判断します。
// C# public static bool operator == (OracleTimeStamp value1, OracleTimeStamp value2);
両方の値が同じ場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampは、null値を持つOracleTimeStampより大きいことになります。
OracleTimeStampがnull値を持つ場合、2つは等しいことになります。
このstatic演算子は、2つのOracleTimeStamp値の1つ目の値が2つ目の値より大きいかどうかを判断します。
// C# public static bool operator > (OracleTimeStamp value1, OracleTimeStamp value2);
1つ目のOracleTimeStamp値が2つ目の値より大きい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampは、null値を持つOracleTimeStampより大きいことになります。
OracleTimeStampがnull値を持つ場合、2つは等しいことになります。
このstatic演算子は、2つのOracleTimeStamp値の1つ目の値が2つ目の値以上かどうかを判断します。
// C# public static bool operator >= (OracleTimeStamp value1, OracleTimeStamp value2);
1つ目のOracleTimeStamp値が2つ目の値以上の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampは、null値を持つOracleTimeStampより大きいことになります。
OracleTimeStampがnull値を持つ場合、2つは等しいことになります。
このstatic演算子は、2つのOracleTimeStamp値が等しくないかどうかを判断します。
// C# public static bool operator != (OracleTimeStamp value1, OracleTimeStamp value2);
2つのOracleTimeStamp値が等しくない場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampは、null値を持つOracleTimeStampより大きいことになります。
OracleTimeStampがnull値を持つ場合、2つは等しいことになります。
このstatic演算子は、2つのOracleTimeStamp値の1つ目の値が2つ目の値より小さいかどうかを判断します。
// C# public static bool operator < (OracleTimeStamp value1, OracleTimeStamp value2);
1つ目のOracleTimeStamp値が2つ目の値より小さい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampは、null値を持つOracleTimeStampより大きいことになります。
OracleTimeStampがnull値を持つ場合、2つは等しいことになります。
このstatic演算子は、2つのOracleTimeStamp値の1つ目の値が2つ目の値以下かどうかを判断します。
// C# public static bool operator <= (OracleTimeStamp value1, OracleTimeStamp value2);
1つ目のOracleTimeStamp値が2つ目の値以下の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampは、null値を持つOracleTimeStampより大きいことになります。
OracleTimeStampがnull値を持つ場合、2つは等しいことになります。
operator-は、指定された値を指定されたOracleTimeStamp値から減算し、新しいOracleTimeStamp構造体を返します。
このstatic演算子は、指定されたOracleIntervalDS値を指定されたOracleTimeStamp値から減算し、新しいOracleTimeStamp構造体を返します。
このstatic演算子は、指定されたOracleIntervalYM値を指定されたOracleTimeStamp値から減算し、新しいOracleTimeStamp構造体を返します。
このstatic演算子は、指定されたTimeSpan値を指定されたOracleTimeStamp値から減算し、新しいOracleTimeStamp構造体を返します。
このstatic演算子は、指定されたOracleIntervalDS値を指定されたOracleTimeStamp値から減算し、新しいOracleTimeStamp構造体を返します。
// C# public static operator - (OracleTimeStamp value1, OracleIntervalDS value2);
OracleTimeStamp構造体
いずれかのパラメータがnull値を持つ場合、返されるOracleTimeStampはnull値を持ちます。
このstatic演算子は、指定されたOracleIntervalYM値を指定されたOracleTimeStamp値から減算し、新しいOracleTimeStamp構造体を返します。
// C# public static operator - (OracleTimeStamp value1, OracleIntervalYM value2);
OracleTimeStamp構造体
いずれかのパラメータがnull値を持つ場合、返されるOracleTimeStampはnull値を持ちます。
このstatic演算子は、指定されたTimeSpan値を指定されたOracleTimeStamp値から減算し、新しいOracleTimeStamp構造体を返します。
// C# public static operator - (OracleTimeStamp value1, TimeSpan value2);
OracleTimeStamp構造体
OracleTimeStampインスタンスがnull値を持つ場合、返されるOracleTimeStamp構造体はnull値を持ちます。
OracleTimeStampのstatic型変換を表5-97に示します。
| 演算子 | 説明 |
|---|---|
|
インスタンス値を |
|
|
インスタンス値を |
|
|
|
explicit operator OracleTimeStampは、指定された値をOracleTimeStamp構造体に変換します。
このstatic型変換演算子は、OracleTimeStampLTZ値をOracleTimeStamp構造体に変換します。
このstatic型変換演算子は、OracleTimeStampTZ値をOracleTimeStamp構造体に変換します。
このstatic型変換演算子は、指定された文字列をOracleTimeStamp構造体に変換します。
このstatic型変換演算子は、OracleTimeStampLTZ値をOracleTimeStamp構造体に変換します。
// C# public static explicit operator OracleTimeStamp(OracleTimeStampLTZ value1);
返されるOracleTimeStamp構造体には、OracleTimeStampLTZ構造体の日時が含まれます。
OracleTimeStampLTZ構造体がnull値を持つ場合、返されるOracleTimeStamp構造体もnull値を持ちます。
このstatic型変換演算子は、OracleTimeStampTZ値をOracleTimeStamp構造体に変換します。
// C# public static explicit operator OracleTimeStamp(OracleTimeStampTZ value1);
返されるOracleTimeStampには、value1の日時の情報が含まれますが、そのタイム・ゾーンの情報は切り捨てられます。
OracleTimeStampTZ構造体がnull値を持つ場合、返されるOracleTimeStamp構造体もnull値を持ちます。
このstatic型変換演算子は、指定された文字列をOracleTimeStamp構造体に変換します。
// C# public static explicit operator OracleTimeStamp(string tsStr);
OracleTimeStamp
ArgumentException: tsStrが無効な文字列表現のOracleのTIMESTAMPであるか、スレッドのOracleGlobalization.TimeStampFormatプロパティ(OracleのNLS_TIMESTAMP_FORMATパラメータを表す)によって指定されたタイムスタンプ書式ではありません。
月および日に使用される名前および略称には、スレッドのOracleGlobalizationオブジェクトのDateLanguageプロパティおよびCalendarプロパティによって指定された言語が使用されます。スレッドのグローバリゼーション・プロパティがnullまたは空の文字列に設定されている場合、クライアント・コンピュータの設定が使用されます。
// C# // Set the nls_timestamp_format for the explicit operator // OracleTimeStamp(string) OracleGlobalization og = OracleGlobalization.GetClientInfo(); og.TimeStampFormat = "DD-MON-YYYY HH:MI:SS.FF AM"; OracleGlobalization.SetThreadInfo(og); // construct OracleTimeStamp from a string using the format specified. OracleTimeStamp ts = new OracleTimeStamp("11-NOV-1999 11:02:33.444 AM"); // Set the nls_timestamp_format for the ToString method og.TimeStampFormat = "YYYY-MON-DD HH:MI:SS.FF AM"; OracleGlobalization.SetThreadInfo(og); Console.WriteLine(ts.ToString()); // Prints "1999-NOV-11 11:02:33.444000000 AM"
| 関連資料:
|
このstatic型変換演算子は、値をOracleTimeStamp構造体に変換します。
このstatic型変換演算子は、OracleDate値をOracleTimeStamp構造体に変換します。
このstatic型変換演算子は、DateTime値をOracleTimeStamp構造体に変換します。
このstatic型変換演算子は、OracleDate値をOracleTimeStamp構造体に変換します。
// C# public static implicit operator OracleTimeStamp (OracleDate value1);
OracleDate構造体(value1)の日時を含むOracleTimeStamp構造体
OracleDate構造体がnull値を持つ場合、返されるOracleTimeStamp構造体もnull値を持ちます。
このstatic型変換演算子は、DateTime値をOracleTimeStamp構造体に変換します。
// C# public static implicit operator OracleTimeStamp(DateTime value);
OracleTimeStamp構造体
このstatic型変換演算子は、OracleTimeStamp値をDateTime構造体に変換します。
// C# public static explicit operator DateTime(OracleTimeStamp value1);
現在のインスタンスの日時を含むDateTime
OracleNullValueException: OracleTimeStamp構造体がnull値を持ちます。
OracleTimeStampの精度は、変換時に失われる場合があります。
OracleTimeStampのプロパティを表5-98に示します。
このプロパティは、OracleのTIMESTAMPをOracleの内部形式で表すバイト配列を返します。
// C# public byte[] BinData {get;}
OracleのTIMESTAMPを内部形式で表すバイト配列
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleTimeStampの日の構成要素を指定します。
// C# public int Day{get;}
日を表す数値。Dayの範囲は1〜31です。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、現在のインスタンスがnull値を持つかどうかを示します。
// C# public bool IsNull{get;}
現在のインスタンスがnull値を持つ場合、trueを返します。それ以外の場合、falseを返します。
このプロパティは、OracleTimeStampの時の構成要素を指定します。
// C# public int Hour{get;}
時を表す数値。Hourの範囲は0〜23です。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleTimeStampのミリ秒の構成要素を取得します。
// C# public double Millisecond{get;}
ミリ秒を表す数値。Millisecondの範囲は0〜999.999999です。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleTimeStampの分の構成要素を取得します。
// C# public int Minute{get;}
分を表す数値。Minuteの範囲は0〜59です。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleTimeStampの月の構成要素を取得します。
// C# public int Month{get;}
月を表す数値。Monthの範囲は1〜12です。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleTimeStampのナノ秒の構成要素を取得します。
// C# public int Nanosecond{get;}
ナノ秒を表す数値。Nanosecondの範囲は0〜999999999です。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleTimeStampの秒の構成要素を取得します。
// C# public int Second{get;}
秒を表す数値。Secondの範囲は0〜59です。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleTimeStamp構造体に格納されている日時を指定します。
// C# public DateTime Value{get;}
DateTime
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleTimeStampの年の構成要素を取得します。
// C# public int Year{get;}
年を表す数値。Yearの範囲は-4712〜9999です。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
OracleTimeStampのメソッドを表5-99に示します。
このメソッドは、指定された日数を現在のインスタンスに加算します。
// C# public OracleTimeStamp AddDays(double days);
OracleTimeStamp
ArgumentOutofRangeException: 引数値が指定された範囲内の値ではありません。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このメソッドは、指定された時間数を現在のインスタンスに加算します。
// C# public OracleTimeStamp AddHours(double hours);
OracleTimeStamp
ArgumentOutofRangeException: 引数値が指定された範囲内の値ではありません。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このメソッドは、指定されたミリ秒数を現在のインスタンスに加算します。
// C# public OracleTimeStamp AddMilliseconds(double milliseconds);
OracleTimeStamp
ArgumentOutofRangeException: 引数値が指定された範囲内の値ではありません。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このメソッドは、指定された分数を現在のインスタンスに加算します。
// C# public OracleTimeStamp AddMinutes(double minutes);
OracleTimeStamp
ArgumentOutofRangeException: 引数値が指定された範囲内の値ではありません。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このメソッドは、指定された月数を現在のインスタンスに加算します。
// C# public OracleTimeStamp AddMonths(long months);
OracleTimeStamp
ArgumentOutofRangeException: 引数値が指定された範囲内の値ではありません。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このメソッドは、指定されたナノ秒数を現在のインスタンスに加算します。
// C# public OracleTimeStamp AddNanoseconds(long nanoseconds);
OracleTimeStamp
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このメソッドは、指定された秒数を現在のインスタンスに加算します。
// C# public OracleTimeStamp AddSeconds(double seconds);
OracleTimeStamp
ArgumentOutofRangeException: 引数値が指定された範囲内の値ではありません。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このメソッドは、指定された年数を現在のインスタンスに加算します。
// C# public OracleTimeStamp AddYears(int years);
OracleTimeStamp
ArgumentOutofRangeException: 引数値が指定された範囲内の値ではありません。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このメソッドは、現在のOracleTimeStampインスタンスをオブジェクトと比較し、その相対値を表す整数を返します。
// C# public int CompareTo(object obj);
このメソッドは、次の数値を返します。
0より小さい値: 現在のOracleTimeStampインスタンス値がobjの値より小さい場合
0: 現在のOracleTimeStampインスタンスとobjの値が等しい場合
0より大きい値: 現在のOracleTimeStampインスタンス値がobjの値より大きい場合
IComparable
ArgumentException: objパラメータがOracleTimeStamp型ではありません。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStamp同士で行う必要があります。たとえば、OracleTimeStampインスタンスとOracleBinaryインスタンスを比較することはできません。OracleTimeStampを異なる型と比較すると、ArgumentExceptionがスローされます。
OracleTimeStampは、null値を持つOracleTimeStampより大きいことになります。
OracleTimeStampがnull値を持つ場合、2つは等しいことになります。
Objectをオーバーライドします。
このメソッドは、オブジェクトが現在のOracleTimeStampインスタンスと同じ日時を持つかどうかを判断します。
// C# public override bool Equals(object obj);
objがOracleTimeStamp型で同じ日時を表す場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampは、null値を持つOracleTimeStampより大きいことになります。
OracleTimeStampがnull値を持つ場合、2つは等しいことになります。
Objectをオーバーライドします。
このメソッドは、OracleTimeStampインスタンスのハッシュ・コードを返します。
// C# public override int GetHashCode();
ハッシュ・コードを表す数値
このメソッドは、OracleTimeStamp値を現在のインスタンスから減算し、指定されたOracleTimeStamp構造体と現在のインスタンスとの時間差を表すOracleIntervalDSを返します。
// C# public OracleIntervalDS GetDaysBetween(OracleTimeStamp value1);
2つのOracleTimeStamp値の時間間隔を表すOracleIntervalDS
現在のインスタンスとパラメータのいずれかがnull値を持つ場合、返されるOracleIntervalDSはnull値を持ちます。
このメソッドは、OracleTimeStamp値を現在のインスタンスから減算し、OracleTimeStamp値と現在のインスタンスとの時間差を表すOracleIntervalYMを返します。
// C# public OracleIntervalYM GetYearsBetween(OracleTimeStamp value1);
2つのOracleTimeStamp値の時間間隔を表すOracleIntervalYM
現在のインスタンスとパラメータのいずれかがnull値を持つ場合、返されるOracleIntervalYMはnull値を持ちます。
このメソッドは、現在のOracleTimeStamp構造体をOracleDate構造体に変換します。
// C# public OracleDate ToOracleDate();
返されるOracleDateには、現在のインスタンスの日時が含まれます。
OracleTimeStamp値の精度は、変換時に失われる場合があります。
OracleTimeStampがnull値を持つ場合、返されるOracleDate構造体はnull値を持ちます。
このメソッドは、現在のOracleTimeStamp構造体をOracleTimeStampLTZ構造体に変換します。
// C# public OracleTimeStampLTZ ToOracleTimeStampLTZ();
返されるOracleTimeStampLTZには、現在のインスタンスの日時が含まれます。
現在のインスタンスがnull値を持つ場合、返されるOracleTimeStampLTZ構造体はnull値を持ちます。
このメソッドは、現在のOracleTimeStamp構造体をOracleTimeStampTZ構造体に変換します。
// C# public OracleTimeStampTZ ToOracleTimeStampTZ();
返されるOracleTimeStampTZには、OracleTimeStampの日時およびスレッドのOracleGlobalization.TimeZoneのタイム・ゾーンが含まれます。
現在のインスタンスがnull値を持つ場合、返されるOracleTimeStampTZ構造体はnull値を持ちます。
Objectをオーバーライドします。
このメソッドは、現在のOracleTimeStamp構造体を文字列に変換します。
// C# public override string ToString();
現在のOracleTimeStamp構造体と同じ日時を表す文字列
返される値は文字列表現のOracleTimeStampで、スレッドのOracleGlobalization.TimeStampFormatプロパティによって指定された書式です。
月および日に使用される名前および略称には、スレッドのOracleGlobalizationのDateLanguageプロパティおよびCalendarプロパティによって指定された言語が使用されます。スレッドのグローバリゼーション・プロパティがnullまたは空の文字列に設定されている場合、クライアント・コンピュータの設定が使用されます。
// C# // Set the nls_timestamp_format for the OracleTimeStamp(string)constructor OracleGlobalization og = OracleGlobalization.GetClientInfo(); og.TimeStampFormat = "DD-MON-YYYY HH:MI:SS.FF AM"; OracleGlobalization.SetThreadInfo(og); // construct OracleTimeStamp from a string using the format specified. OracleTimeStamp ts = new OracleTimeStamp("11-NOV-1999 11:02:33.444 AM"); // Set the nls_timestamp_format for the ToString() method og.TimeStampFormat = "YYYY-MON-DD HH:MI:SS.FF AM"; OracleGlobalization.SetThreadInfo(og); Console.WriteLine(ts.ToString()); // Prints "1999-NOV-11 11:02:33.444000000 AM"
|
|
![]() Copyright © 2002, 2003 Oracle Corporation. All Rights Reserved. |
|