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