ヘッダーをスキップ

Oracle® Data Provider for .NET開発者ガイド
リリース9.2.0.4

部品番号 B13807-01
Go To Table Of Contents
目次
Go To Index
索引

Go to previous page Go to beginning of chapter Go to next page

Oracle.DataAccess.Typesネームスペース(ODP.NET型)、8/19


OracleTimeStamp構造体

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のメンバーを次の表に示します。

OracleTimeStampのコンストラクタ

OracleTimeStampのコンストラクタを表5-87に示します。

表5-87 OracleTimeStampのコンストラクタ
コンストラクタ 説明

OracleTimeStampのコンストラクタ

OracleTimeStamp構造体の新規インスタンスをインスタンス化します(オーバーロード)。

OracleTimeStampのstaticフィールド

OracleTimeStampのstaticフィールドを表5-88に示します。

表5-88 OracleTimeStampのstaticフィールド
フィールド 説明

MaxValue

OracleTimeStamp構造体の有効日付の最大値を表します。最大値は9999年12月31日の23:59:59.999999999です。

MinValue

OracleTimeStamp構造体の有効日付の最小値を表します。最小値は-4712年1月1日の0:0:0です。

Null

OracleTimeStamp構造体のインスタンスに割り当てられるnull値を表します。

OracleTimeStampのstaticメソッド

OracleTimeStampのstaticメソッドを表5-89に示します。

表5-89 OracleTimeStampのstaticメソッド
メソッド 説明

Equals

2つのOracleTimeStamp値が等しいかどうかを判断します(オーバーロード)。

GreaterThan

2つのOracleTimeStamp値の1つ目の値が2つ目の値より大きいかどうかを判断します。

GreaterThanOrEqual

2つのOracleTimeStamp値の1つ目の値が2つ目の値以上かどうかを判断します。

LessThan

2つのOracleTimeStamp値の1つ目の値が2つ目の値より小さいかどうかを判断します。

LessThanOrEqual

2つのOracleTimeStamp値の1つ目の値が2つ目の値以下かどうかを判断します。

NotEquals

2つのOracleTimeStamp値が等しくないかどうかを判断します。

GetSysDate

現在の日時を表すOracleTimeStamp構造体を取得します。

Parse

OracleTimeStamp構造体を取得し、指定された文字列を使用してその値を設定します。

SetPrecision

指定された小数秒の精度でOracleTimeStampの新規インスタンスを返します。

OracleTimeStampのstatic演算子

OracleTimeStampのstatic演算子を表5-90に示します。

表5-90 OracleTimeStampのstatic演算子
演算子 説明

operator +

指定されたインスタンス値を指定されたOracleTimeStampに加算し、新しいOracleTimeStamp構造体を返します(オーバーロード)。

operator ==

2つのOracleTimeStamp値が等しいかどうかを判断します。

operator >

2つのOracleTimeStamp値の1つ目の値が2つ目の値より大きいかどうかを判断します。

operator >=

2つのOracleTimeStamp値の1つ目の値が2つ目の値以上かどうかを判断します。

operator !=

2つのOracleTimeStamp値が等しくないかどうかを判断します。

operator <

2つのOracleTimeStamp値の1つ目の値が2つ目の値より小さいかどうかを判断します。

operator <=

2つのOracleTimeStamp値の1つ目の値が2つ目の値以下かどうかを判断します。

operator -

指定されたインスタンス値を指定されたOracleTimeStampから減算し、新しいOracleTimeStamp構造体を返します(オーバーロード)。

OracleTimeStampのstatic型変換

OracleTimeStampのstatic型変換を表5-91に示します。

表5-91 OracleTimeStampのstatic型変換
演算子 説明

explicit operator OracleTimeStamp

インスタンス値をOracleTimeStamp構造体に変換します(オーバーロード)。

implicit operator OracleTimeStamp

インスタンス値をOracleTimeStamp構造体に変換します(オーバーロード)。

explicit operator DateTime

OracleTimeStamp値をDateTime構造体に変換します。

OracleTimeStampのプロパティ

OracleTimeStampのプロパティを表5-92に示します。

表5-92 OracleTimeStampのプロパティ
プロパティ 説明

BinData

OracleのTIMESTAMPをOracleの内部形式で表すバイト配列を返します。

Day

OracleTimeStampの日の構成要素を指定します。

IsNull

OracleTimeStampインスタンスがnull値を持つかどうかを示します。

Hour

OracleTimeStampの時の構成要素を指定します。

Millisecond

OracleTimeStampのミリ秒の構成要素を指定します。

Minute

OracleTimeStampの分の構成要素を指定します。

Month

OracleTimeStampの月の構成要素を指定します。

Nanosecond

OracleTimeStampのナノ秒の構成要素を指定します。

Second

OracleTimeStampの秒の構成要素を指定します。

Value

