ヘッダーをスキップ

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型)、10/19


OracleTimeStampTZ構造体

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

OracleTimeStampTZのコンストラクタ

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

表5-113 OracleTimeStampTZのコンストラクタ
コンストラクタ 説明

OracleTimeStampTZのコンストラクタ

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

OracleTimeStampTZのstaticフィールド

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

表5-114 OracleTimeStampTZのstaticフィールド
フィールド 説明

MaxValue

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

MinValue

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

Null

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

OracleTimeStampTZのstaticメソッド

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

表5-115 OracleTimeStampTZのstaticメソッド
メソッド 説明

Equals

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

GetSysDate

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

GreaterThan

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

GreaterThanOrEqual

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

LessThan

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

LessThanOrEqual

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

NotEquals

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

Parse

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

SetPrecision

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

OracleTimeStampTZのstatic演算子

OracleTimeStampTZのstatic演算子を表5-116に示します。

表5-116 OracleTimeStampTZのstatic演算子
演算子 説明

operator +

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

operator ==

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

operator >

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

operator >=

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

operator !=

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

operator <

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

operator <=

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

operator -

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

OracleTimeStampTZのstatic型変換

OracleTimeStampTZのstatic型変換を表5-117に示します。

表5-117 OracleTimeStampTZのstatic型変換
演算子 説明

explicit operator OracleTimeStampTZ

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

implicit operator OracleTimeStampTZ

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

explicit operator DateTime

OracleTimeStampTZ値を現在のタイム・ゾーンでDateTime構造体に変換します。

OracleTimeStampTZのプロパティ

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

表5-118 OracleTimeStampTZのプロパティ
プロパティ 説明

BinData

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

Day

OracleTimeStampTZの日の構成要素を現在のタイム・ゾーンで指定します。

IsNull

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

Hour

OracleTimeStampTZの時の構成要素を現在のタイム・ゾーンで指定します。

Millisecond

OracleTimeStampTZのミリ秒の構成要素を現在のタイム・ゾーンで指定します。

Minute

OracleTimeStampTZの分の構成要素を現在のタイム・ゾーンで指定します。

Month

OracleTimeStampTZの月の構成要素を現在のタイム・ゾーンで指定します。

Nanosecond

OracleTimeStampTZのナノ秒の構成要素を現在のタイム・ゾーンで指定します。

Second

OracleTimeStampTZの秒の構成要素を現在のタイム・ゾーンで指定します。

TimeZone

OracleTimeStampTZインスタンスのタイム・ゾーンを返します。

Value

OracleTimeStampTZ構造体に格納されている日時を現在のタイム・ゾーンで返します。

Year

OracleTimeStampTZの年の構成要素を現在のタイム・ゾーンで指定します。

OracleTimeStampTZのメソッド

OracleTimeStampTZのメソッドを表5-119に示します。

表5-119 OracleTimeStampTZのメソッド
メソッド 説明

AddDays

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

AddHours

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

AddMilliseconds

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

AddMinutes

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

AddMonths

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

AddNanoseconds

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

AddSeconds

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

AddYears

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

CompareTo

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

Equals

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

GetDaysBetween

OracleTimeStampTZを現在のインスタンスから減算し、その時間間隔を表すOracleIntervalDSを返します。

GetHashCode

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

GetTimeZoneOffset

現在のOracleTimeStampTZの時と分のタイム・ゾーン情報を取得します。

GetYearsBetween

OracleTimeStampTZを現在のインスタンスから減算し、その時間間隔を表すOracleIntervalYMを返します。

GetType

Objectから継承されます。

ToLocalTime

現在のOracleTimeStampTZインスタンスを地方時に変換します。

ToOracleDate

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

ToOracleTimeStampLTZ

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

ToOracleTimeStamp

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

ToString

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

ToUniversalTime

現在の日時を協定世界時(UTC)に変換します。

関連項目:

OracleTimeStampTZのコンストラクタ

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

オーバーロード一覧:

OracleTimeStampTZ(DateTime)

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

宣言
// C#
public OracleTimeStampTZ (DateTime dt);
パラメータ
備考

タイム・ゾーンは、スレッドのOracleGlobalization.TimeZoneに設定されます。

例外

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

