OracleTimeStamp
構造は、データベースに格納されるか、またはデータベースから取得されるOracle TIMESTAMP
データ型を表します。各OracleTimeStamp
には、年、月、日、時、分、秒およびナノ秒の情報が格納されます。
クラスの継承
System.Object
System.ValueType
Oracle.DataAccess.Types.OracleTimeStamp
宣言
// ADO.NET 2.0: C#public struct OracleTimeStamp : IComparable, INullable, IXmlSerializable
スレッド安全性
パブリック静的メソッドはスレッドセーフですが、インスタンス・メソッドではスレッド安全性は保証されません。
例
// C# using System; using Oracle.DataAccess.Types; class OracleTimeStampSample { static void Main() { 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
ODP.NETのバージョン: ODP.NET for .NET Framework 2.0またはODP.NET for .NET Framework 4
次の表に、OracleTimeStamp
メンバーを示します。
OracleTimeStampコンストラクタ
OracleTimeStamp
コンストラクタを、表14-87にリストします。
OracleTimeStamp静的フィールド
OracleTimeStamp
静的フィールドを、表14-88にリストします。
表14-88 OracleTimeStamp静的フィールド
フィールド | 説明 |
---|---|
|
|
|
|
|
OracleTimeStamp静的メソッド
OracleTimeStamp
静的メソッドを、表14-89にリストします。
表14-89 OracleTimeStamp静的メソッド
メソッド | 説明 |
---|---|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
現在の日時を表す |
|
|
|
指定された小数秒精度を使用して、 |
OracleTimeStamp静的演算子
OracleTimeStamp
静的演算子を、表14-90にリストします。
表14-90 OracleTimeStamp静的演算子
演算子 | 説明 |
---|---|
指定されたインスタンス値を指定された |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
指定されたインスタンス値を指定された |
OracleTimeStamp静的型変換
OracleTimeStamp
静的型変換を、表14-91にリストします。
表14-91 OracleTimeStamp静的型変換
演算子 | 説明 |
---|---|
インスタンス値を |
|
インスタンス値を |
|
|
OracleTimeStampプロパティ
OracleTimeStamp
プロパティを、表14-92にリストします。
表14-92 OracleTimeStampプロパティ
プロパティ | 説明 |
---|---|
Oracleの内部書式でOracle |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
OracleTimeStampメソッド
OracleTimeStamp
メソッドを、表14-93にリストします。
表14-93 OracleTimeStampメソッド
メソッド | 説明 |
---|---|
指定された日数を現行インスタンスに追加します |
|
指定された時間数を現行インスタンスに追加します |
|
指定されたミリ秒数を現行インスタンスに追加します |
|
指定された分数を現行インスタンスに追加します |
|
指定された月数を現行インスタンスに追加します |
|
指定されたナノ秒数を現行インスタンスに追加します |
|
指定された秒数を現行インスタンスに追加します |
|
指定された年数を現行インスタンスに追加します |
|
現行の |
|
オブジェクトに現行の |
|
|
|
現行インスタンスから |
|
現行インスタンスから |
|
GetType |
|
現行の |
|
現行の |
|
現行の |
|
現行の |
OracleTimeStamp
コンストラクタは、OracleTimeStamp
構造の新しいインスタンスを作成します。
オーバーロード・リスト:
このコンストラクタは、OracleTimeStamp
構造の新しいインスタンスを作成し、指定されたDateTime
値を使用して日付および時刻の値を設定します。
このコンストラクタは、OracleTimeStamp
構造の新しいインスタンスを作成し、指定された文字列を使用して値を設定します。
OracleTimeStamp(int, int, int)
このコンストラクタは、OracleTimeStamp
構造の新しいインスタンスを作成し、年、月および日を使用して日付の値を設定します。
OracleTimeStamp(int, int, int, int, int, int)
このコンストラクタは、OracleTimeStamp
構造の新しいインスタンスを作成し、年、月、日、時間、分および秒を使用して、日付と時刻の値を設定します。
OracleTimeStamp(int, int, int, int, int, int, double)
このコンストラクタは、OracleTimeStamp
構造の新しいインスタンスを作成し、年、月、日、時間、分、秒およびミリ秒を使用して、日付と時刻の値を設定します。
OracleTimeStamp(int, int, int, int, int, int, int)
このコンストラクタは、OracleTimeStamp
構造の新しいインスタンスを作成し、年、月、日、時間、分、秒およびナノ秒を使用して、日付と時刻の値を設定します。
このコンストラクタは、OracleTimeStamp
構造の新しいインスタンスを作成し、指定されたバイト配列に値を設定します。バイト配列は、Oracle TIMESTAMP
内部形式です。
このコンストラクタは、OracleTimeStamp
構造の新しいインスタンスを作成し、指定されたDateTime
値を使用して日付および時刻の値を設定します。
宣言
// C#
public OracleTimeStamp (DateTime dt);
パラメータ
dt
指定されたDateTime
値
例外
ArgumentException
- dt
パラメータを使用して、有効なOracleTimeStamp
を作成することはできません。
このコンストラクタは、OracleTimeStamp
構造の新しいインスタンスを作成し、指定された文字列を使用して値を設定します。
宣言
// C#
public OracleTimeStamp (string tsStr);
パラメータ
tsStr
Oracle TIMESTAMP
を表す文字列
例外
ArgumentException
- tsStr
値がOracle TIMESTAMP
の無効な文字列表現か、指定されたtsStr
が、スレッドのOracleGlobalization
.TimeStampFormat
プロパティで指定されたタイムスタンプの形式ではありません。このプロパティは、Oracle NLS_TIMESTAMP_FORMAT
パラメータを表します。
ArgumentNullException
- tsStr
値はNULLです。
備考
月および日付に使用されている名称および略称は、スレッドのOracleGlobalization
オブジェクトのDateLanguage
およびCalendar
プロパティで指定されている言語による表記です。スレッドのグローバリゼーション・プロパティのいずれかがNULLまたは空の文字列に設定されている場合、クライアントのコンピュータの設定が使用されます。
例
// C# using System; using Oracle.DataAccess.Types; using Oracle.DataAccess.Client; class OracleTimeStampSample { static void Main() { // Set the nls_timestamp_format for the OracleTimeStamp(string) // constructor OracleGlobalization info = OracleGlobalization.GetClientInfo(); info.TimeStampFormat = "DD-MON-YYYY HH:MI:SS.FF AM"; OracleGlobalization.SetThreadInfo(info); // 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 info.TimeStampFormat = "YYYY-MON-DD HH:MI:SS.FF AM"; OracleGlobalization.SetThreadInfo(info); // Prints "1999-NOV-11 11:02:33.444000000 AM" Console.WriteLine(ts.ToString()); } }
関連項目:
|
このコンストラクタは、OracleTimeStamp
構造の新しいインスタンスを作成し、年、月および日を使用して日付の値を設定します。
宣言
// C# public OracleTimeStamp(int year, int month, int day);
パラメータ
year
指定された年。year
の範囲は(-4712から9999)です。
month
指定された月。month
の範囲は(1から12)です。
day
指定された日付。day
の範囲は(1から31)です。
例外
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
の範囲は(0から23)です。
分
指定された分。minute
の範囲は(0から59)です。
秒
指定された秒。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
の範囲は(0から23)です。
分
指定された分。minute
の範囲は(0から59)です。
秒
指定された秒。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
の範囲は(0から23)です。
分
指定された分。minute
の範囲は(0から59)です。
秒
指定された秒。second
の範囲は(0から59)です。
ナノ秒
指定されたナノ秒。nanosecond
の範囲は(0から999999999)です。
例外
ArgumentOutOfRangeException
- 1つ以上のパラメータの引数が、指定範囲を超えています。
ArgumentException
- パラメータの引数値を使用して、有効なOracleTimeStamp
を作成することはできません(つまり、日が月の範囲を超えています)。
このコンストラクタは、OracleTimeStamp
構造の新しいインスタンスを作成し、指定されたバイト配列に値を設定します。バイト配列は、Oracle TIMESTAMP
内部形式です。
宣言
// C#
public
OracleTimeStamp (byte[] bytes);
パラメータ
bytes
Oracle内部形式でOracle TIMESTAMP
を表すバイト配列
例外
ArgumentException
- bytes
がOracle TIMESTAMP
内部形式ではないか、bytes
が有効なOracle TIMESTAMP
ではありません。
ArgumentNullException
- bytes
がNULLです。
OracleTimeStamp
静的フィールドを、表14-94にリストします。
表14-94 OracleTimeStamp静的フィールド
フィールド | 説明 |
---|---|
|
|
|
|
|
この静的フィールドは、OracleTimeStamp
構造の最大有効日時、9999年12月31日23時59分59.999999999秒を表します。
宣言
// C# public static readonly OraTimestamp MaxValue;
この静的フィールドは、OracleTimeStamp
構造の最小有効日時、-4712年1月1日0時0分0秒を表します。
宣言
// C# public static readonly OracleTimeStamp MinValue;
OracleTimeStamp
静的メソッドを、表14-95にリストします。
表14-95 OracleTimeStamp静的メソッド
メソッド | 説明 |
---|---|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
現在の日時を表す |
|
|
|
指定された小数秒精度を使用して、 |
この静的メソッドは、2つのOracleTimeStamp
値が等しいかどうかを決定します。
宣言
// C# public static bool Equals(OracleTimeStamp value1, OracleTimeStamp value2);
パラメータ
value1
最初のOracleTimeStamp
value2
2番目のOracleTimeStamp
戻り値
2つのOracleTimeStamp
値が等しい場合はtrue
、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStamp
は、NULL値を持つOracleTimeStamp
より大きくなります。
NULL値を含む2つのOracleTimeStamp
は等しくなります。
この静的メソッドは、2つのOracleTimeStamp
の最初の値が、2番目の値より大きいかどうかを決定します。
宣言
// C# public static bool GreaterThan(OracleTimeStamp value1, OracleTimeStamp value2);
パラメータ
value1
最初のOracleTimeStamp
value2
2番目のOracleTimeStamp
戻り値
2つのOracleTimeStamp
の最初の値が2番目の値より大きい場合はtrue
、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStamp
は、NULL値を持つOracleTimeStamp
より大きくなります。
NULL値を含む2つのOracleTimeStamp
は等しくなります。
この静的メソッドは、2つのOracleTimeStamp
の最初の値が、2番目の値以上かどうかを決定します。
宣言
// C# public static bool GreaterThanOrEqual(OracleTimeStamp value1, OracleTimeStamp value2);
パラメータ
value1
最初のOracleTimeStamp
value2
2番目のOracleTimeStamp
戻り値
2つのOracleTimeStamp
の最初の値が2番目の値以上の場合はtrue
、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStamp
は、NULL値を持つOracleTimeStamp
より大きくなります。
NULL値を含む2つのOracleTimeStamp
は等しくなります。
この静的メソッドは、2つのOracleTimeStamp
の最初の値が、2番目の値より小さいかどうかを決定します。
宣言
// C# public static bool LessThan(OracleTimeStamp value1, OracleTimeStamp value2);
パラメータ
value1
最初のOracleTimeStamp
value2
2番目のOracleTimeStamp
戻り値
2つのOracleTimeStamp
の最初の値が2番目の値より小さい場合は、true
を戻します。それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStamp
は、NULL値を持つOracleTimeStamp
より大きくなります。
NULL値を含む2つのOracleTimeStamp
は等しくなります。
この静的メソッドは、2つのOracleTimeStamp
の最初の値が、2番目の値以下かどうかを決定します。
宣言
// C# public static bool LessThanOrEqual(OracleTimeStamp value1, OracleTimeStamp value2);
パラメータ
value1
最初のOracleTimeStamp
value2
2番目のOracleTimeStamp
戻り値
2つのOracleTimeStamp
の最初の値が2番目の値以下の場合は、true
を戻します。それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStamp
は、NULL値を持つOracleTimeStamp
より大きくなります。
NULL値を含む2つのOracleTimeStamp
は等しくなります。
この静的メソッドは、2つのOracleTimeStamp
値が等しくないかどうかを決定します。
宣言
// C# public static bool NotEquals(OracleTimeStamp value1, OracleTimeStamp value2);
パラメータ
value1
最初のOracleTimeStamp
value2
2番目のOracleTimeStamp
戻り値
2つのOracleTimeStamp
値が等しくない場合は、true
を戻します。それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStamp
は、NULL値を持つOracleTimeStamp
より大きくなります。
NULL値を含む2つのOracleTimeStamp
は等しくなります。
この静的メソッドは、現在の日付と時刻を表すOracleTimeStamp
構造を取得します。
宣言
// C# public static OracleTimeStamp GetSysDate();
戻り値
現在の日付と時刻を表すOracleTimeStamp
構造
この静的メソッドは、OracleTimeStamp
構造を取得し、指定された文字列を使用して値を設定します。
宣言
// C#
public static OracleTimeStamp Parse(string datetime);
パラメータ
datetime
Oracle TIMESTAMP
を表す文字列
戻り値
OracleTimeStamp
構造
例外
ArgumentException
- tsStr
がOracle TIMESTAMP
の無効な文字列表現か、指定されたtsStr
が、スレッドのOracleGlobalization
.TimeStampFormat
プロパティで指定されたタイムスタンプの形式ではありません。このプロパティは、Oracle NLS_TIMESTAMP_FORMAT
パラメータを表します。
ArgumentNullException
- tsStr
値はNULLです。
備考
月および日付に使用されている名称および略称は、スレッドのOracleGlobalization
オブジェクトのDateLanguage
およびCalendar
プロパティで指定されている言語による表記です。スレッドのグローバリゼーション・プロパティのいずれかがNULLまたは空の文字列に設定されている場合、クライアントのコンピュータの設定が使用されます。
例
// C# using System; using Oracle.DataAccess.Types; using Oracle.DataAccess.Client; class ParseSample { static void Main() { // Set the nls_timestamp_format for the Parse() method OracleGlobalization info = OracleGlobalization.GetClientInfo(); info.TimeStampFormat = "DD-MON-YYYY HH:MI:SS.FF AM"; OracleGlobalization.SetThreadInfo(info); // 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 info.TimeStampFormat = "YYYY-MON-DD HH:MI:SS.FF AM"; OracleGlobalization.SetThreadInfo(info); // Prints "1999-NOV-11 11:02:33.444000000 AM" Console.WriteLine(ts.ToString()); } }
この静的メソッドは、指定された小数秒精度でOracleTimeStamp
の新規インスタンスを戻します。
宣言
// C# public static OracleTimeStamp SetPrecision(OracleTimeStamp value1, int fracSecPrecision);
パラメータ
value1
指定するOracleTimeStamp
オブジェクト
fracSecPrecision
指定された小数秒精度。小数秒精度の範囲は(0から9)です。
戻り値
指定された小数秒精度でのOracleTimeStamp
構造
例外
ArgumentOutOfRangeException
- fracSecPrecision
が指定範囲を超えています。
備考
fracSecPrecision
に指定する値は、OracleTimeStamp
値の丸め処理に使用されます。この値に応じて、ToString()
によって戻される文字列に、後続のゼロが0
個以上表示されます。
例
OracleTimeStamp
の値がDecember
31,
9999
23:59:59.99
である場合、小数秒精度を5
に設定してSetPrecision()
をコールすると、文字列December
31,
9999
23:59:59.99000
が戻されます。
OracleTimeStamp
静的演算子を、表14-96にリストします。
表14-96 OracleTimeStamp静的演算子
演算子 | 説明 |
---|---|
|
指定されたインスタンス値を指定された |
|
2つの |
|
2つの |
|
2つの |
2つの |
|
2つの |
|
2つの |
|
|
指定されたインスタンス値を指定された |
operator+
は、OracleTimeStamp
に指定されたオブジェクトを加えて、新しいOracleTimeStamp
構造を戻します。
オーバーロード・リスト:
operator + (OracleTimeStamp, OracleIntervalDS)
この静的演算子は、指定されたOracleTimeStamp
に指定されたOracleIntervalDS
を加えて、新しいOracleTimeStamp
構造を戻します。
operator + (OracleTimeStamp, OracleIntervalYM)
この静的演算子は、指定されたOracleTimeStamp
に指定されたOracleIntervalYM
を加えて、新しいOracleTimeStamp
構造を戻します。
operator + (OracleTimeStamp, TimeSpan)
この静的演算子は、指定されたOracleTimeStamp
に指定されたTimeSpan
を加えて、新しいOracleTimeStamp
構造を戻します。
この静的演算子は、指定されたOracleTimeStamp
に指定されたOracleIntervalDS
を加えて、新しいOracleTimeStamp
構造を戻します。
宣言
// C# public static operator + (OracleTimeStamp value1, OracleIntervalDS value2);
パラメータ
value1
OracleTimeStamp
value2
OracleIntervalDS
戻り値
OracleTimeStamp
備考
パラメータのいずれかにNULL値がある場合、戻されたOracleTimeStamp
にはNULL値があります。
この静的演算子は、指定されたOracleTimeStamp
に指定されたOracleIntervalYM
を加えて、新しいOracleTimeStamp
構造を戻します。
宣言
// C# public static operator + (OracleTimeStamp value1, OracleIntervalYM value2);
パラメータ
value1
OracleTimeStamp
value2
OracleIntervalYM
戻り値
OracleTimeStamp
備考
パラメータのいずれかにNULL値がある場合、戻されたOracleTimeStamp
にはNULL値があります。
この静的演算子は、指定されたOracleTimeStamp
に指定されたTimeSpan
を加えて、新しいOracleTimeStamp
構造を戻します。
宣言
// C# public static operator + (OracleTimeStamp value1, TimeSpan value2);
パラメータ
value1
OracleTimeStamp
value2
TimeSpan
戻り値
OracleTimeStamp
備考
OracleTimeStamp
インスタンスにNULL値がある場合、戻されたOracleTimeStamp
にもNULL値があります。
この静的演算子は、2つのOracleTimeStamp
値が等しいかどうかを決定します。
宣言
// C# public static bool operator == (OracleTimeStamp value1, OracleTimeStamp value2);
パラメータ
value1
最初のOracleTimeStamp
value2
2番目のOracleTimeStamp
戻り値
これらの値が等しい場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStamp
は、NULL値を持つOracleTimeStamp
より大きくなります。
NULL値を含む2つのOracleTimeStamp
は等しくなります。
この静的演算子は、2つのOracleTimeStamp
の最初の値が、2番目の値より大きいかどうかを決定します。
宣言
// C# public static bool operator > (OracleTimeStamp value1, OracleTimeStamp value2);
パラメータ
value1
最初のOracleTimeStamp
value2
2番目のOracleTimeStamp
戻り値
最初のOracleTimeStamp
値が2番目の値より大きい場合はtrue
、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStamp
は、NULL値を持つOracleTimeStamp
より大きくなります。
NULL値を含む2つのOracleTimeStamp
は等しくなります。
この静的演算子は、2つのOracleTimeStamp
の最初の値が、2番目の値以上かどうかを決定します。
宣言
// C# public static bool operator >= (OracleTimeStamp value1, OracleTimeStamp value2);
パラメータ
value1
最初のOracleTimeStamp
value2
2番目のOracleTimeStamp
戻り値
最初のOracleTimeStamp
が2番目の値以上の場合はtrue
、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStamp
は、NULL値を持つOracleTimeStamp
より大きくなります。
NULL値を含む2つのOracleTimeStamp
は等しくなります。
この静的演算子は、2つのOracleTimeStamp
値が等しくないかどうかを決定します。
宣言
// C# public static bool operator != (OracleTimeStamp value1, OracleTimeStamp value2);
パラメータ
value1
最初のOracleTimeStamp
value2
2番目のOracleTimeStamp
戻り値
2つのOracleTimeStamp
値が等しくない場合はtrue
、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStamp
は、NULL値を持つOracleTimeStamp
より大きくなります。
NULL値を含む2つのOracleTimeStamp
は等しくなります。
この静的演算子は、2つのOracleTimeStamp
の最初の値が、2番目の値より小さいかどうかを決定します。
宣言
// C# public static bool operator < (OracleTimeStamp value1, OracleTimeStamp value2);
パラメータ
value1
最初のOracleTimeStamp
value2
2番目のOracleTimeStamp
戻り値
最初のOracleTimeStamp
が2番目の値より小さい場合はtrue
、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStamp
は、NULL値を持つOracleTimeStamp
より大きくなります。
NULL値を含む2つのOracleTimeStamp
は等しくなります。
この静的演算子は、2つのOracleTimeStamp
の最初の値が、2番目の値以下かどうかを決定します。
宣言
// C# public static bool operator <= (OracleTimeStamp value1, OracleTimeStamp value2);
パラメータ
value1
最初のOracleTimeStamp
value2
2番目のOracleTimeStamp
戻り値
最初のOracleTimeStamp
が2番目の値以下の場合はtrue
、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStamp
は、NULL値を持つOracleTimeStamp
より大きくなります。
NULL値を含む2つのOracleTimeStamp
は等しくなります。
operator-
は、指定されたOracleTimeStamp
から指定された値を引いて、新しいOracleTimeStamp
構造を戻します。
オーバーロード・リスト:
operator - (OracleTimeStamp, OracleIntervalDS)
この静的演算子は、指定されたOracleTimeStamp
から指定されたOracleIntervalDS
値を引いて、新しいOracleTimeStamp
構造を戻します。
operator - (OracleTimeStamp, OracleIntervalYM)
この静的演算子は、指定されたOracleTimeStamp
から指定されたOracleIntervalYM
値を引いて、新しいOracleTimeStamp
構造を戻します。
operator - (OracleTimeStamp, TimeSpan)
この静的演算子は、指定されたOracleTimeStamp
から指定されたTimeSpan
値を引いて、新しいOracleTimeStamp
構造を戻します。
この静的演算子は、指定されたOracleTimeStamp
から指定されたOracleIntervalDS
値を引いて、新しいOracleTimeStamp
構造を戻します。
宣言
// C# public static operator - (OracleTimeStamp value1, OracleIntervalDS value2);
パラメータ
value1
OracleTimeStamp
value2
OracleIntervalDS
インスタンス
戻り値
OracleTimeStamp
構造
備考
パラメータのいずれかにNULL値がある場合、戻されたOracleTimeStamp
にはNULL値があります。
この静的演算子は、指定されたOracleTimeStamp
から指定されたOracleIntervalYM
値を引いて、新しいOracleTimeStamp
構造を戻します。
宣言
// C# public static operator - (OracleTimeStamp value1, OracleIntervalYM value2);
パラメータ
value1
OracleTimeStamp
value2
OracleIntervalYM
インスタンス
戻り値
OracleTimeStamp
構造
備考
パラメータのいずれかにNULL値がある場合、戻されたOracleTimeStamp
にはNULL値があります。
この静的演算子は、指定されたOracleTimeStamp
から指定されたTimeSpan
値を引いて、新しいOracleTimeStamp
構造を戻します。
宣言
// C# public static operator - (OracleTimeStamp value1, TimeSpan value2);
パラメータ
value1
OracleTimeStamp
value2
TimeSpan
インスタンス
戻り値
OracleTimeStamp
構造
備考
OracleTimeStamp
インスタンスにNULL値がある場合、戻されたOracleTimeStamp
構造にもNULL値があります。
OracleTimeStamp
静的型変換を、表14-97にリストします。
表14-97 OracleTimeStamp静的型変換
演算子 | 説明 |
---|---|
インスタンス値を |
|
インスタンス値を |
|
|
explicit operator OracleTimeStamp
は、指定された値をOracleTimeStamp
構造に変換します。
オーバーロード・リスト:
explicit operator OracleTimeStamp(OracleTimeStampLTZ)
この静的な型変換演算子は、OracleTimeStampLTZ
値をOracleTimeStamp
構造に変換します。
explicit operator OracleTimeStamp(OracleTimeStampTZ)
この静的な型変換演算子は、OracleTimeStampTZ
値をOracleTimeStamp
構造に変換します。
explicit operator OracleTimeStamp(string)
この静的な型変換演算子は、指定された文字列をOracleTimeStamp
構造に変換します。
この静的な型変換演算子は、OracleTimeStampLTZ
値をOracleTimeStamp
構造に変換します。
宣言
// C#
public static explicit operator OracleTimeStamp(OracleTimeStampLTZ value1);
パラメータ
value1
OracleTimeStampLTZ
インスタンス
戻り値
戻されたOracleTimeStamp
には、OracleTimeStampLTZ
構造の日付と時刻が含まれます。
備考
OracleTimeStampLTZ
構造にNULL値がある場合、戻されたOracleTimeStamp
構造にもNULL値があります。
この静的な型変換演算子は、OracleTimeStampTZ
値をOracleTimeStamp
構造に変換します。
宣言
// C#
public static explicit operator OracleTimeStamp(OracleTimeStampTZ value1);
パラメータ
value1
OracleTimeStampTZ
インスタンス
戻り値
戻されたOracleTimeStamp
には、value1
からの日付および時刻の情報が含まれますが、value1
からのタイムゾーン情報は切り捨てられます。
備考
OracleTimeStampTZ
構造にNULL値がある場合、戻されたOracleTimeStamp
構造にもNULL値があります。
この静的な型変換演算子は、指定された文字列をOracleTimeStamp
構造に変換します。
宣言
// C#
public static explicit operator OracleTimeStamp(string tsStr);
パラメータ
tsStr
Oracle TIMESTAMP
の文字列表現
戻り値
OracleTimeStamp
例外
ArgumentException
- tsStr
がOracle TIMESTAMP
の無効な文字列表現か、tsStr
が、スレッドのOracleGlobalization
.TimeStampFormat
プロパティで指定されたタイムスタンプの形式ではありません。このプロパティは、Oracle NLS_TIMESTAMP_FORMAT
パラメータを表します。
備考
月および日付に使用されている名称および略称は、スレッドのOracleGlobalization
オブジェクトのDateLanguage
およびCalendar
プロパティで指定されている言語による表記です。スレッドのグローバリゼーション・プロパティのいずれかがNULLまたは空の文字列に設定されている場合、クライアントのコンピュータの設定が使用されます。
例
// C# using System; using Oracle.DataAccess.Types; using Oracle.DataAccess.Client; class OracleTimeStampSample { static void Main() { // Set the nls_timestamp_format for the explicit // operator OracleTimeStamp(string) OracleGlobalization info = OracleGlobalization.GetClientInfo(); info.TimeStampFormat = "DD-MON-YYYY HH:MI:SS.FF AM"; OracleGlobalization.SetThreadInfo(info); // 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 info.TimeStampFormat = "YYYY-MON-DD HH:MI:SS.FF AM"; OracleGlobalization.SetThreadInfo(info); // Prints "1999-NOV-11 11:02:33.444000000 AM" Console.WriteLine(ts.ToString()); } }
関連項目:
|
この静的な型変換演算子は、値をOracleTimeStamp
構造に変換します。
オーバーロード・リスト:
implicit operator OracleTimeStamp(OracleDate)
この静的な型変換演算子は、OracleDate
値をOracleTimeStamp
構造に変換します。
implicit operator OracleTimeStamp(DateTime)
この静的な型変換演算子は、DateTime
値をOracleTimeStamp
構造に変換します。
この静的な型変換演算子は、OracleDate
値をOracleTimeStamp
構造に変換します。
宣言
// C#
public static implicit operator OracleTimeStamp (OracleDate value1);
パラメータ
value1
OracleDate
インスタンス
戻り値
OracleDate
構造、value1
の日付と時刻を含むOracleTimeStamp
構造
備考
OracleDate
構造にNULL値がある場合、戻されたOracleTimeStamp
構造にもNULL値があります。
この静的な型変換演算子は、DateTime
値をOracleTimeStamp
構造に変換します。
宣言
// C#
public static implicit operator OracleTimeStamp(DateTime value);
パラメータ
value
DateTime
インスタンス
戻り値
OracleTimeStamp
構造
この静的な型変換演算子は、OracleTimeStamp
値をDateTime
構造に変換します。
宣言
// C#
public static explicit operator DateTime(OracleTimeStamp value1);
パラメータ
value1
OracleTimeStamp
インスタンス
戻り値
現行インスタンスの日付と時刻を含むDateTime
例外
OracleNullValueException
- OracleTimeStamp
構造にNULL値があります。
備考
OracleTimeStamp
の精度は、変換時に失われる可能性があります。
OracleTimeStamp
プロパティを、表14-98にリストします。
表14-98 OracleTimeStampプロパティ
プロパティ | 説明 |
---|---|
Oracleの内部書式でOracle |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
このプロパティは、Oracle内部形式でOracle TIMESTAMP
を表すバイトの配列を戻します。
宣言
// 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
メソッドを、表14-99にリストします。
表14-99 OracleTimeStampメソッド
メソッド | 説明 |
---|---|
指定された日数を現行インスタンスに追加します |
|
指定された時間数を現行インスタンスに追加します |
|
指定されたミリ秒数を現行インスタンスに追加します |
|
指定された分数を現行インスタンスに追加します |
|
指定された月数を現行インスタンスに追加します |
|
指定されたナノ秒数を現行インスタンスに追加します |
|
指定された秒数を現行インスタンスに追加します |
|
指定された年数を現行インスタンスに追加します |
|
現行の |
|
オブジェクトに現行の |
|
|
|
現行インスタンスから |
|
現行インスタンスから |
|
GetType |
|
現行の |
|
現行の |
|
現行の |
|
現行の |
このメソッドは、現行インスタンスに指定された日数を加えます。
宣言
// C#
public OracleTimeStamp AddDays(double days);
パラメータ
days
指定された日数。範囲は(-1,000,000,000 < days
< 1,000,000,000)です。
戻り値
OracleTimeStamp
例外
ArgumentOutofRangeException
- 引数値が指定範囲を超えています。
OracleNullValueException
- 現行インスタンスにはNULL値があります。
このメソッドは、現行インスタンスに指定された時間数を加えます。
宣言
// C#
public OracleTimeStamp AddHours(double hours);
パラメータ
hours
指定された時間数。範囲は(-24,000,000,000 < hours
< 24,000,000,000)です。
戻り値
OracleTimeStamp
例外
ArgumentOutofRangeException
- 引数値が指定範囲を超えています。
OracleNullValueException
- 現行インスタンスにはNULL値があります。
このメソッドは、現行インスタンスに指定されたミリ秒数を加えます。
宣言
// C#
public OracleTimeStamp AddMilliseconds(double milliseconds);
パラメータ
milliseconds
指定されたミリ秒数。範囲は(-8.64 * 1016< milliseconds
< 8.64 * 1016)です。
戻り値
OracleTimeStamp
例外
ArgumentOutofRangeException
- 引数値が指定範囲を超えています。
OracleNullValueException
- 現行インスタンスにはNULL値があります。
このメソッドは、現行インスタンスに指定された分数を加えます。
宣言
// C#
public OracleTimeStamp AddMinutes(double minutes);
パラメータ
minutes
指定された分数。範囲は(-1,440,000,000,000 < minutes
< 1,440,000,000,000)です。
戻り値
OracleTimeStamp
例外
ArgumentOutofRangeException
- 引数値が指定範囲を超えています。
OracleNullValueException
- 現行インスタンスにはNULL値があります。
このメソッドは、現行インスタンスに指定された月数を加えます。
宣言
// C#
public OracleTimeStamp AddMonths(long months);
パラメータ
months
指定された月数。範囲は(-12,000,000,000 < months
< 12,000,000,000)です。
戻り値
OracleTimeStamp
例外
ArgumentOutofRangeException
- 引数値が指定範囲を超えています。
OracleNullValueException
- 現行インスタンスにはNULL値があります。
このメソッドは、現行インスタンスに指定されたナノ秒数を加えます。
宣言
// C#
public OracleTimeStamp AddNanoseconds(long nanoseconds);
パラメータ
nanoseconds
指定されたナノ秒数
戻り値
OracleTimeStamp
例外
OracleNullValueException
- 現行インスタンスにはNULL値があります。
このメソッドは、現行インスタンスに指定された秒数を加えます。
宣言
// C#
public OracleTimeStamp AddSeconds(double seconds);
パラメータ
seconds
指定された秒数。範囲は(-8.64 * 1013< seconds
< 8.64 * 1013)です。
戻り値
OracleTimeStamp
例外
ArgumentOutofRangeException
- 引数値が指定範囲を超えています。
OracleNullValueException
- 現行インスタンスにはNULL値があります。
このメソッドは、現行インスタンスに指定された年数を加えます。
宣言
// C#
public OracleTimeStamp AddYears(int years);
パラメータ
years
指定された年数。範囲は(-999,999,999 <= years
< = 999,999,999)です。
戻り値
OracleTimeStamp
例外
ArgumentOutofRangeException
- 引数値が指定範囲を超えています。
OracleNullValueException
- 現行インスタンスにはNULL値があります。
このメソッドは、現行のOracleTimeStamp
インスタンスとオブジェクトを比較して、その相対値を表す整数を戻します。
宣言
// C#
public int CompareTo(object obj);
パラメータ
obj
現行のOracleTimeStamp
インスタンスと比較されるオブジェクト
戻り値
メソッドが戻す数値は次のとおりです。
ゼロ未満:現行のOracleTimeStamp
インスタンス値がobj
値より小さい場合
ゼロ:現行のOracleTimeStamp
インスタンス値がobj
値と等しい場合
ゼロ超過:現行のOracleTimeStamp
インスタンス値がobj
値より大きい場合
実装
IComparable
例外
ArgumentException
- obj
パラメータがOracleTimeStamp
型ではありません。
備考
次のルールが、このメソッドの動作に適用されます。
比較はOracleTimeStamp
間で行う必要があります。たとえば、OracleTimeStamp
インスタンスとOracleBinary
インスタンスを比較することはできません。OracleTimeStamp
を別の型と比較すると、ArgumentException
が表示されます。
値を持つすべてのOracleTimeStamp
は、NULL値を持つOracleTimeStamp
より大きくなります。
NULL値を含む2つのOracleTimeStamp
は等しくなります。
Object
をオーバーライドします。
このメソッドは、オブジェクトが現行のOracleTimeStamp
インスタンスと同じ日付および時刻を持っているかどうかを決定します。
宣言
// C#
public override bool Equals(object obj);
パラメータ
obj
現行のOracleTimeStamp
インスタンスと比較されるオブジェクト
戻り値
obj
がOracleTimeStamp
型で、同じ日付および時刻を表す場合はtrue
、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStamp
は、NULL値を持つOracleTimeStamp
より大きくなります。
NULL値を含む2つのOracleTimeStamp
は等しくなります。
Object
をオーバーライドします。
このメソッドは、OracleTimeStamp
インスタンスのハッシュ・コードを戻します。
宣言
// C# public override int GetHashCode();
戻り値
ハッシュ・コードを表す数値
このメソッドは、現行インスタンスからOracleTimeStamp
値を引いて、指定されたOracleTimeStamp
構造と現行インスタンス間の時差を表すOracleIntervalDS
を戻します。
宣言
// C#
public OracleIntervalDS GetDaysBetween(OracleTimeStamp value1);
パラメータ
value1
減算されるOracleTimeStamp
値
戻り値
2つのOracleTimeStamp
値の時間隔を表すOracleIntervalDS
備考
現行のインスタンスまたはパラメータのいずれかにNULL値がある場合、戻されたOracleIntervalDS
にNULL値があります。
このメソッドは、現行インスタンスからOracleTimeStamp
値を引いて、OracleTimeStamp
値と現行インスタンス間の時差を表すOracleIntervalYM
を戻します。
宣言
// C#
public OracleIntervalYM GetYearsBetween(OracleTimeStamp value1);
パラメータ
value1
減算されるOracleTimeStamp
値
戻り値
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
構造と同じ日付および時間を表すstring
備考
戻された値は、スレッドのOracleGlobalization
.TimeStampFormat
プロパティで指定された書式を使用して、OracleTimeStamp
を文字列で表したものです。
月および日付に使用されている名称および略称は、スレッドのOracleGlobalization
のDateLanguage
およびCalendar
プロパティで指定されている言語による表記です。スレッドのグローバリゼーション・プロパティのいずれかがNULLまたは空の文字列に設定されている場合、クライアントのコンピュータの設定が使用されます。
例
// C# using System; using Oracle.DataAccess.Types; using Oracle.DataAccess.Client; class ToStringSample { static void Main() { // Set the nls_timestamp_format for the OracleTimeStamp(string) // constructor OracleGlobalization info = OracleGlobalization.GetClientInfo(); info.TimeStampFormat = "DD-MON-YYYY HH:MI:SS.FF AM"; OracleGlobalization.SetThreadInfo(info); // 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 info.TimeStampFormat = "YYYY-MON-DD HH:MI:SS.FF AM"; OracleGlobalization.SetThreadInfo(info); // Prints "1999-NOV-11 11:02:33.444000000 AM" Console.WriteLine(ts.ToString()); } }