OracleTimeStamp構造体に格納されている日時を指定します。

Year

OracleTimeStampの年の構成要素を指定します。

OracleTimeStampのメソッド

OracleTimeStampのメソッドを表5-93に示します。

表5-93 OracleTimeStampのメソッド
メソッド 説明

AddDays

指定された日数を現在のインスタンスに加算します。

AddHours

指定された時間数を現在のインスタンスに加算します。

AddMilliseconds

指定されたミリ秒数を現在のインスタンスに加算します。

AddMinutes

指定された分数を現在のインスタンスに加算します。

AddMonths

指定された月数を現在のインスタンスに加算します。

AddNanoseconds

指定されたナノ秒数を現在のインスタンスに加算します。

AddSeconds

指定された秒数を現在のインスタンスに加算します。

AddYears

指定された年数を現在のインスタンスに加算します。

CompareTo

現在のOracleTimeStampインスタンスをオブジェクトと比較し、その相対値を表す整数を返します。

Equals

オブジェクトが現在のOracleTimeStampインスタンスと同じ日時を持つかどうかを判断します(オーバーロード)。

GetHashCode

OracleTimeStampインスタンスのハッシュ・コードを返します。

GetDaysBetween

OracleTimeStamp値を現在のインスタンスから減算し、指定されたOracleTimeStampと現在のインスタンスとの時間差を表すOracleIntervalDSを返します。

GetYearsBetween

OracleTimeStamp値を現在のインスタンスから減算し、OracleTimeStampと現在のインスタンスとの時間差を表すOracleIntervalYMを返します。

GetType

Objectから継承されます。

ToOracleDate

現在のOracleTimeStamp構造体をOracleDate構造体に変換します。

ToOracleTimeStampLTZ

現在のOracleTimeStamp構造体をOracleTimeStampLTZ構造体に変換します。

ToOracleTimeStampTZ

現在のOracleTimeStamp構造体をOracleTimeStampTZ構造体に変換します。

ToString

現在のOracleTimeStamp構造体を文字列に変換します。

関連項目:

OracleTimeStampのコンストラクタ

OracleTimeStampのコンストラクタは、OracleTimeStamp構造体の新規インスタンスを作成します。

オーバーロード一覧:

OracleTimeStamp(DateTime)

このコンストラクタは、OracleTimeStamp構造体の新規インスタンスを作成し、指定されたDateTime値を使用してその日時の値を設定します。

宣言
// C#
public OracleTimeStamp (DateTime dt);
パラメータ
例外

ArgumentException: 有効なOracleTimeStampの構成にdtパラメータを使用できません。

関連項目:

OracleTimeStamp(string)

このコンストラクタは、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(int, int, int)

このコンストラクタは、OracleTimeStamp構造体の新規インスタンスを作成し、年、月および日を使用してその日付の値を設定します。

宣言
// C#
public OracleTimeStamp(int year, int month, int day);
パラメータ
例外

ArgumentOutOfRangeException: 1つ以上のパラメータの引数値が指定された範囲内の値ではありません。

ArgumentException: 有効なOracleTimeStampの構成にパラメータの引数値を使用できません(つまり、日がその月の範囲内の値ではありません)。

関連項目:

OracleTimeStamp(int, int, int, int, int, int)

このコンストラクタは、OracleTimeStamp構造体の新規インスタンスを作成し、年、月、日、時、分および秒を使用してその日時の値を設定します。

宣言
// C#
public OracleTimeStamp (int year, int month, int day, int hour, int minute, int
second);
パラメータ
例外

ArgumentOutOfRangeException: 1つ以上のパラメータの引数値が指定された範囲内の値ではありません。

ArgumentException: 有効なOracleTimeStampの構成にパラメータの引数値を使用できません(つまり、日がその月の範囲内の値ではありません)。

関連項目:

OracleTimeStamp(int, int, int, int, int, int, double)

このコンストラクタは、OracleTimeStamp構造体の新規インスタンスを作成し、年、月、日、時、分、秒およびミリ秒を使用してその日時の値を設定します。

宣言
// C#
public OracleTimeStamp(int year, int month, int day, int hour, int minute,
 int second, double millisecond);
パラメータ
例外

ArgumentOutOfRangeException: 1つ以上のパラメータの引数値が指定された範囲内の値ではありません。

ArgumentException: 有効なOracleTimeStampの構成にパラメータの引数値を使用できません(つまり、日がその月の範囲内の値ではありません)。

関連項目:

OracleTimeStamp(int, int, int, int, int, int, int)

このコンストラクタは、OracleTimeStamp構造体の新規インスタンスを作成し、年、月、日、時、分、秒およびナノ秒を使用してその日時の値を設定します。

宣言
// C#
public OracleTimeStamp (int year, int month, int day, int hour, int minute, int
second, int nanosecond);
パラメータ
例外