関連項目:

OracleTimeStampTZ(DateTime, string)

このコンストラクタは、指定されたDateTime値およびタイム・ゾーンのデータを使用してOracleTimeStampTZ構造体の新規インスタンスを作成します。

宣言
// C#
public OracleTimeStampTZ (DateTime value1, string timeZone);
パラメータ
例外

ArgumentException: 有効なOracleTimeStampTZの構成にパラメータの引数値を使用できません。

備考

timeZoneは、時間のオフセット(7:00など)か、V$TIMEZONE_NAMESに指定されている有効なタイム・ゾーンの地域名(US/Pacificなど)のいずれかです。タイム・ゾーンの略称はサポートされていません。

タイム・ゾーンがnullの場合、スレッドのOracleGlobalization.TimeZoneが使用されます。


注意:

PSTはタイム・ゾーンの地域名であり、タイム・ゾーンの略称でもあるため、OracleTimeStampTZで使用できます。


関連項目:

OracleTimeStampTZ(string)

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

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

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

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

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

備考

タイム・ゾーンは、スレッドのOracleGlobalization.TimeZoneに設定されます。

関連項目:

OracleTimeStampTZ(int, int, int, string)

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

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

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

ArgumentException: 有効なOracleTimeStampTZの構成にパラメータの引数値を使用できません(つまり、日がその月の範囲内の値ではないか、タイム・ゾーンが無効です)。

備考

timeZoneは、時間のオフセット(7:00など)か、V$TIMEZONE_NAMESに指定されている有効なタイム・ゾーンの地域名(US/Pacificなど)のいずれかです。タイム・ゾーンの略称はサポートされていません。

タイム・ゾーンがnullの場合、スレッドのOracleGlobalization.TimeZoneが使用されます。


注意:

PSTはタイム・ゾーンの地域名であり、タイム・ゾーンの略称でもあるため、OracleTimeStampTZで使用できます。


関連項目:

OracleTimeStampTZ(int, int, int, int, int, int)

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

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

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

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

備考

タイム・ゾーンは、スレッドのOracleGlobalization.TimeZoneに設定されます。

関連項目:

OracleTimeStampTZ(int, int, int, int, int, int, string)

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

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

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

ArgumentException: 有効なOracleTimeStampTZの構成にパラメータの引数値を使用できません(つまり、日がその月の範囲内の値ではないか、タイム・ゾーンが無効です)。

備考

timeZoneは、時間のオフセット(7:00など)か、V$TIMEZONE_NAMESに指定されている有効なタイム・ゾーンの地域名(US/Pacificなど)のいずれかです。タイム・ゾーンの略称はサポートされていません。

タイム・ゾーンがnullの場合、スレッドのOracleGlobalization.TimeZoneが使用されます。


注意:

PSTはタイム・ゾーンの地域名であり、タイム・ゾーンの略称でもあるため、OracleTimeStampTZで使用できます。


関連項目:

OracleTimeStampTZ(int, int, int, int, int, int, double)

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

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

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

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

備考

タイム・ゾーンは、スレッドのOracleGlobalization.TimeZoneに設定されます。

関連項目:

OracleTimeStampTZ(int, int, int, int, int, int, double, string)

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

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

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

ArgumentException: 有効なOracleTimeStampTZの構成にパラメータの引数値を使用できません(つまり、日がその月の範囲内の値ではないか、タイム・ゾーンが無効です)。

備考

timeZoneは、時間のオフセット(7:00など)か、V$TIMEZONE_NAMESに指定されている有効なタイム・ゾーンの地域名(US/Pacificなど)のいずれかです。タイム・ゾーンの略称はサポートされていません。

タイム・ゾーンがnullの場合、スレッドのOracleGlobalization.TimeZoneが使用されます。


注意:

PSTはタイム・ゾーンの地域名であり、タイム・ゾーンの略称でもあるため、OracleTimeStampTZで使用できます。


関連項目:

OracleTimeStampTZ(int, int, int, int, int, int, int)

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

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

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

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

備考

タイム・ゾーンは、スレッドのOracleGlobalization.TimeZoneに設定されます。

関連項目:

OracleTimeStampTZ(int, int, int, int, int, int, int, string)

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

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

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

