| Oracle® Data Provider for .NET開発者ガイド リリース9.2.0.4 部品番号 B13807-01 |
|
Oracle.DataAccess.Typesネームスペース(ODP.NET型)、10/19
OracleTimeStampTZ構造体は、データベースに対して格納または取得されるOracleのTIMESTAMP WITH TIME ZONEデータ型を表します。各OracleTimeStampTZには、年、月、日、時、分、秒、ナノ秒およびタイム・ゾーンの情報が格納されています。
Object
ValueType
OracleTimeStampTZ
// C#
public struct OracleTimeStampTZ : IComparable
インスタンス・メソッドではスレッド・セーフティを保証しませんが、すべてのpublic staticメソッドはスレッド・セーフです。
// C# // Illustrates usage of OracleTimeStampTZ // Set the nls parameters for the current thread OracleGlobalization og = OracleGlobalization.GetClientInfo(); og.TimeZone = "US/Eastern"; og.TimeStampFormat = "DD-MON-YYYY HH:MI:SS.FF AM"; og.TimeStampTZFormat = "DD-MON-YYYY HH:MI:SS.FF AM TZR"; OracleGlobalization.SetThreadInfo(og); // Create an OracleTimeStampTZ in US/Pacific time zone OracleTimeStampTZ tstz1=new OracleTimeStampTZ("11-NOV-1999 "+ "11:02:33.444 AM US/Pacific"); // Note that ToOracleTimeStampTZ uses the thread's time zone region,"US/Eastern" OracleTimeStamp ts = new OracleTimeStamp("11-NOV-1999 11:02:33.444 AM"); OracleTimeStampTZ tstz2 = ts.ToOracleTimeStampTZ(); // Calculate the difference between tstz1 and tstz2 OracleIntervalDS idsDiff = tstz1.GetDaysBetween(tstz2); // Display information Console.WriteLine("tstz1.TimeZone = " + tstz1.TimeZone); //Prints "US/Pacific" Console.WriteLine("tstz2.TimeZone = " + tstz2.TimeZone); // Prints "US/Eastern" Console.WriteLine("idsDiff.Hours = " + idsDiff.Hours); // Prints 3 Console.WriteLine("idsDiff.Minutes = " + idsDiff.Minutes); // Prints 0
ネームスペース: Oracle.DataAccess.Types
アセンブリ: Oracle.DataAccess.dll
OracleTimeStampTZのメンバーを次の表に示します。
OracleTimeStampTZのコンストラクタを表5-113に示します。
| コンストラクタ | 説明 |
|---|---|
|
OracleTimeStampTZ構造体の新規インスタンスをインスタンス化します(オーバーロード)。 |
OracleTimeStampTZのstaticフィールドを表5-114に示します。
| フィールド | 説明 |
|---|---|
|
|
|
|
|
|
|
|
OracleTimeStampTZのstaticメソッドを表5-115に示します。
OracleTimeStampTZのstatic演算子を表5-116に示します。
OracleTimeStampTZのstatic型変換を表5-117に示します。
| 演算子 | 説明 |
|---|---|
|
インスタンス値を |
|
|
インスタンス値を |
|
|
|
OracleTimeStampTZのプロパティを表5-118に示します。
OracleTimeStampTZのメソッドを表5-119に示します。
OracleTimeStampTZのコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成します。
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、指定されたDateTime値を使用してその日時の値を設定します。
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、指定されたDateTime値および指定されたタイム・ゾーンのデータを使用してその日時の値を設定します。
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、指定された文字列を使用してその日時の値を設定します。
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、年、月および日を使用してその日時の値を設定します。
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、年、月、日およびタイム・ゾーンのデータを使用してその日時の値を設定します。
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、年、月、日、時、分および秒を使用してその日時の値を設定します。
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、年、月、日、時、分、秒およびタイム・ゾーンのデータを使用してその日時の値を設定します。
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、年、月、日、時、分、秒およびミリ秒を使用してその日時の値を設定します。
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、年、月、日、時、分、秒、ミリ秒およびタイム・ゾーンのデータを使用してその日時の値を設定します。
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、年、月、日、時、分、秒およびナノ秒を使用してその日時の値を設定します。
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、年、月、日、時、分、秒、ナノ秒およびタイム・ゾーンのデータを使用してその日時の値を設定します。
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、指定されたバイト配列にその値を設定します。このバイト配列はOracle TIMESTAMP WITH TIME ZONEの内部形式を表します。
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、指定されたDateTime値を使用してその日時の値を設定します。
// C# public OracleTimeStampTZ (DateTime dt);
タイム・ゾーンは、スレッドのOracleGlobalization.TimeZoneに設定されます。
ArgumentException: 有効なOracleTimeStampTZの構成にdtパラメータを使用できません。
このコンストラクタは、指定されたDateTime値およびタイム・ゾーンのデータを使用してOracleTimeStampTZ構造体の新規インスタンスを作成します。
// C# public OracleTimeStampTZ (DateTime value1, string timeZone);
ArgumentException: 有効なOracleTimeStampTZの構成にパラメータの引数値を使用できません。
timeZoneは、時間のオフセット(7:00など)か、V$TIMEZONE_NAMESに指定されている有効なタイム・ゾーンの地域名(US/Pacificなど)のいずれかです。タイム・ゾーンの略称はサポートされていません。
タイム・ゾーンがnullの場合、スレッドのOracleGlobalization.TimeZoneが使用されます。
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、指定された文字列を使用してその日時の値を設定します。
// C# public OracleTimeStampTZ (string tsStr);
ArgumentException: tsStrが無効な文字列表現のOracleのTIMESTAMP WITH TIME ZONEであるか、スレッドのOracleGlobalization.TimeStampTZFormatプロパティによって指定されたタイムスタンプ書式ではありません。
ArgumentNullException: tsStr値がnullです。
月および日に使用される名前および略称には、スレッドのOracleGlobalizationオブジェクトのDateLanguageプロパティおよびCalendarプロパティによって指定された言語が使用されます。スレッドのグローバリゼーション・プロパティがnullまたは空の文字列に設定されている場合、クライアント・コンピュータの設定が使用されます。
// C# // Set the nls_timestamp_tz_format OracleTimeStampTZ(string) constructor OracleGlobalization og = OracleGlobalization.GetClientInfo(); og.TimeStampTZFormat = "DD-MON-YYYY HH:MI:SS.FF AM TZR"; OracleGlobalization.SetThreadInfo(og); // construct OracleTimeStampTZ from a string using the format specified. OracleTimeStampTZ tstz = new OracleTimeStampTZ("11-NOV-1999" + "11:02:33.444 AM US/Pacific"); // Set the nls_timestamp_tz_format for the ToString() method og.TimeStampTZFormat = "YYYY-MON-DD HH:MI:SS.FF AM TZR"; OracleGlobalization.SetThreadInfo(og); Console.WriteLine(tstz.ToString()); // Prints "1999-NOV-11 11:02:33.444000000 AM US/Pacific"
| 関連資料:
|
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、年、月および日を使用してその日時の値を設定します。
// C#
public OracleTimeStampTZ(int year, int month, int day);
ArgumentOutOfRangeException: 1つ以上のパラメータの引数値が指定された範囲内の値ではありません。
ArgumentException: 有効なOracleTimeStampTZの構成にパラメータの引数値を使用できません(つまり、日がその月の範囲内の値ではありません)。
タイム・ゾーンは、スレッドのOracleGlobalization.TimeZoneに設定されます。
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、年、月、日およびタイム・ゾーンのデータを使用してその日時の値を設定します。
// C# public OracleTimeStampTZ(int year, int month, int day, string timeZone);
year
指定された年。yearの範囲は-4712〜9999です。
month
指定された月。monthの範囲は1〜12です。
day
指定された日。dayの範囲は1〜31です。
timeZone
指定されたタイム・ゾーンのデータ。
ArgumentOutOfRangeException: 1つ以上のパラメータの引数値が指定された範囲内の値ではありません。
ArgumentException: 有効なOracleTimeStampTZの構成にパラメータの引数値を使用できません(つまり、日がその月の範囲内の値ではないか、タイム・ゾーンが無効です)。
timeZoneは、時間のオフセット(7:00など)か、V$TIMEZONE_NAMESに指定されている有効なタイム・ゾーンの地域名(US/Pacificなど)のいずれかです。タイム・ゾーンの略称はサポートされていません。
タイム・ゾーンがnullの場合、スレッドのOracleGlobalization.TimeZoneが使用されます。
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、年、月、日、時、分および秒を使用してその日時の値を設定します。
// C#public OracleTimeStampTZ(intyear, intmonth, intday, inthour, intminute,intsecond);
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: 有効なOracleTimeStampTZの構成にパラメータの引数値を使用できません(つまり、日がその月の範囲内の値ではありません)。
タイム・ゾーンは、スレッドのOracleGlobalization.TimeZoneに設定されます。
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、年、月、日、時、分、秒およびタイム・ゾーンのデータを使用してその日時の値を設定します。
// C#
public OracleTimeStampTZ (int year, int month, int day, int hour, int minute,
int second, string timeZone);
year
指定された年。yearの範囲は-4712〜9999です。
month
指定された月。monthの範囲は1〜12です。
day
指定された日。dayの範囲は1〜31です。
hour
指定された時。hourの範囲は0〜23です。
minute
指定された分。minuteの範囲は0〜59です。
second
指定された秒。secondの範囲は0〜59です。
timeZone
指定されたタイム・ゾーンのデータ。
ArgumentOutOfRangeException: 1つ以上のパラメータの引数値が指定された範囲内の値ではありません。
ArgumentException: 有効なOracleTimeStampTZの構成にパラメータの引数値を使用できません(つまり、日がその月の範囲内の値ではないか、タイム・ゾーンが無効です)。
timeZoneは、時間のオフセット(7:00など)か、V$TIMEZONE_NAMESに指定されている有効なタイム・ゾーンの地域名(US/Pacificなど)のいずれかです。タイム・ゾーンの略称はサポートされていません。
タイム・ゾーンがnullの場合、スレッドのOracleGlobalization.TimeZoneが使用されます。
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、年、月、日、時、分、秒およびミリ秒を使用してその日時の値を設定します。
// C#
public OracleTimeStampTZ(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です。
millisecond
指定されたミリ秒。millisecondの範囲は0〜999.999999です。
ArgumentOutOfRangeException: 1つ以上のパラメータの引数値が指定された範囲内の値ではありません。
ArgumentException: 有効なOracleTimeStampTZの構成にパラメータの引数値を使用できません(つまり、日がその月の範囲内の値ではありません)。
タイム・ゾーンは、スレッドのOracleGlobalization.TimeZoneに設定されます。
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、年、月、日、時、分、秒、ミリ秒およびタイム・ゾーンのデータを使用してその日時の値を設定します。
// C#
public OracleTimeStampTZ(int year, int month, int day, int hour, int minute,
int second, double millisecond, string timeZone);
year
指定された年。yearの範囲は-4712〜9999です。
month
指定された月。monthの範囲は1〜12です。
day
指定された日。dayの範囲は1〜31です。
hour
指定された時。hourの範囲は0〜23です。
minute
指定された分。minuteの範囲は0〜59です。
second
指定された秒。secondの範囲は0〜59です。
millisecond
指定されたミリ秒。millisecondの範囲は0〜999.999999です。
timeZone
指定されたタイム・ゾーンのデータ。
ArgumentOutOfRangeException: 1つ以上のパラメータの引数値が指定された範囲内の値ではありません。
ArgumentException: 有効なOracleTimeStampTZの構成にパラメータの引数値を使用できません(つまり、日がその月の範囲内の値ではないか、タイム・ゾーンが無効です)。
timeZoneは、時間のオフセット(7:00など)か、V$TIMEZONE_NAMESに指定されている有効なタイム・ゾーンの地域名(US/Pacificなど)のいずれかです。タイム・ゾーンの略称はサポートされていません。
タイム・ゾーンがnullの場合、スレッドのOracleGlobalization.TimeZoneが使用されます。
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、年、月、日、時、分、秒およびナノ秒を使用してその日時の値を設定します。
// C#
public OracleTimeStampTZ(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: 有効なOracleTimeStampTZの構成にパラメータの引数値を使用できません(つまり、日がその月の範囲内の値ではありません)。
タイム・ゾーンは、スレッドのOracleGlobalization.TimeZoneに設定されます。
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、年、月、日、時、分、秒、ナノ秒およびタイム・ゾーンのデータを使用してその日時の値を設定します。
// C#
public OracleTimeStampTZ(int year, int month, int day, int hour, int minute,
int second, int nanosecond, string timeZone);
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です。
timeZone
指定されたタイム・ゾーンのデータ。
ArgumentOutOfRangeException: 1つ以上のパラメータの引数値が指定された範囲内の値ではありません。
ArgumentException: 有効なOracleTimeStampTZの構成にパラメータの引数値を使用できません(つまり、日がその月の範囲内の値ではないか、タイム・ゾーンが無効です)。
timeZoneは、時間のオフセット(7:00など)か、V$TIMEZONE_NAMESに指定されている有効なタイム・ゾーンの地域名(US/Pacificなど)のいずれかです。タイム・ゾーンの略称はサポートされていません。
タイム・ゾーンがnullの場合、スレッドのOracleGlobalization.TimeZoneが使用されます。
このコンストラクタは、OracleTimeStampTZ構造体の新規インスタンスを作成し、指定されたバイト配列にその値を設定します。このバイト配列はOracle TIMESTAMP WITH TIME ZONEの内部形式を表します。
// C#
public OracleTimeStampLTZ (byte[] bytes);
ArgumentException: bytesがOracleのTIMESTAMP WITH TIME ZONEの内部形式ではないか、有効なOracleのTIMESTAMP WITH TIME ZONEではありません。
ArgumentNullException: bytesがnullです。
OracleTimeStampTZのstaticフィールドを表5-120に示します。
| フィールド | 説明 |
|---|---|
|
|
|
|
|
|
|
|
このstaticフィールドは、OracleTimeStampTZ構造体の有効日時の最大値をUTCで表します。最大値は9999年12月31日の23:59:59.999999999です。
// C# public static readonly OracleTimeStampTZ MaxValue;
このstaticフィールドは、OracleTimeStampTZ構造体の有効日時の最小値をUTCで表します。最小値は-4712年1月1日の0:0:0です。
// C# public static readonly OracleTimeStampTZ MinValue;
このstaticフィールドは、OracleTimeStampTZ構造体のインスタンスに割り当てられるnull値を表します。
// C# public static readonly OracleTimeStampTZ Null;
OracleTimeStampTZのstaticメソッドを表5-121に示します。
このstaticメソッドは、2つのOracleTimeStampTZ値が等しいかどうかを判断します。
// C# public static bool Equals(OracleTimeStampTZ value1, OracleTimeStampTZ value2);
2つのOracleTimeStampTZ値が等しい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampTZは、null値を持つOracleTimeStampTZより大きいことになります。
OracleTimeStampTZがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、現在の日時を表すOracleTimeStampTZ構造体を取得します。
// C# public static OracleTimeStampTZ GetSysDate();
現在の日時を表すOracleTimeStampTZ構造体
このstaticメソッドは、2つのOracleTimeStampTZ値の1つ目の値が2つ目の値より大きいかどうかを判断します。
// C# public static bool GreaterThan(OracleTimeStampTZ value1, OracleTimeStampTZ value2);
2つのOracleTimeStampTZ値の1つ目の値が2つ目の値より大きい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampTZは、null値を持つOracleTimeStampTZより大きいことになります。
OracleTimeStampTZがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、2つのOracleTimeStampTZ値の1つ目の値が2つ目の値以上かどうかを判断します。
// C# public static bool GreaterThanOrEqual(OracleTimeStampTZ value1, OracleTimeStampTZ value2);
2つのOracleTimeStampTZ値の1つ目の値が2つ目の値以上の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampTZは、null値を持つOracleTimeStampTZより大きいことになります。
OracleTimeStampTZがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、2つのOracleTimeStampTZ値の1つ目の値が2つ目の値より小さいかどうかを判断します。
// C# public static bool LessThan(OracleTimeStampTZ value1, OracleTimeStampTZ value2);
2つのOracleTimeStampTZ値の1つ目の値が2つ目の値より小さい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampTZは、null値を持つOracleTimeStampTZより大きいことになります。
OracleTimeStampTZがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、2つのOracleTimeStampTZ値の1つ目の値が2つ目の値以下かどうかを判断します。
// C# public static bool LessThanOrEqual(OracleTimeStampTZ value1, OracleTimeStampTZ value2);
2つのOracleTimeStampTZ値の1つ目の値が2つ目の値以下の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampTZは、null値を持つOracleTimeStampTZより大きいことになります。
OracleTimeStampTZがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、2つのOracleTimeStampTZ値が等しくないかどうかを判断します。
// C# public static bool NotEquals(OracleTimeStampTZ value1, OracleTimeStampTZ value2);
2つのOracleTimeStampTZ値が等しくない場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampTZは、null値を持つOracleTimeStampTZより大きいことになります。
OracleTimeStampTZがnull値を持つ場合、2つは等しいことになります。
このstaticメソッドは、OracleTimeStampTZ構造体を返し、指定された文字列を使用してその日時の値を設定します。
// C# public static OracleTimeStampTZ Parse(string tsStr);
OracleTimeStampTZ構造体
ArgumentException: tsStrが無効な文字列表現のOracleのTIMESTAMP WITH TIME ZONEであるか、スレッドのOracleGlobalization.TimeStampTZFormatプロパティ(OracleのNLS_TIMESTAMP_TZ_FORMATパラメータを表す)によって指定されたタイムスタンプ書式ではありません。
ArgumentNullException: tsStr値がnullです。
月および日に使用される名前および略称には、スレッドのOracleGlobalizationオブジェクトのDateLanguageプロパティおよびCalendarプロパティによって指定された言語が使用されます。スレッドのグローバリゼーション・プロパティがnullまたは空の文字列に設定されている場合、クライアント・コンピュータの設定が使用されます。
// C# // Set the nls_timestamp_tz_format for the Parse() method OracleGlobalization og = OracleGlobalization.GetClientInfo(); og.TimeStampTZFormat = "DD-MON-YYYY HH:MI:SS.FF AM TZR"; OracleGlobalization.SetThreadInfo(og); // construct OracleTimeStampTZ from a string using the format specified. OracleTimeStampTZ tstz = OracleTimeStampTZ.Parse("11-NOV-1999 " + "11:02:33.444 AM US/Pacific"); // Set the nls_timestamp_tz_format for the ToString() method og.TimeStampTZFormat = "YYYY-MON-DD HH:MI:SS.FF AM TZR"; OracleGlobalization.SetThreadInfo(og); Console.WriteLine(tstz.ToString()); // Prints "1999-NOV-11 11:02:33.444000000 AM US/Pacific"
このstaticメソッドは、指定された小数秒の精度でOracleTimeStampTZの新規インスタンスを返します。
// C# public static OracleTimeStampTZ SetPrecision(OracleTimeStampTZ value1, int fracSecPrecision);
指定された小数秒の精度のOracleTimeStampTZ構造体
ArgumentOutOfRangeException: fracSecPrecisionが指定された範囲内にありません。
指定されたfracSecPrecisionに設定される値を使用し、指定されたOracleTimeStampTZ値に対して四捨五入の操作が実行されます。この値に応じて、0個以上の後続ゼロがToString()によって返される文字列に表示されます。
値"December 31, 9999 23:59:59.99 US/Pacific"のOracleTimeStampTZは、小数秒の精度を5に設定してSetPrecision()をコールした場合、文字列"December 31, 9999 23:59:59.99000 US/Pacific"という結果になります。
OracleTimeStampTZのstatic演算子を表5-122に示します。
operator+は、指定された構造体を指定されたOracleTimeStampTZに加算し、新しいOracleTimeStampTZ構造体を返します。
このstatic演算子は、指定されたOracleIntervalDSを指定されたOracleTimeStampTZに加算し、新しいOracleTimeStampTZ構造体を返します。
このstatic演算子は、指定されたOracleIntervalYMを指定されたOracleTimeStampTZに加算し、新しいOracleTimeStampTZ構造体を返します。
このstatic演算子は、指定されたTimeSpanを指定されたOracleTimeStampTZに加算し、新しいOracleTimeStampTZ構造体を返します。
このstatic演算子は、指定されたOracleIntervalDSを指定されたOracleTimeStampTZに加算し、新しいOracleTimeStampTZ構造体を返します。
// C# public static operator +(OracleTimeStampTZ value1, OracleIntervalDS value2);
OracleTimeStampTZ
いずれかのパラメータがnull値を持つ場合、返されるOracleTimeStampTZはnull値を持ちます。
このstatic演算子は、指定されたOracleIntervalYMを指定されたOracleTimeStampTZに加算し、新しいOracleTimeStampTZ構造体を返します。
// C# public static operator +(OracleTimeStampTZ value1, OracleIntervalYM value2);
OracleTimeStampTZ
いずれかのパラメータがnull値を持つ場合、返されるOracleTimeStampTZはnull値を持ちます。
このstatic演算子は、指定されたTimeSpanを指定されたOracleTimeStampTZに加算し、新しいOracleTimeStampTZ構造体を返します。
// C# public static operator +(OracleTimeStampTZ value1, TimeSpan value2);
OracleTimeStampTZ
OracleTimeStampTZインスタンスがnull値を持つ場合、返されるOracleTimeStampTZはnull値を持ちます。
このstatic演算子は、2つのOracleTimeStampTZ値が等しいかどうかを判断します。
// C# public static bool operator == (OracleTimeStampTZ value1, OracleTimeStampTZ value2);
両方の値が等しい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampTZは、null値を持つOracleTimeStampTZより大きいことになります。
OracleTimeStampTZがnull値を持つ場合、2つは等しいことになります。
このstatic演算子は、2つのOracleTimeStampTZ値の1つ目の値が2つ目の値より大きいかどうかを判断します。
// C# public static bool operator > (OracleTimeStampTZ value1, OracleTimeStampTZ value2);
1つ目のOracleTimeStampTZ値が2つ目の値より大きい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampTZは、null値を持つOracleTimeStampTZより大きいことになります。
OracleTimeStampTZがnull値を持つ場合、2つは等しいことになります。
このstatic演算子は、2つのOracleTimeStampTZ値の1つ目の値が2つ目の値以上かどうかを判断します。
// C# public static bool operator >= (OracleTimeStampTZ value1, OracleTimeStampTZ value2);
1つ目のOracleTimeStampTZ値が2つ目の値以上の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampTZは、null値を持つOracleTimeStampTZより大きいことになります。
OracleTimeStampTZがnull値を持つ場合、2つは等しいことになります。
このstatic演算子は、2つのOracleTimeStampTZ値が等しくないかどうかを判断します。
// C# public static bool operator != (OracleTimeStampTZ value1, OracleTimeStampTZ value2);
2つのOracleTimeStampTZ値が等しくない場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampTZは、null値を持つOracleTimeStampTZより大きいことになります。
OracleTimeStampTZがnull値を持つ場合、2つは等しいことになります。
このstatic演算子は、2つのOracleTimeStampTZ値の1つ目の値が2つ目の値より小さいかどうかを判断します。
// C# public static bool operator < (OracleTimeStampTZ value1, OracleTimeStampTZ value2);
1つ目のOracleTimeStampTZ値が2つ目の値より小さい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampTZは、null値を持つOracleTimeStampTZより大きいことになります。
OracleTimeStampTZがnull値を持つ場合、2つは等しいことになります。
このstatic演算子は、2つのOracleTimeStampTZ値の1つ目の値が2つ目の値以下かどうかを判断します。
// C# public static bool operator <= (OracleTimeStampTZ value1, OracleTimeStampTZ value2);
1つ目のOracleTimeStampTZ値が2つ目の値以下の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampTZは、null値を持つOracleTimeStampTZより大きいことになります。
OracleTimeStampTZがnull値を持つ場合、2つは等しいことになります。
operator-は、指定された値を指定されたOracleTimeStampTZ値から減算し、新しいOracleTimeStampTZ構造体を返します。
このstatic演算子は、指定されたOracleIntervalDS値を指定されたOracleTimeStampTZ値から減算し、新しいOracleTimeStampTZ構造体を返します。
このstatic演算子は、指定されたOracleIntervalYM値を指定されたOracleTimeStampTZ値から減算し、新しいOracleTimeStampTZ構造体を返します。
このstatic演算子は、指定されたTimeSpan値を指定されたOracleTimeStampTZ値から減算し、新しいOracleTimeStampTZ構造体を返します。
このstatic演算子は、指定されたOracleIntervalDS値を指定されたOracleTimeStampTZ値から減算し、新しいOracleTimeStampTZ構造体を返します。
// C# public static operator - (OracleTimeStampTZ value1, OracleIntervalDS value2);
OracleTimeStampTZ構造体
いずれかのパラメータがnull値を持つ場合、返されるOracleTimeStampTZはnull値を持ちます。
このstatic演算子は、指定されたOracleIntervalYM値を指定されたOracleTimeStampTZ値から減算し、新しいOracleTimeStampTZ構造体を返します。
// C# public static operator - (OracleTimeStampTZ value1, OracleIntervalYM value2);
OracleTimeStampTZ構造体
いずれかのパラメータがnull値を持つ場合、返されるOracleTimeStampTZはnull値を持ちます。
このstatic演算子は、指定されたTimeSpan値を指定されたOracleTimeStampTZ値から減算し、新しいOracleTimeStampTZ構造体を返します。
// C# public static operator - (OracleTimeStampTZ value1, TimeSpan value2);
OracleTimeStampTZ構造体
OracleTimeStampTZインスタンスがnull値を持つ場合、返されるOracleTimeStampTZ構造体はnull値を持ちます。
OracleTimeStampTZのstatic型変換を表5-123に示します。
| 演算子 | 説明 |
|---|---|
|
インスタンス値を |
|
|
インスタンス値を |
|
|
|
explicit operator OracleTimeStampTZは、インスタンス値をOracleTimeStampTZ構造体に変換します。
このstatic型変換演算子は、OracleTimeStamp値をOracleTimeStampTZ構造体に変換します。
このstatic型変換演算子は、OracleTimeStampLTZ値をOracleTimeStampTZ構造体に変換します。
このstatic型変換演算子は、指定された文字列値をOracleTimeStampTZ構造体に変換します。
このstatic型変換演算子は、OracleTimeStamp値をOracleTimeStampTZ構造体に変換します。
// C# public static explicit operator OracleTimeStampTZ(OracleTimeStamp value1);
返されるOracleTimeStampTZには、OracleTimeStampの日時およびスレッドのOracleGlobalization.TimeZoneのタイム・ゾーンが含まれます。
スレッドのOracleGlobalization.TimeZoneを使用してOracleTimeStamp構造体からOracleTimeStampTZ構造体に変換します。
OracleTimeStamp構造体がnull値を持つ場合、返されるOracleTimeStampTZ構造体もnull値を持ちます。
このstatic型変換演算子は、OracleTimeStampLTZ値をOracleTimeStampTZ構造体に変換します。
// C# public static explicit operator OracleTimeStampTZ(OracleTimeStampLTZ value1);
返されるOracleTimeStampTZには、OracleTimeStampLTZの日時およびスレッドのOracleGlobalization.TimeZoneのタイム・ゾーンが含まれます。
OracleTimeStampLTZ構造体がnull値を持つ場合、返されるOracleTimeStampTZ構造体もnull値を持ちます。
このstatic型変換演算子は、指定された文字列値をOracleTimeStampTZ構造体に変換します。
// C# public static explicit operator OracleTimeStampTZ(string tsStr);
OracleTimeStampTZ値
ArgumentException: tsStrが無効な文字列表現のOracleのTIMESTAMP WITH TIME ZONEであるか、スレッドのOracleGlobalization.TimeStampTZFormatプロパティ(OracleのNLS_TIMESTAMP_TZ_FORMATパラメータを表す)によって指定されたタイムスタンプ書式ではありません。
月および日に使用される名前および略称には、スレッドのOracleGlobalizationオブジェクトのDateLanguageプロパティおよびCalendarプロパティによって指定された言語が使用されます。スレッドのグローバリゼーション・プロパティがnullまたは空の文字列に設定されている場合、クライアント・コンピュータの設定が使用されます。
// C# // Set the nls_timestamp_tz_format for the explicit operator // OracleTimeStampTZ(string) OracleGlobalization og = OracleGlobalization.GetClientInfo(); og.TimeStampTZFormat = "DD-MON-YYYY HH:MI:SS.FF AM TZR"; OracleGlobalization.SetThreadInfo(og); // construct OracleTimeStampTZ from a string using the format specified. OracleTimeStampTZ tstz = new OracleTimeStampTZ("11-NOV-1999" + "11:02:33.444 AM US/Pacific"); // Set the nls_timestamp_tz_format for the ToString() method og.TimeStampTZFormat = "YYYY-MON-DD HH:MI:SS.FF AM TZR"; OracleGlobalization.SetThreadInfo(og); Console.WriteLine(tstz.ToString()); // Prints "1999-NOV-11 11:02:33.444000000 AM US/Pacific"
implicit operator OracleTimeStampTZは、DateTime構造体をOracleTimeStampTZ構造体に変換します。
このstatic型変換演算子は、OracleDate値をOracleTimeStampTZ構造体に変換します。
このstatic型変換演算子は、DateTime構造体をOracleTimeStampTZ構造体に変換します。
このstatic型変換演算子は、OracleDate値をOracleTimeStampTZ構造体に変換します。
// C# public static implicit operator OracleTimeStampTZ(OracleDate value1);
返されるOracleTimeStampTZには、OracleDateの日時およびスレッドのOracleGlobalization.TimeZoneのタイム・ゾーンが含まれます。
スレッドのOracleGlobalization.TimeZoneを使用してOracleDateからOracleTimeStampTZ構造体に変換します。OracleDate構造体がnull値を持つ場合、返されるOracleTimeStampTZ構造体もnull値を持ちます。
このstatic型変換演算子は、DateTime構造体をOracleTimeStampTZ構造体に変換します。
// C# public static implicit operator OracleTimeStampTZ (DateTime value1);
返されるOracleTimeStampTZには、DateTimeの日時およびスレッドのOracleGlobalization.TimeZoneのタイム・ゾーンが含まれます。
スレッドのOracleGlobalization.TimeZoneを使用してDateTimeからOracleTimeStampTZ構造体に変換します。
このstatic型変換演算子は、OracleTimeStampTZ値を現在のタイム・ゾーンでDateTime構造体に変換します。
// C# public static explicit operator DateTime(OracleTimeStampTZ value1);
現在のインスタンスの日時を含むDateTime。ただし、そのタイム・ゾーン情報は切り捨てられます。
OracleNullValueException: OracleTimeStampTZ構造体がnull値を持ちます。
OracleTimeStampTZ値の精度は、変換時に失われる場合があります。また、現在のインスタンスのタイム・ゾーン情報は切り捨てられます。
OracleTimeStampTZのプロパティを表5-124に示します。
このプロパティは、OracleのTIMESTAMP WITH TIME ZONEをOracleの内部形式で表すバイト配列を返します。
// C# public byte[] BinData {get;}
OracleのTIMESTAMP WITH TIME ZONEをOracleの内部形式で表す指定されたバイト配列
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleTimeStampTZの日の構成要素を現在のタイム・ゾーンで指定します。
// C# public int Day{get;}
日を表す数値。Dayの範囲は1〜31です。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、現在のインスタンスがnull値を持つかどうかを示します。
// C# public bool IsNull{get;}
現在のインスタンスがnull値を持つ場合、trueを返します。それ以外の場合、falseを返します。
このプロパティは、OracleTimeStampTZの時の構成要素を現在のタイム・ゾーンで指定します。
// C# public int Hour{get;}
時を表す数値。Hourの範囲は0〜23です。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleTimeStampTZのミリ秒の構成要素を現在のタイム・ゾーンで取得します。
// C# public double Millisecond{get;}
ミリ秒を表す数値。Millisecondの範囲は0〜999.999999です。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleTimeStampTZの分の構成要素を現在のタイム・ゾーンで取得します。
// C# public int Minute{get;}
分を表す数値。Minuteの範囲は0〜59です。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleTimeStampTZの月の構成要素を現在のタイム・ゾーンで取得します。
// C# public int Month{get;}
月を表す数値。Monthの範囲は1〜12です。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleTimeStampTZのナノ秒の構成要素を現在のタイム・ゾーンで取得します。
// C# public int Nanosecond{get;}
ナノ秒を表す数値。Nanosecondの範囲は0〜999999999です。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleTimeStampTZの秒の構成要素を現在のタイム・ゾーンで取得します。
// C# public int Second{get;}
秒を表す数値。Secondの範囲は0〜59です。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleTimeStampTZインスタンスのタイム・ゾーンを返します。
// C# public string TimeZone{get;}
タイム・ゾーンを表す文字列
タイム・ゾーンがコンストラクタで指定されていない場合、このプロパティはスレッドのOracleGlobalization.TimeZoneにデフォルトで設定されます。
このプロパティは、OracleTimeStampTZ構造体に格納されている日時を現在のタイム・ゾーンで返します。
// C# public DateTime Value{get;}
現在のタイム・ゾーンのDateTime
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleTimeStampTZの年の構成要素を現在のタイム・ゾーンで設定します。
// C# public int Year{get;}
年を表す数値。Yearの範囲は-4712〜9999です。
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
OracleTimeStampTZのメソッドを表5-125に示します。
このメソッドは、指定された日数を現在のインスタンスに加算します。
// C# public OracleTimeStampTZ AddDays(double days);
OracleTimeStampTZ
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
ArgumentOutofRangeException: 引数値が指定された範囲内の値ではありません。
このメソッドは、指定された時間数を現在のインスタンスに加算します。
// C# public OracleTimeStampTZ AddHours(double hours);
OracleTimeStampTZ
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
ArgumentOutofRangeException: 引数値が指定された範囲内の値ではありません。
このメソッドは、指定されたミリ秒数を現在のインスタンスに加算します。
// C# public OracleTimeStampTZ AddMilliseconds(double milliseconds);
OracleTimeStampTZ
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
ArgumentOutofRangeException: 引数値が指定された範囲内の値ではありません。
このメソッドは、指定された分数を現在のインスタンスに加算します。
// C# public OracleTimeStampTZ AddMinutes(double minutes);
OracleTimeStampTZ
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
ArgumentOutofRangeException: 引数値が指定された範囲内の値ではありません。
このメソッドは、指定された月数を現在のインスタンスに加算します。
// C# public OracleTimeStampTZ AddMonths(long months);
OracleTimeStampTZ
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
ArgumentOutofRangeException: 引数値が指定された範囲内の値ではありません。
このメソッドは、指定されたナノ秒数を現在のインスタンスに加算します。
// C# public OracleTimeStampTZ AddNanoseconds(long nanoseconds);
OracleTimeStampTZ
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このメソッドは、指定された秒数を現在のインスタンスに加算します。
// C# public OracleTimeStampTZ AddSeconds(double seconds);
OracleTimeStampTZ
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
ArgumentOutofRangeException: 引数値が指定された範囲内の値ではありません。
このメソッドは、指定された年数を現在のインスタンスに加算します。
// C# public OracleTimeStampTZ AddYears(int years);
OracleTimeStampTZ
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
ArgumentOutofRangeException: 引数値が指定された範囲内の値ではありません。
このメソッドは、現在のOracleTimeStampTZインスタンスをオブジェクトと比較し、その相対値を表す整数を返します。
// C# public int CompareTo(object obj);
このメソッドは、次の数値を返します。
0より小さい値: 現在のOracleTimeStampTZインスタンス値がobjの値より小さい場合
0: 現在のOracleTimeStampTZインスタンスとobjの値が等しい場合
0より大きい値: 現在のOracleTimeStampTZインスタンス値がobjの値より大きい場合
IComparable
ArgumentException: objがOracleTimeStampTZ型ではありません。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampTZ同士で行う必要があります。たとえば、OracleTimeStampTZインスタンスとOracleBinaryインスタンスを比較することはできません。OracleTimeStampTZを異なる型と比較すると、ArgumentExceptionがスローされます。
OracleTimeStampTZは、null値を持つOracleTimeStampTZより大きいことになります。
OracleTimeStampTZがnull値を持つ場合、2つは等しいことになります。
Objectをオーバーライドします。
このメソッドは、オブジェクトが現在のOracleTimeStampTZインスタンスと同じ日時を持つかどうかを判断します。
// C# public override bool Equals(object obj);
objがOracleTimeStampTZ型で同じ日時を表す場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleTimeStampTZは、null値を持つOracleTimeStampTZより大きいことになります。
OracleTimeStampTZがnull値を持つ場合、2つは等しいことになります。
このメソッドは、OracleTimeStampTZ値を現在のインスタンスから減算し、その時間間隔を表すOracleIntervalDSを返します。
// C# public OracleIntervalDS GetDaysBetween(OracleTimeStampTZ value1);
2つのOracleTimeStampTZ値の時間間隔を表すOracleIntervalDS
現在のインスタンスとパラメータのいずれかがnull値を持つ場合、返されるOracleIntervalDSはnull値を持ちます。
Objectをオーバーライドします。
このメソッドは、OracleTimeStampTZインスタンスのハッシュ・コードを返します。
// C# public override int GetHashCode();
ハッシュ・コードを表す数値
このメソッドは、現在のOracleTimeStampTZの時と分のタイム・ゾーンに関する情報を取得します。
// C# public TimeSpan GetTimeZoneOffset();
TimeSpan
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このメソッドは、OracleTimeStampTZ値を現在のインスタンスから減算し、その時間間隔を表すOracleIntervalYMを返します。
// C# public OracleIntervalYM GetYearsBetween(OracleTimeStampTZ val);
2つのOracleTimeStampTZ値の時間間隔を表すOracleIntervalYM
現在のインスタンスとパラメータのいずれかがnull値を持つ場合、返されるOracleIntervalYMはnull値を持ちます。
このメソッドは、現在のOracleTimeStampTZインスタンスを地方時に変換します。
// C# public OracleTimeStampLTZ ToLocalTime();
現在のインスタンスの(クライアントのローカル・タイム・ゾーンに合せられた)日時を含むOracleTimeStampLTZ構造体
現在のインスタンスがnull値を持つ場合、返されるOracleTimeStampLTZはnull値を持ちます。
このメソッドは、現在のOracleTimeStampTZ構造体をOracleDate構造体に変換します。
// C# public OracleDate ToOracleDate();
返されるOracleDateには、現在のインスタンスの日時が含まれますが、そのタイム・ゾーン情報は切り捨てられます。
OracleTimeStampTZ値の精度は、変換時に失われる場合があります。また、現在のインスタンスのタイム・ゾーン情報は切り捨てられます。
現在のインスタンスがnull値を持つ場合、返されるOracleDate構造体はnull値を持ちます。
このメソッドは、現在のOracleTimeStampTZ構造体をOracleTimeStampLTZ構造体に変換します。
// C# public OracleTimeStampLTZ ToOracleTimeStampLTZ();
返されるOracleTimeStampLTZ構造体には、現在のインスタンスの(クライアントのローカル・タイム・ゾーンに合せられた)日時が含まれます。
現在のインスタンスがnull値を持つ場合、返されるOracleTimeStampLTZ構造体はnull値を持ちます。
このメソッドは、現在のOracleTimeStampTZ構造体をOracleTimeStamp構造体に変換します。
// C# public OracleTimeStamp ToOracleTimeStamp();
返されるOracleTimeStampには、現在のインスタンスの日時が含まれますが、そのタイム・ゾーン情報は切り捨てられます。
現在のインスタンスがnull値を持つ場合、返されるOracleTimeStamp構造体はnull値を持ちます。
Objectをオーバーライドします。
このメソッドは、現在のOracleTimeStampTZ構造体を文字列に変換します。
// C# public override string ToString();
現在のOracleTimeStampTZ構造体と同じ日時を表す文字列
返される値は文字列表現のOracleTimeStampTZで、スレッドのOracleGlobalization.TimeStampTZFormatプロパティによって指定された書式です。月および日に使用される名前および略称には、スレッドのOracleGlobalization.DateLanguageプロパティおよびOracleGlobalization.Calendarプロパティによって指定された言語が使用されます。スレッドのグローバリゼーション・プロパティがnullまたは空の文字列に設定されている場合、クライアント・コンピュータの設定が使用されます。
// C# // Set the nls_timestamp_tz_format for the TimeStampTZFormat(string) constructor OracleGlobalization og = OracleGlobalization.GetClientInfo(); og.TimeStampTZFormat = "DD-MON-YYYY HH:MI:SS.FF AM TZR"; OracleGlobalization.SetThreadInfo(og); // construct OracleTimeStampTZ from a string using the format specified. OracleTimeStampTZ tstz = new OracleTimeStampTZ("11-NOV-1999" + "11:02:33.444 AM US/Pacific"); // Set the nls_timestamp_tz_format for the ToString() method og.TimeStampTZFormat = "YYYY-MON-DD HH:MI:SS.FF AM TZR"; OracleGlobalization.SetThreadInfo(og); Console.WriteLine(tstz.ToString()); // Prints "1999-NOV-11 11:02:33.444000000 AM US/Pacific"
このメソッドは、現在の日時を協定世界時(UTC)に変換します。
// C# public OracleTimeStampTZ ToUniversalTime();
OracleTimeStampTZ構造体
現在のインスタンスがnull値を持つ場合、返されるOracleTimeStampTZ構造体はnull値を持ちます。
この項では、ODP.NET型の例外について説明します。
|
|
![]() Copyright © 2002, 2003 Oracle Corporation. All Rights Reserved. |
|