ArgumentOutOfRangeException: 1つ以上のパラメータの引数値が指定された範囲内の値ではありません。

ArgumentException: 有効なOracleTimeStampの構成にパラメータの引数値を使用できません(つまり、日がその月の範囲内の値ではありません)。

関連項目:

OracleTimeStamp(byte [ ])

このコンストラクタは、OracleTimeStamp構造体の新規インスタンスを作成し、指定されたバイト配列にその値を設定します。このバイト配列はOracleのTIMESTAMPの内部形式です。

宣言
// C#
public OracleTimeStamp (byte[] bytes);
パラメータ
例外

ArgumentException: bytesがOracleのTIMESTAMPの内部形式ではないか、有効なOracleのTIMESTAMPではありません。

ArgumentNullException: bytesnullです。

関連項目:

OracleTimeStampのstaticフィールド

OracleTimeStampのstaticフィールドを表5-94に示します。

表5-94 OracleTimeStampのstaticフィールド
フィールド 説明

MaxValue

OracleTimeStamp構造体の有効日付の最大値を表します。最大値は9999年12月31日の23:59:59.999999999です。

MinValue

OracleTimeStamp構造体の有効日付の最小値を表します。最小値は-4712年1月1日の0:0:0です。

Null

OracleTimeStamp構造体のインスタンスに割り当てられるnull値を表します。

関連項目:

MaxValue

このstaticフィールドは、OracleTimeStamp構造体の有効日時の最大値を表します。最大値は9999年12月31日の23:59:59.999999999です。

宣言
// C#
public static readonly OraTimestamp MaxValue;

関連項目:

MinValue

このstaticフィールドは、OracleTimeStamp構造体の有効日時の最小値を表します。最小値は-4712年1月1日の0:0:0です。

宣言
// C#
public static readonly OracleTimeStamp MinValue;

関連項目:

Null

このstaticフィールドは、OracleTimeStamp構造体のインスタンスに割り当てられるnull値を表します。

宣言
// C#
public static readonly OracleTimeStamp Null;

関連項目:

OracleTimeStampのstaticメソッド

OracleTimeStampのstaticメソッドを表5-95に示します。

表5-95 OracleTimeStampのstaticメソッド
メソッド 説明

Equals

2つのOracleTimeStamp値が等しいかどうかを判断します(オーバーロード)。

GreaterThan

2つのOracleTimeStamp値の1つ目の値が2つ目の値より大きいかどうかを判断します。

GreaterThanOrEqual

2つのOracleTimeStamp値の1つ目の値が2つ目の値以上かどうかを判断します。

LessThan

2つのOracleTimeStamp値の1つ目の値が2つ目の値より小さいかどうかを判断します。

LessThanOrEqual

2つのOracleTimeStamp値の1つ目の値が2つ目の値以下かどうかを判断します。

NotEquals

2つのOracleTimeStamp値が等しくないかどうかを判断します。

GetSysDate

現在の日時を表すOracleTimeStamp構造体を取得します。

Parse

OracleTimeStamp構造体を取得し、指定された文字列を使用してその値を設定します。

SetPrecision

指定された小数秒の精度でOracleTimeStampの新規インスタンスを返します。

関連項目:

Equals

このstaticメソッドは、2つのOracleTimeStamp値が等しいかどうかを判断します。

宣言
// C#
public static bool Equals(OracleTimeStamp value1, OracleTimeStamp value2);
パラメータ
戻り値

2つのOracleTimeStamp値が等しい場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

GreaterThan

このstaticメソッドは、2つのOracleTimeStamp値の1つ目の値が2つ目の値より大きいかどうかを判断します。

宣言
// C#
public static bool GreaterThan(OracleTimeStamp value1, OracleTimeStamp value2);
パラメータ
戻り値

2つのOracleTimeStamp値の1つ目の値が2つ目の値より大きい場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

GreaterThanOrEqual

このstaticメソッドは、2つのOracleTimeStamp値の1つ目の値が2つ目の値以上かどうかを判断します。

宣言
// C#
public static bool GreaterThanOrEqual(OracleTimeStamp value1, OracleTimeStamp
value2);
パラメータ
戻り値

2つのOracleTimeStamp値の1つ目の値が2つ目の値以上の場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

LessThan

このstaticメソッドは、2つのOracleTimeStamp値の1つ目の値が2つ目の値より小さいかどうかを判断します。

宣言
// C#
public static bool LessThan(OracleTimeStamp value1, OracleTimeStamp value2);
パラメータ
戻り値

2つのOracleTimeStamp値の1つ目の値が2つ目の値より小さい場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

LessThanOrEqual

このstaticメソッドは、2つのOracleTimeStamp値の1つ目の値が2つ目の値以下かどうかを判断します。

宣言
// C#
public static bool LessThanOrEqual(OracleTimeStamp value1, OracleTimeStamp
value2);
パラメータ
戻り値