ArgumentException: 有効なOracleTimeStampTZの構成にパラメータの引数値を使用できません(つまり、日がその月の範囲内の値ではないか、タイム・ゾーンが無効です)。

備考

timeZoneは、時間のオフセット(7:00など)か、V$TIMEZONE_NAMESに指定されている有効なタイム・ゾーンの地域名(US/Pacificなど)のいずれかです。タイム・ゾーンの略称はサポートされていません。

タイム・ゾーンがnullの場合、スレッドのOracleGlobalization.TimeZoneが使用されます。


注意:

PSTはタイム・ゾーンの地域名であり、タイム・ゾーンの略称でもあるため、OracleTimeStampTZで使用できます。


関連項目:

OracleTimeStampTZ(byte [ ])

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

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

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

ArgumentNullException: bytesnullです。

関連項目:

OracleTimeStampTZのstaticフィールド

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

表5-120 OracleTimeStampTZのstaticフィールド
フィールド 説明

MaxValue

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

MinValue

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

Null

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

関連項目:

MaxValue

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

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

関連項目:

MinValue

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

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

関連項目:

Null

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

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

関連項目:

OracleTimeStampTZのstaticメソッド

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

表5-121 OracleTimeStampTZのstaticメソッド
メソッド 説明

Equals

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

GetSysDate

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

GreaterThan

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

GreaterThanOrEqual

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

LessThan

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

LessThanOrEqual

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

NotEquals

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

Parse

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

SetPrecision

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

関連項目:

Equals

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

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

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

備考

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

GetSysDate

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

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

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

関連項目:

GreaterThan

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

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

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

備考

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

GreaterThanOrEqual

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

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

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

備考

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

LessThan

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

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

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

備考

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

LessThanOrEqual

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

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

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

備考

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

NotEquals

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

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

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

備考

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

Parse

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

関連項目:

SetPrecision

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

OracleTimeStampTZのstatic演算子を表5-122に示します。

表5-122 OracleTimeStampTZのstatic演算子
演算子 説明

operator +

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

operator ==

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

operator >

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

operator >=

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

operator !=

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

operator <

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

operator <=

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

operator -

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

関連項目:

operator +

operator+は、指定された構造体を指定されたOracleTimeStampTZに加算し、新しいOracleTimeStampTZ構造体を返します。

オーバーロード一覧:

operator +(OracleTimeStampTZ, OracleIntervalDS)

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

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

OracleTimeStampTZ

備考

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

関連項目:

operator +(OracleTimeStampTZ, OracleIntervalYM)

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

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

OracleTimeStampTZ

備考

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

関連項目:

operator +(OracleTimeStampTZ, TimeSpan)

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

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

OracleTimeStampTZ

備考

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

関連項目:

operator ==

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

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

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

備考

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

operator >

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

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

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

備考

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

operator >=

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

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

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

備考

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

operator !=

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

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

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

備考

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

operator <

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

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

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

備考

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

operator <=

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

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

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

備考

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

operator -

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

オーバーロード一覧:

operator - (OracleTimeStampTZ, OracleIntervalDS)

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

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

OracleTimeStampTZ構造体

備考

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

関連項目:

operator - (OracleTimeStampTZ, OracleIntervalYM)

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

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

OracleTimeStampTZ構造体

備考

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

関連項目:

operator - (OracleTimeStampTZ value1, TimeSpan value2)

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

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

OracleTimeStampTZ構造体

備考

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

関連項目:

OracleTimeStampTZのstatic型変換

OracleTimeStampTZのstatic型変換を表5-123に示します。

表5-123 OracleTimeStampTZのstatic型変換
演算子 説明

explicit operator OracleTimeStampTZ

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

implicit operator OracleTimeStampTZ

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

explicit operator DateTime

OracleTimeStampTZ値を現在のタイム・ゾーンでDateTime構造体に変換します。

関連項目:

explicit operator OracleTimeStampTZ

explicit operator OracleTimeStampTZは、インスタンス値をOracleTimeStampTZ構造体に変換します。

オーバーロード一覧:

explicit operator OracleTimeStampTZ(OracleTimeStamp)

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

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

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

備考