2つのOracleTimeStamp値の1つ目の値が2つ目の値以下の場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

NotEquals

このstaticメソッドは、2つのOracleTimeStamp値が等しくないかどうかを判断します。

宣言
// C#
public static bool NotEquals(OracleTimeStamp value1, OracleTimeStamp value2);
パラメータ
戻り値

2つのOracleTimeStamp値が等しくない場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

GetSysDate

このstaticメソッドは、現在の日時を表すOracleTimeStamp構造体を取得します。

宣言
// C#
public static OracleTimeStamp GetSysDate();
戻り値

現在の日時を表すOracleTimeStamp構造体

関連項目:

Parse

この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"

関連項目:

SetPrecision

この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演算子

OracleTimeStampのstatic演算子を表5-96に示します。

表5-96 OracleTimeStampのstatic演算子
演算子 説明

operator +

指定されたインスタンス値を指定されたOracleTimeStampに加算し、新しいOracleTimeStamp構造体を返します(オーバーロード)。

operator ==

2つのOracleTimeStamp値が等しいかどうかを判断します。

operator >

2つのOracleTimeStamp値の1つ目の値が2つ目の値より大きいかどうかを判断します。

operator >=

2つのOracleTimeStamp値の1つ目の値が2つ目の値以上かどうかを判断します。

operator !=

2つのOracleTimeStamp値が等しくないかどうかを判断します。

operator <

2つのOracleTimeStamp値の1つ目の値が2つ目の値より小さいかどうかを判断します。

operator <=

2つのOracleTimeStamp値の1つ目の値が2つ目の値以下かどうかを判断します。

operator -

指定されたインスタンス値を指定されたOracleTimeStampから減算し、新しいOracleTimeStamp構造体を返します(オーバーロード)。

関連項目:

operator +

operator+は、指定されたオブジェクトをOracleTimeStampに加算し、新しいOracleTimeStamp構造体を返します。

オーバーロード一覧:

operator + (OracleTimeStamp, OracleIntervalDS)

このstatic演算子は、指定されたOracleIntervalDSOracleTimeStampに加算し、新しいOracleTimeStamp構造体を返します。

宣言
// C#
public static operator + (OracleTimeStamp value1, OracleIntervalDS value2);
パラメータ
戻り値

OracleTimeStamp

備考

いずれかのパラメータがnull値を持つ場合、返されるOracleTimeStampnull値を持ちます。

関連項目:

operator + (OracleTimeStamp, OracleIntervalYM)

このstatic演算子は、指定されたOracleIntervalYMを指定されたOracleTimeStampに加算し、新しいOracleTimeStamp構造体を返します。

宣言
// C#
public static operator + (OracleTimeStamp value1, OracleIntervalYM value2);
パラメータ
戻り値

OracleTimeStamp

備考

いずれかのパラメータがnull値を持つ場合、返されるOracleTimeStampnull値を持ちます。

関連項目:

operator + (OracleTimeStamp, TimeSpan)

このstatic演算子は、指定されたTimeSpanを指定されたOracleTimeStampに加算し、新しいOracleTimeStamp構造体を返します。

宣言
// C#
public static operator + (OracleTimeStamp value1, TimeSpan value2);
パラメータ
戻り値

OracleTimeStamp

備考

OracleTimeStampインスタンスがnull値を持つ場合、返されるOracleTimeStampnull値を持ちます。

関連項目:

operator ==

このstatic演算子は、2つのOracleTimeStamp値が等しいかどうかを判断します。

宣言
// C#
public static bool operator == (OracleTimeStamp value1, OracleTimeStamp value2);
パラメータ
戻り値

両方の値が同じ場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

operator >

このstatic演算子は、2つのOracleTimeStamp値の1つ目の値が2つ目の値より大きいかどうかを判断します。

宣言
// C#
public static bool operator > (OracleTimeStamp value1, OracleTimeStamp value2);
パラメータ
戻り値

1つ目のOracleTimeStamp値が2つ目の値より大きい場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

operator >=

このstatic演算子は、2つのOracleTimeStamp値の1つ目の値が2つ目の値以上かどうかを判断します。

宣言
// C#
public static bool operator >= (OracleTimeStamp value1, OracleTimeStamp value2);
パラメータ
戻り値

1つ目のOracleTimeStamp値が2つ目の値以上の場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

operator !=

このstatic演算子は、2つのOracleTimeStamp値が等しくないかどうかを判断します。

宣言
// C#
public static bool operator != (OracleTimeStamp value1, OracleTimeStamp value2);
パラメータ
戻り値

2つのOracleTimeStamp値が等しくない場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

operator <

このstatic演算子は、2つのOracleTimeStamp値の1つ目の値が2つ目の値より小さいかどうかを判断します。

宣言
// C#
public static bool operator < (OracleTimeStamp value1, OracleTimeStamp value2);
パラメータ
戻り値

1つ目のOracleTimeStamp値が2つ目の値より小さい場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

operator <=

このstatic演算子は、2つのOracleTimeStamp値の1つ目の値が2つ目の値以下かどうかを判断します。

宣言
// C#
public static bool operator <= (OracleTimeStamp value1, OracleTimeStamp value2);
パラメータ
戻り値

1つ目のOracleTimeStamp値が2つ目の値以下の場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

operator -

operator-は、指定された値を指定されたOracleTimeStamp値から減算し、新しいOracleTimeStamp構造体を返します。

オーバーロード一覧:

operator - (OracleTimeStamp, OracleIntervalDS)

このstatic演算子は、指定されたOracleIntervalDS値を指定されたOracleTimeStamp値から減算し、新しいOracleTimeStamp構造体を返します。

宣言
// C#
public static operator - (OracleTimeStamp value1, OracleIntervalDS value2);
パラメータ
戻り値

OracleTimeStamp構造体

備考

いずれかのパラメータがnull値を持つ場合、返されるOracleTimeStampnull値を持ちます。

関連項目:

operator - (OracleTimeStamp, OracleIntervalYM)

このstatic演算子は、指定されたOracleIntervalYM値を指定されたOracleTimeStamp値から減算し、新しいOracleTimeStamp構造体を返します。

宣言
// C#
public static operator - (OracleTimeStamp value1, OracleIntervalYM value2);
パラメータ
戻り値

OracleTimeStamp構造体

備考

いずれかのパラメータがnull値を持つ場合、返されるOracleTimeStampnull値を持ちます。

関連項目:

operator - (OracleTimeStamp, TimeSpan)

このstatic演算子は、指定されたTimeSpan値を指定されたOracleTimeStamp値から減算し、新しいOracleTimeStamp構造体を返します。

宣言
// C#
public static operator - (OracleTimeStamp value1, TimeSpan value2);
パラメータ
戻り値

OracleTimeStamp構造体

備考

OracleTimeStampインスタンスがnull値を持つ場合、返されるOracleTimeStamp構造体はnull値を持ちます。

関連項目:

OracleTimeStampのstatic型変換

OracleTimeStampのstatic型変換を表5-97に示します。

表5-97 OracleTimeStampのstatic型変換
演算子 説明

explicit operator OracleTimeStamp

インスタンス値をOracleTimeStamp構造体に変換します(オーバーロード)。

implicit operator OracleTimeStamp

インスタンス値をOracleTimeStamp構造体に変換します(オーバーロード)。

explicit operator DateTime

OracleTimeStamp値をDateTime構造体に変換します。

関連項目:

explicit operator OracleTimeStamp

explicit operator OracleTimeStampは、指定された値をOracleTimeStamp構造体に変換します。

オーバーロード一覧:

explicit operator OracleTimeStamp(OracleTimeStampLTZ)

このstatic型変換演算子は、OracleTimeStampLTZ値をOracleTimeStamp構造体に変換します。

宣言
// C#
public static explicit operator OracleTimeStamp(OracleTimeStampLTZ value1);
パラメータ
戻り値

返されるOracleTimeStamp構造体には、OracleTimeStampLTZ構造体の日時が含まれます。

備考

OracleTimeStampLTZ構造体がnull値を持つ場合、返されるOracleTimeStamp構造体もnull値を持ちます。

関連項目:

explicit operator OracleTimeStamp(OracleTimeStampTZ)

このstatic型変換演算子は、OracleTimeStampTZ値をOracleTimeStamp構造体に変換します。

宣言
// C#
public static explicit operator OracleTimeStamp(OracleTimeStampTZ value1);
パラメータ
戻り値

返されるOracleTimeStampには、value1の日時の情報が含まれますが、そのタイム・ゾーンの情報は切り捨てられます。

備考

OracleTimeStampTZ構造体がnull値を持つ場合、返されるOracleTimeStamp構造体もnull値を持ちます。

関連項目:

explicit operator OracleTimeStamp(string)

この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"

関連資料:

implicit operator OracleTimeStamp

このstatic型変換演算子は、値をOracleTimeStamp構造体に変換します。

オーバーロード一覧:

implicit operator OracleTimeStamp(OracleDate)

このstatic型変換演算子は、OracleDate値をOracleTimeStamp構造体に変換します。

宣言
// C#
public static implicit operator OracleTimeStamp (OracleDate value1);
パラメータ
戻り値

OracleDate構造体(value1)の日時を含むOracleTimeStamp構造体

備考

OracleDate構造体がnull値を持つ場合、返されるOracleTimeStamp構造体もnull値を持ちます。

関連項目:

implicit operator OracleTimeStamp(DateTime)

このstatic型変換演算子は、DateTime値をOracleTimeStamp構造体に変換します。