スレッドのOracleGlobalization.TimeZoneを使用してOracleTimeStamp構造体からOracleTimeStampTZ構造体に変換します。

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

関連項目:

explicit operator OracleTimeStampTZ(OracleTimeStampLTZ)

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

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

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

備考

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

関連項目:

explicit operator OracleTimeStampTZ(string)

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

implicit operator OracleTimeStampTZは、DateTime構造体をOracleTimeStampTZ構造体に変換します。

オーバーロード一覧:

implicit operator OracleTimeStampTZ(OracleDate)

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

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

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

備考

スレッドのOracleGlobalization.TimeZoneを使用してOracleDateからOracleTimeStampTZ構造体に変換します。OracleDate構造体がnull値を持つ場合、返されるOracleTimeStampTZ構造体もnull値を持ちます。

関連項目:

implicit operator OracleTimeStampTZ(DateTime)

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

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

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

備考

スレッドのOracleGlobalization.TimeZoneを使用してDateTimeからOracleTimeStampTZ構造体に変換します。

関連項目:

explicit operator DateTime

このstatic型変換演算子は、OracleTimeStampTZ値を現在のタイム・ゾーンでDateTime構造体に変換します。

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

現在のインスタンスの日時を含むDateTime。ただし、そのタイム・ゾーン情報は切り捨てられます。

例外

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

備考

OracleTimeStampTZ値の精度は、変換時に失われる場合があります。また、現在のインスタンスのタイム・ゾーン情報は切り捨てられます。

関連項目:

OracleTimeStampTZのプロパティ

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

表5-124 OracleTimeStampTZのプロパティ
プロパティ 説明

BinData

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

Day

OracleTimeStampTZの日の構成要素を現在のタイム・ゾーンで指定します。

IsNull

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

Hour

OracleTimeStampTZの時の構成要素を現在のタイム・ゾーンで指定します。

Millisecond

OracleTimeStampTZのミリ秒の構成要素を現在のタイム・ゾーンで指定します。

Minute

OracleTimeStampTZの分の構成要素を現在のタイム・ゾーンで指定します。

Month

OracleTimeStampTZの月の構成要素を現在のタイム・ゾーンで指定します。

Nanosecond

OracleTimeStampTZのナノ秒の構成要素を現在のタイム・ゾーンで指定します。

Second

OracleTimeStampTZの秒の構成要素を現在のタイム・ゾーンで指定します。

TimeZone

OracleTimeStampTZインスタンスのタイム・ゾーンを返します。

Value

OracleTimeStampTZ構造体に格納されている日時を現在のタイム・ゾーンで返します。

Year

OracleTimeStampTZの年の構成要素を現在のタイム・ゾーンで指定します。

関連項目:

BinData

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

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

OracleのTIMESTAMP WITH TIME ZONEをOracleの内部形式で表す指定されたバイト配列

例外

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

関連項目:

Day

このプロパティは、OracleTimeStampTZの日の構成要素を現在のタイム・ゾーンで指定します。

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

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

例外

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

関連項目:

IsNull

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

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

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

関連項目:

Hour

このプロパティは、OracleTimeStampTZの時の構成要素を現在のタイム・ゾーンで指定します。

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

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

例外

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

関連項目:

Millisecond

このプロパティは、OracleTimeStampTZのミリ秒の構成要素を現在のタイム・ゾーンで取得します。

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

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

例外

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

関連項目:

Minute

このプロパティは、OracleTimeStampTZの分の構成要素を現在のタイム・ゾーンで取得します。

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

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

例外

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

関連項目:

Month

このプロパティは、OracleTimeStampTZの月の構成要素を現在のタイム・ゾーンで取得します。

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

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

例外

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

関連項目:

Nanosecond

このプロパティは、OracleTimeStampTZのナノ秒の構成要素を現在のタイム・ゾーンで取得します。

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

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

例外

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

関連項目:

Second

このプロパティは、OracleTimeStampTZの秒の構成要素を現在のタイム・ゾーンで取得します。

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

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

例外

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

関連項目:

TimeZone

このプロパティは、OracleTimeStampTZインスタンスのタイム・ゾーンを返します。

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

タイム・ゾーンを表す文字列

備考