宣言
// C#
public static implicit operator OracleTimeStamp(DateTime value);
パラメータ
戻り値

OracleTimeStamp構造体

関連項目:

explicit operator DateTime

このstatic型変換演算子は、OracleTimeStamp値をDateTime構造体に変換します。

宣言
// C#
public static explicit operator DateTime(OracleTimeStamp value1);
パラメータ
戻り値

現在のインスタンスの日時を含むDateTime

例外

OracleNullValueException: OracleTimeStamp構造体がnull値を持ちます。

備考

OracleTimeStampの精度は、変換時に失われる場合があります。

関連項目:

OracleTimeStampのプロパティ

OracleTimeStampのプロパティを表5-98に示します。

表5-98 OracleTimeStampのプロパティ
プロパティ 説明

BinData

OracleのTIMESTAMPをOracleの内部形式で表すバイト配列を返します。

Day

OracleTimeStampの日の構成要素を指定します。

IsNull

OracleTimeStampインスタンスがnull値を持つかどうかを示します。

Hour

OracleTimeStampの時の構成要素を指定します。

Millisecond

OracleTimeStampのミリ秒の構成要素を指定します。

Minute

OracleTimeStampの分の構成要素を指定します。

Month

OracleTimeStampの月の構成要素を指定します。

Nanosecond

OracleTimeStampのナノ秒の構成要素を指定します。

Second

OracleTimeStampの秒の構成要素を指定します。

Value

OracleTimeStamp構造体に格納されている日時を指定します。

Year

OracleTimeStampの年の構成要素を指定します。

関連項目:

BinData

このプロパティは、OracleのTIMESTAMPをOracleの内部形式で表すバイト配列を返します。

宣言
// C#
public byte[] BinData {get;}
プロパティ値

OracleのTIMESTAMPを内部形式で表すバイト配列

例外

OracleNullValueException: 現在のインスタンスがnull値を持ちます。

関連項目:

Day

このプロパティは、OracleTimeStampの日の構成要素を指定します。

宣言
// C#
public int Day{get;}
プロパティ値

日を表す数値。Dayの範囲は1〜31です。

例外

OracleNullValueException: 現在のインスタンスがnull値を持ちます。

関連項目:

IsNull

このプロパティは、現在のインスタンスがnull値を持つかどうかを示します。

宣言
// C#
public bool IsNull{get;}
プロパティ値

現在のインスタンスがnull値を持つ場合、trueを返します。それ以外の場合、falseを返します。

関連項目:

Hour

このプロパティは、OracleTimeStampの時の構成要素を指定します。

宣言
// C#
public int Hour{get;}
プロパティ値

時を表す数値。Hourの範囲は0〜23です。

例外

OracleNullValueException: 現在のインスタンスがnull値を持ちます。

関連項目:

Millisecond

このプロパティは、OracleTimeStampのミリ秒の構成要素を取得します。

宣言
// C#
public double Millisecond{get;}
プロパティ値

ミリ秒を表す数値。Millisecondの範囲は0〜999.999999です。

例外

OracleNullValueException: 現在のインスタンスがnull値を持ちます。

関連項目:

Minute

このプロパティは、OracleTimeStampの分の構成要素を取得します。

宣言
// C#
public int Minute{get;}
プロパティ値

分を表す数値。Minuteの範囲は0〜59です。

例外

OracleNullValueException: 現在のインスタンスがnull値を持ちます。

関連項目:

Month

このプロパティは、OracleTimeStampの月の構成要素を取得します。

宣言
// C#
public int Month{get;}
プロパティ値

月を表す数値。Monthの範囲は1〜12です。

例外

OracleNullValueException: 現在のインスタンスがnull値を持ちます。

関連項目:

Nanosecond

このプロパティは、OracleTimeStampのナノ秒の構成要素を取得します。

宣言
// C#
public int Nanosecond{get;}
プロパティ値

ナノ秒を表す数値。Nanosecondの範囲は0〜999999999です。

例外

OracleNullValueException: 現在のインスタンスがnull値を持ちます。

関連項目:

Second

このプロパティは、OracleTimeStampの秒の構成要素を取得します。

宣言
// C#
public int Second{get;}
プロパティ値

秒を表す数値。Secondの範囲は0〜59です。

例外

OracleNullValueException: 現在のインスタンスがnull値を持ちます。

関連項目:

Value

このプロパティは、OracleTimeStamp構造体に格納されている日時を指定します。

宣言
// C#
public DateTime Value{get;}
プロパティ値

DateTime

例外

OracleNullValueException: 現在のインスタンスがnull値を持ちます。

関連項目:

Year

このプロパティは、OracleTimeStampの年の構成要素を取得します。

宣言
// C#
public int Year{get;}
プロパティ値

年を表す数値。Yearの範囲は-4712〜9999です。

例外

OracleNullValueException: 現在のインスタンスがnull値を持ちます。

関連項目:

OracleTimeStampのメソッド

OracleTimeStampのメソッドを表5-99に示します。

表5-99 OracleTimeStampのメソッド
メソッド 説明

AddDays

指定された日数を現在のインスタンスに加算します。

AddHours

指定された時間数を現在のインスタンスに加算します。

AddMilliseconds

指定されたミリ秒数を現在のインスタンスに加算します。

AddMinutes

指定された分数を現在のインスタンスに加算します。

AddMonths

指定された月数を現在のインスタンスに加算します。

AddNanoseconds

指定されたナノ秒数を現在のインスタンスに加算します。

AddSeconds

指定された秒数を現在のインスタンスに加算します。

AddYears

指定された年数を現在のインスタンスに加算します。

CompareTo

現在のOracleTimeStampインスタンスをオブジェクトと比較し、その相対値を表す整数を返します。

Equals

オブジェクトが現在のOracleTimeStampインスタンスと同じ日時を持つかどうかを判断します(オーバーロード)。

GetHashCode

OracleTimeStampインスタンスのハッシュ・コードを返します。

GetDaysBetween

OracleTimeStamp値を現在のインスタンスから減算し、指定されたOracleTimeStampと現在のインスタンスとの時間差を表すOracleIntervalDSを返します。

GetYearsBetween

OracleTimeStamp値を現在のインスタンスから減算し、OracleTimeStampと現在のインスタンスとの時間差を表すOracleIntervalYMを返します。

GetType

Objectから継承されます。

ToOracleDate

現在のOracleTimeStamp構造体をOracleDate構造体に変換します。

ToOracleTimeStampLTZ

現在のOracleTimeStamp構造体をOracleTimeStampLTZ構造体に変換します。

ToOracleTimeStampTZ

現在のOracleTimeStamp構造体をOracleTimeStampTZ構造体に変換します。

ToString

現在のOracleTimeStamp構造体を文字列に変換します。

関連項目:

AddDays

このメソッドは、指定された日数を現在のインスタンスに加算します。

宣言
// C#
public OracleTimeStamp AddDays(double days);
パラメータ
戻り値

OracleTimeStamp

例外

ArgumentOutofRangeException: 引数値が指定された範囲内の値ではありません。

OracleNullValueException: 現在のインスタンスがnull値を持ちます。

関連項目:

AddHours

このメソッドは、指定された時間数を現在のインスタンスに加算します。

宣言
// C#
public OracleTimeStamp AddHours(double hours);
パラメータ
戻り値

OracleTimeStamp

例外

ArgumentOutofRangeException: 引数値が指定された範囲内の値ではありません。

OracleNullValueException: 現在のインスタンスがnull値を持ちます。

関連項目:

AddMilliseconds

このメソッドは、指定されたミリ秒数を現在のインスタンスに加算します。

宣言
// C#
public OracleTimeStamp AddMilliseconds(double milliseconds);
パラメータ
戻り値

OracleTimeStamp

例外

ArgumentOutofRangeException: 引数値が指定された範囲内の値ではありません。

OracleNullValueException: 現在のインスタンスがnull値を持ちます。

関連項目:

AddMinutes

このメソッドは、指定された分数を現在のインスタンスに加算します。

宣言
// C#
public OracleTimeStamp AddMinutes(double minutes);
パラメータ
戻り値

OracleTimeStamp

例外

ArgumentOutofRangeException: 引数値が指定された範囲内の値ではありません。

OracleNullValueException: 現在のインスタンスがnull値を持ちます。

関連項目:

AddMonths

このメソッドは、指定された月数を現在のインスタンスに加算します。

宣言
// C#
public OracleTimeStamp AddMonths(long months);
パラメータ
戻り値

OracleTimeStamp

例外

ArgumentOutofRangeException: 引数値が指定された範囲内の値ではありません。

OracleNullValueException: 現在のインスタンスがnull値を持ちます。

関連項目:

AddNanoseconds

このメソッドは、指定されたナノ秒数を現在のインスタンスに加算します。

宣言
// C#
public OracleTimeStamp AddNanoseconds(long nanoseconds);
パラメータ
戻り値

OracleTimeStamp

例外

OracleNullValueException: 現在のインスタンスがnull値を持ちます。

関連項目:

AddSeconds

このメソッドは、指定された秒数を現在のインスタンスに加算します。

宣言
// C#
public OracleTimeStamp AddSeconds(double seconds);
パラメータ
戻り値

OracleTimeStamp

例外

ArgumentOutofRangeException: 引数値が指定された範囲内の値ではありません。

OracleNullValueException: 現在のインスタンスがnull値を持ちます。

関連項目:

AddYears

このメソッドは、指定された年数を現在のインスタンスに加算します。

宣言
// C#
public OracleTimeStamp AddYears(int years);
パラメータ
戻り値