タイム・ゾーンがコンストラクタで指定されていない場合、このプロパティはスレッドのOracleGlobalization.TimeZoneにデフォルトで設定されます。

関連項目:

Value

このプロパティは、OracleTimeStampTZ構造体に格納されている日時を現在のタイム・ゾーンで返します。

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

現在のタイム・ゾーンのDateTime

例外

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

関連項目:

Year

このプロパティは、OracleTimeStampTZの年の構成要素を現在のタイム・ゾーンで設定します。

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

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

例外

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

関連項目:

OracleTimeStampTZのメソッド

OracleTimeStampTZのメソッドを表5-125に示します。

表5-125 OracleTimeStampTZのメソッド
メソッド 説明

AddDays

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

AddHours

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

AddMilliseconds

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

AddMinutes

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

AddMonths

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

AddNanoseconds

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

AddSeconds

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

AddYears

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

CompareTo

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

Equals

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

GetDaysBetween

OracleTimeStampTZを現在のインスタンスから減算し、その時間間隔を表すOracleIntervalDSを返します。

GetHashCode

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

GetTimeZoneOffset

現在のOracleTimeStampTZの時と分のタイム・ゾーン情報を取得します。

GetYearsBetween

OracleTimeStampTZを現在のインスタンスから減算し、その時間間隔を表すOracleIntervalYMを返します。

GetType

Objectから継承されます。

ToLocalTime

現在のOracleTimeStampTZインスタンスを地方時に変換します。

ToOracleDate

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

ToOracleTimeStampLTZ

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

ToOracleTimeStamp

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

ToString

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

ToUniversalTime

現在の日時を協定世界時(UTC)に変換します。

関連項目:

AddDays

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

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

OracleTimeStampTZ

例外

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

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

関連項目:

AddHours

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

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

OracleTimeStampTZ

例外

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

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

関連項目:

AddMilliseconds

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

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

OracleTimeStampTZ

例外

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

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

関連項目:

AddMinutes

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

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

OracleTimeStampTZ

例外

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

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

関連項目:

AddMonths

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

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

OracleTimeStampTZ

例外

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

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

関連項目:

AddNanoseconds

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

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

OracleTimeStampTZ

例外

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

関連項目:

AddSeconds

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

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

OracleTimeStampTZ

例外

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

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

関連項目:

AddYears

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

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

OracleTimeStampTZ

例外

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

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

関連項目:

CompareTo

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

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

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

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

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

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

実装

IComparable

例外

ArgumentException: objOracleTimeStampTZ型ではありません。

備考

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

Equals

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

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

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

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

備考

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

GetDaysBetween

このメソッドは、OracleTimeStampTZ値を現在のインスタンスから減算し、その時間間隔を表すOracleIntervalDSを返します。

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

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

備考

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

関連項目:

GetHashCode

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

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

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

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

関連項目:

GetTimeZoneOffset

このメソッドは、現在のOracleTimeStampTZの時と分のタイム・ゾーンに関する情報を取得します。

宣言
// C#
public TimeSpan GetTimeZoneOffset();
戻り値

TimeSpan

例外

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

関連項目:

GetYearsBetween

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

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

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

備考

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

関連項目:

ToLocalTime

このメソッドは、現在のOracleTimeStampTZインスタンスを地方時に変換します。

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

現在のインスタンスの(クライアントのローカル・タイム・ゾーンに合せられた)日時を含むOracleTimeStampLTZ構造体

備考

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

関連項目:

ToOracleDate

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

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

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

備考

OracleTimeStampTZ値の精度は、変換時に失われる場合があります。また、現在のインスタンスのタイム・ゾーン情報は切り捨てられます。

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

関連項目:

ToOracleTimeStampLTZ

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

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

返されるOracleTimeStampLTZ構造体には、現在のインスタンスの(クライアントのローカル・タイム・ゾーンに合せられた)日時が含まれます。

備考

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

関連項目:

ToOracleTimeStamp

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

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

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

備考

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

関連項目:

ToString

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"

関連項目:

ToUniversalTime

このメソッドは、現在の日時を協定世界時(UTC)に変換します。

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

OracleTimeStampTZ構造体

備考

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

関連項目:

ODP.NET型の例外

この項では、ODP.NET型の例外について説明します。


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
索引