OracleTimeStamp

例外

ArgumentOutofRangeException: 引数値が指定された範囲内の値ではありません。

OracleNullValueException: 現在のインスタンスがnull値を持ちます。

関連項目:

CompareTo

このメソッドは、現在のOracleTimeStampインスタンスをオブジェクトと比較し、その相対値を表す整数を返します。

宣言
// C#
public int CompareTo(object obj);
パラメータ
戻り値

このメソッドは、次の数値を返します。

0より小さい値: 現在のOracleTimeStampインスタンス値がobjの値より小さい場合

0: 現在のOracleTimeStampインスタンスとobjの値が等しい場合

0より大きい値: 現在のOracleTimeStampインスタンス値がobjの値より大きい場合

実装

IComparable

例外

ArgumentException: objパラメータがOracleTimeStamp型ではありません。

備考

このメソッドの動作には、次の規則が適用されます。

Equals

Objectをオーバーライドします。

このメソッドは、オブジェクトが現在のOracleTimeStampインスタンスと同じ日時を持つかどうかを判断します。

宣言
// C#
public override bool Equals(object obj);
パラメータ
戻り値

objOracleTimeStamp型で同じ日時を表す場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

GetHashCode

Objectをオーバーライドします。

このメソッドは、OracleTimeStampインスタンスのハッシュ・コードを返します。

宣言
// C#
public override int GetHashCode();
戻り値

ハッシュ・コードを表す数値

関連項目:

GetDaysBetween

このメソッドは、OracleTimeStamp値を現在のインスタンスから減算し、指定されたOracleTimeStamp構造体と現在のインスタンスとの時間差を表すOracleIntervalDSを返します。

宣言
// C#
public OracleIntervalDS GetDaysBetween(OracleTimeStamp value1);
パラメータ
戻り値

2つのOracleTimeStamp値の時間間隔を表すOracleIntervalDS

備考

現在のインスタンスとパラメータのいずれかがnull値を持つ場合、返されるOracleIntervalDSnull値を持ちます。

関連項目:

GetYearsBetween

このメソッドは、OracleTimeStamp値を現在のインスタンスから減算し、OracleTimeStamp値と現在のインスタンスとの時間差を表すOracleIntervalYMを返します。

宣言
// C#
public OracleIntervalYM GetYearsBetween(OracleTimeStamp value1);
パラメータ
戻り値

2つのOracleTimeStamp値の時間間隔を表すOracleIntervalYM

備考

現在のインスタンスとパラメータのいずれかがnull値を持つ場合、返されるOracleIntervalYMnull値を持ちます。

関連項目:

ToOracleDate

このメソッドは、現在のOracleTimeStamp構造体をOracleDate構造体に変換します。

宣言
// C#
public OracleDate ToOracleDate();
戻り値

返されるOracleDateには、現在のインスタンスの日時が含まれます。

備考

OracleTimeStamp値の精度は、変換時に失われる場合があります。

OracleTimeStampnull値を持つ場合、返されるOracleDate構造体はnull値を持ちます。

関連項目:

ToOracleTimeStampLTZ

このメソッドは、現在のOracleTimeStamp構造体をOracleTimeStampLTZ構造体に変換します。

宣言
// C#
public OracleTimeStampLTZ ToOracleTimeStampLTZ();
戻り値

返されるOracleTimeStampLTZには、現在のインスタンスの日時が含まれます。

備考

現在のインスタンスがnull値を持つ場合、返されるOracleTimeStampLTZ構造体はnull値を持ちます。

関連項目:

ToOracleTimeStampTZ

このメソッドは、現在のOracleTimeStamp構造体をOracleTimeStampTZ構造体に変換します。

宣言
// C#
public OracleTimeStampTZ ToOracleTimeStampTZ();
戻り値

返されるOracleTimeStampTZには、OracleTimeStampの日時およびスレッドのOracleGlobalization.TimeZoneのタイム・ゾーンが含まれます。

備考

現在のインスタンスがnull値を持つ場合、返されるOracleTimeStampTZ構造体はnull値を持ちます。

関連項目:

ToString

Objectをオーバーライドします。

このメソッドは、現在のOracleTimeStamp構造体を文字列に変換します。

宣言
// C#
public override string ToString();
戻り値

現在のOracleTimeStamp構造体と同じ日時を表す文字列

備考

返される値は文字列表現のOracleTimeStampで、スレッドのOracleGlobalization.TimeStampFormatプロパティによって指定された書式です。

月および日に使用される名前および略称には、スレッドのOracleGlobalizationDateLanguageプロパティおよび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"

関連項目:


Go to previous page Go to beginning of chapter Go to next page
Oracle
Copyright © 2002, 2003 Oracle Corporation.

All Rights Reserved.
Go To Table Of Contents
目次
Go To Index
索引