OracleTimeStampTZ
構造は、データベースに格納されるか、またはデータベースから取得されるOracle TIMESTAMP
WITH
TIME
ZONE
データ型を表します。各OracleTimeStampTZ
には、年、月、日、時、分、秒、ナノ秒およびタイムゾーンの情報が格納されます。
クラスの継承
System.Object
System.ValueType
Oracle.DataAccess.Types.OracleTimeStampTZ
宣言
// ADO.NET 2.0: C# public struct OracleTimeStampTZ : IComparable, INullable, IXmlSerializable
スレッド安全性
パブリック静的メソッドはスレッドセーフですが、インスタンス・メソッドではスレッド安全性は保証されません。
例
// C# using System; using Oracle.DataAccess.Client; using Oracle.DataAccess.Types; class OracleTimeStampTZSample { static void Main() { // Set the nls parameters for the current thread OracleGlobalization info = OracleGlobalization.GetClientInfo(); info.TimeZone = "US/Eastern"; info.TimeStampFormat = "DD-MON-YYYY HH:MI:SS.FF AM"; info.TimeStampTZFormat = "DD-MON-YYYY HH:MI:SS.FF AM TZR"; OracleGlobalization.SetThreadInfo(info); // 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
Microsoft .NET Framework Version: 2.0以降
OracleTimeStampTZ
メンバーを次の表にリストします。
OracleTimeStampTZコンストラクタ
OracleTimeStampTZ
コンストラクタを、表14-113にリストします。
OracleTimeStampTZ静的フィールド
OracleTimeStampTZ
静的フィールドを、表14-114にリストします。
表14-114 OracleTimeStampTZ静的フィールド
フィールド | 説明 |
---|---|
|
UTCでの |
|
UTCでの |
|
OracleTimeStampTZ静的メソッド
OracleTimeStampTZ
静的メソッドを、表14-115にリストします。
表14-115 OracleTimeStampTZ静的メソッド
メソッド | 説明 |
---|---|
|
2つの |
現在の日時を表す |
|
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
|
|
指定された小数秒精度を使用して、 |
OracleTimeStampTZ静的演算子
OracleTimeStampTZ
静的演算子を、表14-116にリストします。
表14-116 OracleTimeStampTZ静的演算子
演算子 | 説明 |
---|---|
指定されたインスタンス値を指定された |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
指定されたインスタンス値を指定された |
OracleTimeStampTZ静的型変換
OracleTimeStampTZ
静的型変換を、表14-117にリストします。
表14-117 OracleTimeStampTZ静的型変換
演算子 | 説明 |
---|---|
インスタンス値を |
|
インスタンス値を |
|
|
OracleTimeStampTZプロパティ
OracleTimeStampTZ
プロパティを、表14-118にリストします。
表14-118 OracleTimeStampTZプロパティ
プロパティ | 説明 |
---|---|
|
Oracleの |
|
|
|
現行インスタンスにNULL値があるかどうかを示します |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
OracleTimeStampTZメソッド
OracleTimeStampTZ
メソッドを、表14-119にリストします。
表14-119 OracleTimeStampTZメソッド
メソッド | 説明 |
---|---|
|
指定された日数を現行インスタンスに追加します |
|
指定された時間数を現行インスタンスに追加します |
|
指定されたミリ秒数を現行インスタンスに追加します |
|
指定された分数を現行インスタンスに追加します |
|
指定された月数を現行インスタンスに追加します |
指定されたナノ秒数を現行インスタンスに追加します |
|
指定された秒数を現行インスタンスに追加します |
|
|
指定された年数を現行インスタンスに追加します |
|
現行の |
|
オブジェクトの日時が現行の |
|
現行インスタンスから |
|
|
|
現行の |
|
現行インスタンスから |
GetType |
|
|
現行の |
|
現行の |
|
現行の |
|
現行の |
|
現行の |
|
現行の日時を協定世界時(UTC)に変換します |
OracleTimeStampTZ
コンストラクタはOracleTimeStampTZ
構造の新規インスタンスを作成します。
オーバーロード・リスト:
このコンストラクタはOracleTimeStampTZ
構造の新規インスタンスを作成し、指定されたDateTime
値を使用して日付および時間の値を設定します。
OracleTimeStampTZ(DateTime, string)
このコンストラクタはOracleTimeStampTZ
構造の新規インスタンスを作成し、指定されたDateTime
値およびタイムゾーン・データを使用して日付および時間の値を設定します。
このコンストラクタはOracleTimeStampTZ
構造の新規インスタンスを作成し、指定された文字列を使用して日付および時間の値を設定します。
OracleTimeStampTZ(int, int, int)
このコンストラクタはOracleTimeStampTZ
構造の新規インスタンスを作成し、年、月および日を使用して日付および時間の値を設定します。
OracleTimeStampTZ(int, int, int, string)
このコンストラクタはOracleTimeStampTZ
構造の新規インスタンスを作成し、年、月、日およびタイムゾーン・データを使用して日付および時間の値を設定します。
OracleTimeStampTZ(int, int, int, int, int, int)
このコンストラクタはOracleTimeStampTZ
構造の新規インスタンスを作成し、年、月、日、時間、分および秒を使用して日付および時間の値を設定します。
OracleTimeStampTZ(int, int, int, int, int, int, string)
このコンストラクタはOracleTimeStampTZ
構造の新規インスタンスを作成し、年、月、日、時間、分、秒およびタイムゾーン・データを使用して日付および時間の値を設定します。
OracleTimeStampTZ(int, int, int, int, int, int, double)
このコンストラクタはOracleTimeStampTZ
構造の新規インスタンスを作成し、年、月、日、時間、分、秒およびミリ秒を使用して日付および時間の値を設定します。
OracleTimeStampTZ(int, int, int, int, int, int, double, string)
このコンストラクタはOracleTimeStampTZ
構造の新規インスタンスを作成し、年、月、日、時間、分、秒、ミリ秒およびタイムゾーン・データを使用して日付および時間の値を設定します。
OracleTimeStampTZ(int, int, int, int, int, int, int)
このコンストラクタはOracleTimeStampTZ
構造の新規インスタンスを作成し、年、月、日、時間、分、秒およびナノ秒を使用して日付および時間の値を設定します。
OracleTimeStampTZ(int, int, int, int, int, int, int, string)
このコンストラクタはOracleTimeStampTZ
構造の新規インスタンスを作成し、年、月、日、時間、分、秒、ナノ秒およびタイムゾーン・データを使用して日付および時間の値を設定します。
このコンストラクタはOracleTimeStampTZ
構造の新規インスタンスを作成し、その値を内部のOracleのTIMESTAMP
WITH
TIME
ZONE
書式を表す指定されたバイト配列に設定します。
このコンストラクタはOracleTimeStampTZ
構造の新規インスタンスを作成し、指定されたDateTime
値を使用して日付および時間の値を設定します。
宣言
// C#
public OracleTimeStampTZ (DateTime dt);
パラメータ
dt
指定されたDateTime
値
備考
タイムゾーンは、スレッドOracleGlobalization.TimeZone
に設定されます。
例外
ArgumentException
: 有効なOracleTimeStampTZ
の構成にdt
パラメータを使用することはできません。
このコンストラクタは、指定されたDateTime
値とタイムゾーン・データを使用してOracleTimeStampTZ
構造の新規インスタンスを作成します。
宣言
// C# public OracleTimeStampTZ (DateTime value1, string timeZone);
パラメータ
value1
指定されたDateTime
値
timeZone
指定されたタイムゾーンのデータ。
例外
ArgumentException
: 有効なOracleTimeStampTZ
の構成にパラメータの引数値を使用することはできません。
備考
timeZone
は、時間オフセット(7:00など)か、US/PacificのようなV$TIMEZONE_NAMES
で指定される有効なタイムゾーンのリージョン名です。タイムゾーンの略称はサポートされていません
タイムゾーンがNULLの場合、スレッドのOracleGlobalization.TimeZone
が使用されます。
注意: PSTは、タイムゾーンのリージョン名および略称のため、OracleTimeStampTZ によって認証されます。 |
このコンストラクタはOracleTimeStampTZ
構造の新規インスタンスを作成し、指定された文字列を使用して日付および時間の値を設定します。
宣言
// C#
public OracleTimeStampTZ (string tsStr);
パラメータ
tsStr
OracleのTIMESTAMP
WITH
TIME
ZONE
を表す文字列
例外
ArgumentException
: tsStr
がOracleのTIMESTAMP
WITH
TIME
ZONE
を表す文字列として無効であるか、tsStr
がスレッドのOracleGlobalization
.TimeStampTZFormat
プロパティによって指定されたタイムスタンプ書式ではありません。
ArgumentNullException
: tsStr
値はNULLです。
備考
月および日付に使用されている名称および略称は、スレッドのOracleGlobalization
オブジェクトのDateLanguage
およびCalendar
プロパティで指定されている言語による表記です。スレッドのグローバリゼーション・プロパティのいずれかがNULLまたは空の文字列に設定されている場合、クライアントのコンピュータの設定が使用されます。
例
// C# using System; using Oracle.DataAccess.Client; using Oracle.DataAccess.Types; class OracleTimeStampTZSample { static void Main() { OracleGlobalization info = OracleGlobalization.GetClientInfo(); info.TimeStampTZFormat = "DD-MON-YYYY HH:MI:SS.FF AM TZR"; OracleGlobalization.SetThreadInfo(info); // 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 info.TimeStampTZFormat = "YYYY-MON-DD HH:MI:SS.FF AM TZR"; OracleGlobalization.SetThreadInfo(info); // Prints "1999-NOV-11 11:02:33.444000000 AM US/Pacific" Console.WriteLine(tstz.ToString()); } }
関連項目:
|
このコンストラクタはOracleTimeStampTZ
構造の新規インスタンスを作成し、年、月および日を使用して日付および時間の値を設定します。
宣言
// C#
public
OracleTimeStampTZ(int year, int month, int day);
パラメータ
year
指定された年。year
の範囲は(-4712から9999)です。
month
指定された月。month
の範囲は(1から12)です。
day
指定された日付。day
の範囲は(1から31)です。
例外
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など)か、US/PacificのようなV$TIMEZONE_NAMES
で指定される有効なタイムゾーンのリージョン名です。タイムゾーンの略称はサポートされていません
タイムゾーンがNULLの場合、スレッドのOracleGlobalization.TimeZone
が使用されます。
注意: PSTは、タイムゾーンのリージョン名および略称のため、OracleTimeStampTZ によって認証されます。 |
このコンストラクタはOracleTimeStampTZ
構造の新規インスタンスを作成し、年、月、日、時間、分および秒を使用して日付および時間の値を設定します。
宣言
// C#public OracleTimeStampTZ(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
: 有効な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
の範囲は(0から23)です。
分
指定された分。minute
の範囲は(0から59)です。
秒
指定された秒。second
の範囲は(0から59)です。
timeZone
指定されたタイムゾーンのデータ。
例外
ArgumentOutOfRangeException
: 1つ以上のパラメータの引数が、指定範囲を超えています。
ArgumentException
: 有効なOracleTimeStampTZ
の構成にパラメータの引数値を使用することはできません(つまり、日が月の範囲外であるか、タイムゾーンが無効です)。
備考
timeZone
は、時間オフセット(7:00など)か、US/PacificのようなV$TIMEZONE_NAMES
で指定される有効なタイムゾーンのリージョン名です。タイムゾーンの略称はサポートされていません
タイムゾーンがNULLの場合、スレッドのOracleGlobalization.TimeZone
が使用されます。
注意: PSTは、タイムゾーンのリージョン名および略称のため、OracleTimeStampTZ によって認証されます。 |
このコンストラクタは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
の範囲は(0から23)です。
分
指定された分。minute
の範囲は(0から59)です。
秒
指定された秒。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
の範囲は(0から23)です。
分
指定された分。minute
の範囲は(0から59)です。
秒
指定された秒。second
の範囲は(0から59)です。
millisecond
指定されたミリ秒。millisecond
の範囲は(0から999.999999)です。
timeZone
指定されたタイムゾーンのデータ。
例外
ArgumentOutOfRangeException
: 1つ以上のパラメータの引数が、指定範囲を超えています。
ArgumentException
: 有効なOracleTimeStampTZ
の構成にパラメータの引数値を使用することはできません(つまり、日が月の範囲外であるか、タイムゾーンが無効です)。
備考
timeZone
は、時間オフセット(7:00など)か、US/PacificのようなV$TIMEZONE_NAMES
で指定される有効なタイムゾーンのリージョン名です。タイムゾーンの略称はサポートされていません
タイムゾーンがNULLの場合、スレッドのOracleGlobalization.TimeZone
が使用されます。
注意: PSTは、タイムゾーンのリージョン名および略称のため、OracleTimeStampTZ によって認証されます。 |
このコンストラクタは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
の範囲は(0から23)です。
分
指定された分。minute
の範囲は(0から59)です。
秒
指定された秒。second
の範囲は(0から59)です。
ナノ秒
指定されたナノ秒。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
の範囲は(0から23)です。
分
指定された分。minute
の範囲は(0から59)です。
秒
指定された秒。second
の範囲は(0から59)です。
ナノ秒
指定されたナノ秒。nanosecond
の範囲は(0から999999999)です。
timeZone
指定されたタイムゾーンのデータ。
例外
ArgumentOutOfRangeException
: 1つ以上のパラメータの引数が、指定範囲を超えています。
ArgumentException
: 有効なOracleTimeStampTZ
の構成にパラメータの引数値を使用することはできません(つまり、日が月の範囲外であるか、タイムゾーンが無効です)。
備考
timeZone
は、時間オフセット(7:00など)か、US/PacificのようなV$TIMEZONE_NAMES
で指定される有効なタイムゾーンのリージョン名です。タイムゾーンの略称はサポートされていません
タイムゾーンがNULLの場合、スレッドのOracleGlobalization.TimeZone
が使用されます。
注意: PSTは、タイムゾーンのリージョン名および略称のため、OracleTimeStampTZ によって認証されます。 |
このコンストラクタはOracleTimeStampTZ
構造の新規インスタンスを作成し、その値を内部のOracleのTIMESTAMP
WITH
TIME
ZONE
書式を表す指定されたバイト配列に設定します。
宣言
// C#
public
OracleTimeStampLTZ (byte[] bytes);
パラメータ
bytes
OracleのTIMESTAMP
WITH
TIME
ZONE
をOracleの内部書式で表す指定されたバイト配列です。
例外
ArgumentException
: bytes
が内部のOracleのTIMESTAMP
WITH
TIME
ZONE
書式でないか、bytes
が有効なOracleのTIMESTAMP
WITH
TIME
ZONE
ではありません。
ArgumentNullException
: bytes
がNULLです。
OracleTimeStampTZ
静的フィールドを、表14-120にリストします。
表14-120 OracleTimeStampTZ静的フィールド
フィールド | 説明 |
---|---|
|
UTCでの |
|
UTCでの |
|
この静的フィールドは、UTCでのOracleTimeStampTZ
構造の最大有効日時、9999年12月31日23時59分59.999999999秒を表します。
宣言
// C# public static readonly OracleTimeStampTZ MaxValue;
この静的フィールドは、UTCでのOracleTimeStampTZ
構造の最小有効日時、-4712年1月1日0時0分0秒を表します。
宣言
// C# public static readonly OracleTimeStampTZ MinValue;
この静的フィールドは、OracleTimeStampTZ
構造のインスタンスに割当て可能なNULL値を表します。
宣言
// C# public static readonly OracleTimeStampTZ Null;
OracleTimeStampTZ
静的メソッドを、表14-121にリストします。
表14-121 OracleTimeStampTZ静的メソッド
メソッド | 説明 |
---|---|
|
2つの |
現在の日時を表す |
|
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
|
|
指定された小数秒精度を使用して、 |
この静的メソッドは、2つのOracleTimeStampTZ
の値が等しいかどうかを判断します。
宣言
// C# public static bool Equals(OracleTimeStampTZ value1, OracleTimeStampTZ value2);
パラメータ
value1
最初のOracleTimeStampTZ
value2
2番目のOracleTimeStampTZ
戻り値
2つのOracleTimeStampTZ
の値が等しい場合はtrue
を戻します。それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStampTZ
は、NULL値を持つOracleTimeStampTZ
より大きくなります。
NULL値を含む2つのOracleTimeStampTZ
は等しくなります。
この静的メソッドは、現行の日付と時間を表すOracleTimeStampTZ
構造を取得します。
宣言
// C# public static OracleTimeStampTZ GetSysDate();
戻り値
現行の日付と時間を表すOracleTimeStampTZ
構造
この静的メソッドは、2つのOracleTimeStampTZ
の1番目の値が2番目の値より大きいかどうかを判断します。
宣言
// C# public static bool GreaterThan(OracleTimeStampTZ value1, OracleTimeStampTZ value2);
パラメータ
value1
最初のOracleTimeStampTZ
value2
2番目のOracleTimeStampTZ
戻り値
2つのOracleTimeStampTZ
の1番目の値が2番目の値より大きい場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStampTZ
は、NULL値を持つOracleTimeStampTZ
より大きくなります。
NULL値を含む2つのOracleTimeStampTZ
は等しくなります。
この静的メソッドは、2つのOracleTimeStampTZ
の1番目の値が2番目の値以上であるかどうかを判断します。
宣言
// C# public static bool GreaterThanOrEqual(OracleTimeStampTZ value1, OracleTimeStampTZ value2);
パラメータ
value1
最初のOracleTimeStampTZ
value2
2番目のOracleTimeStampTZ
戻り値
2つのOracleTimeStampTZ
の1番目の値が2番目の値以上である場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStampTZ
は、NULL値を持つOracleTimeStampTZ
より大きくなります。
NULL値を含む2つのOracleTimeStampTZ
は等しくなります。
この静的メソッドは、2つのOracleTimeStampTZ
の1番目の値が2番目の値より小さいかどうかを判断します。
宣言
// C# public static bool LessThan(OracleTimeStampTZ value1, OracleTimeStampTZ value2);
パラメータ
value1
最初のOracleTimeStampTZ
value2
2番目のOracleTimeStampTZ
戻り値
2つのOracleTimeStampTZ
の1番目の値が2番目の値より小さい場合はtrue
を戻します。それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStampTZ
は、NULL値を持つOracleTimeStampTZ
より大きくなります。
NULL値を含む2つのOracleTimeStampTZ
は等しくなります。
この静的メソッドは、2つのOracleTimeStampTZ
の1番目の値が2番目の値以下であるかどうかを判断します。
宣言
// C# public static bool LessThanOrEqual(OracleTimeStampTZ value1, OracleTimeStampTZ value2);
パラメータ
value1
最初のOracleTimeStampTZ
value2
2番目のOracleTimeStampTZ
戻り値
2つのOracleTimeStampTZ
の1番目の値が2番目の値以下である場合はtrue
を戻します。それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStampTZ
は、NULL値を持つOracleTimeStampTZ
より大きくなります。
NULL値を含む2つのOracleTimeStampTZ
は等しくなります。
この静的メソッドは、2つのOracleTimeStampTZ
の値が等しくないかどうかを判断します。
宣言
// C# public static bool NotEquals(OracleTimeStampTZ value1, OracleTimeStampTZ value2);
パラメータ
value1
最初のOracleTimeStampTZ
value2
2番目のOracleTimeStampTZ
戻り値
2つのOracleTimeStampTZ
の値が等しくない場合はtrue
を戻します。それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStampTZ
は、NULL値を持つOracleTimeStampTZ
より大きくなります。
NULL値を含む2つのOracleTimeStampTZ
は等しくなります。
この静的メソッドはOracleTimeStampTZ
構造を戻し、その日付および時間の値を指定された文字列を使用して設定します。
宣言
// C#
public static OracleTimeStampTZ Parse(string tsStr);
パラメータ
tsStr
OracleのTIMESTAMP
WITH
TIME
ZONE
を表す文字列
戻り値
OracleTimeStampTZ
構造
例外
ArgumentException
: tsStr
がOracleのTIMESTAMP
WITH
TIME
ZONE
を表す文字列として無効であるか、tsStr
がOracle NLS_TIMESTAMP_TZ_FORMAT
パラメータを表すスレッドのOracleGlobalization
.TimeStampTZFormat
プロパティによって指定されたタイムスタンプ書式ではありません。
ArgumentNullException
: tsStr
値はNULLです。
備考
月および日付に使用されている名称および略称は、スレッドのOracleGlobalization
オブジェクトのDateLanguage
およびCalendar
プロパティで指定されている言語による表記です。スレッドのグローバリゼーション・プロパティのいずれかがNULLまたは空の文字列に設定されている場合、クライアントのコンピュータの設定が使用されます。
例
// C# using System; using Oracle.DataAccess.Client; using Oracle.DataAccess.Types; class ParseSample { static void Main() { // Set the nls_timestamp_tz_format for the Parse() method OracleGlobalization info = OracleGlobalization.GetClientInfo(); info.TimeStampTZFormat = "DD-MON-YYYY HH:MI:SS.FF AM TZR"; OracleGlobalization.SetThreadInfo(info); // 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 info.TimeStampTZFormat = "YYYY-MON-DD HH:MI:SS.FF AM TZR"; OracleGlobalization.SetThreadInfo(info); // Prints "1999-NOV-11 11:02:33.444000000 AM US/Pacific" Console.WriteLine(tstz.ToString()); } }
この静的メソッドは、指定された小数秒精度でOracleTimeStampTZ
の新規インスタンスを戻します。
宣言
// C# public static OracleTimeStampTZ SetPrecision(OracleTimeStampTZ value1, int fracSecPrecision);
パラメータ
value1
指定されたOracleTimeStampTZ
オブジェクト
fracSecPrecision
指定された小数秒精度。小数秒精度の範囲は(0から9)です。
戻り値
指定された小数秒精度でのOracleTimeStampTZ
構造
例外
ArgumentOutOfRangeException
: fracSecPrecision
が指定範囲を超えています。
備考
fracSecPrecision
に指定する値は、OracleTimeStampTZ
値での四捨五入操作の実行に使用されます。この値に応じて、ToString()
によって戻される文字列に、後続のゼロが0
個以上表示されます。
例
OracleTimeStampTZ
の値がDecember 31,
9999
23:59:59.99
US/Pacific
である場合、小数秒精度を5
に設定してSetPrecision()
をコールすると、文字列December
31,
9999 23:59:59.99000
US/Pacific
が戻されます。
OracleTimeStampTZ
静的演算子を、表14-122にリストします。
表14-122 OracleTimeStampTZ静的演算子
演算子 | 説明 |
---|---|
指定されたインスタンス値を指定された |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
指定されたインスタンス値を指定された |
operator+
は指定された構造を指定されたOracleTimeStampTZ
に加え、新規OracleTimeStampTZ
構造を戻します。
オーバーロード・リスト:
operator +(OracleTimeStampTZ, OracleIntervalDS)
この静的演算子は指定されたOracleIntervalDS
を指定されたOracleTimeStampTZ
に加え、新規OracleTimeStampTZ
構造を戻します。
operator +(OracleTimeStampTZ, OracleIntervalYM)
この静的演算子は指定されたOracleIntervalYM
を指定されたOracleTimeStampTZ
に加え、新規OracleTimeStampTZ
構造を戻します。
operator +(OracleTimeStampTZ, TimeSpan)
この静的演算子は指定されたTimeSpan
を指定されたOracleTimeStampTZ
に加え、新規OracleTimeStampTZ
構造を戻します。
この静的演算子は指定されたOracleIntervalDS
を指定されたOracleTimeStampTZ
に加え、新規OracleTimeStampTZ
構造を戻します。
宣言
// C# public static operator +(OracleTimeStampTZ value1, OracleIntervalDS value2);
パラメータ
value1
OracleTimeStampTZ
value2
OracleIntervalDS
戻り値
OracleTimeStampTZ
備考
いずれかのパラメータにNULL値がある場合、戻されたOracleTimeStampTZ
にNULL値があります。
この静的演算子は指定されたOracleIntervalYM
を指定されたOracleTimeStampTZ
に加え、新規OracleTimeStampTZ
構造を戻します。
宣言
// C# public static operator +(OracleTimeStampTZ value1, OracleIntervalYM value2);
パラメータ
value1
OracleTimeStampTZ
value2
OracleIntervalYM
戻り値
OracleTimeStampTZ
備考
いずれかのパラメータにNULL値がある場合、戻されたOracleTimeStampTZ
にNULL値があります。
この静的演算子は指定されたTimeSpan
を指定されたOracleTimeStampTZ
に加え、新規OracleTimeStampTZ
構造を戻します。
宣言
// C# public static operator +(OracleTimeStampTZ value1, TimeSpan value2);
パラメータ
value1
OracleTimeStampTZ
value2
TimeSpan
戻り値
OracleTimeStampTZ
備考
OracleTimeStampTZ
インスタンスにNULL値がある場合、戻されたOracleTimeStampTZ
にNULL値があります。
この静的演算子は、2つのOracleTimeStampTZ
の値が等しいかどうかを判断します。
宣言
// C# public static bool operator == (OracleTimeStampTZ value1, OracleTimeStampTZ value2);
パラメータ
value1
最初のOracleTimeStampTZ
value2
2番目のOracleTimeStampTZ
戻り値
等しい場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStampTZ
は、NULL値を持つOracleTimeStampTZ
より大きくなります。
NULL値を含む2つのOracleTimeStampTZ
は等しくなります。
この静的演算子は、2つのOracleTimeStampTZ
の1番目の値が2番目の値より大きいかどうかを判断します。
宣言
// C# public static bool operator > (OracleTimeStampTZ value1, OracleTimeStampTZ value2);
パラメータ
value1
最初のOracleTimeStampTZ
value2
2番目のOracleTimeStampTZ
戻り値
1番目のOracleTimeStampTZ
の値が2番目の値より大きい場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStampTZ
は、NULL値を持つOracleTimeStampTZ
より大きくなります。
NULL値を含む2つのOracleTimeStampTZ
は等しくなります。
この静的演算子は、2つのOracleTimeStampTZ
の1番目の値が2番目の値以上であるかどうかを判断します。
宣言
// C# public static bool operator >= (OracleTimeStampTZ value1, OracleTimeStampTZ value2);
パラメータ
value1
最初のOracleTimeStampTZ
value2
2番目のOracleTimeStampTZ
戻り値
1番目のOracleTimeStampTZ
の値が2番目の値以上である場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStampTZ
は、NULL値を持つOracleTimeStampTZ
より大きくなります。
NULL値を含む2つのOracleTimeStampTZ
は等しくなります。
この静的演算子は、2つのOracleTimeStampTZ
の値が等しくないかどうかを判断します。
宣言
// C# public static bool operator != (OracleTimeStampTZ value1, OracleTimeStampTZ value2);
パラメータ
value1
最初のOracleTimeStampTZ
value2
2番目のOracleTimeStampTZ
戻り値
2つのOracleTimeStampTZ
の値が等しくない場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStampTZ
は、NULL値を持つOracleTimeStampTZ
より大きくなります。
NULL値を含む2つのOracleTimeStampTZ
は等しくなります。
この静的演算子は、2つのOracleTimeStampTZ
の1番目の値が2番目の値より小さいかどうかを判断します。
宣言
// C# public static bool operator < (OracleTimeStampTZ value1, OracleTimeStampTZ value2);
パラメータ
value1
最初のOracleTimeStampTZ
value2
2番目のOracleTimeStampTZ
戻り値
1番目のOracleTimeStampTZ
の値が2番目の値より小さい場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStampTZ
は、NULL値を持つOracleTimeStampTZ
より大きくなります。
NULL値を含む2つのOracleTimeStampTZ
は等しくなります。
この静的演算子は、2つのOracleTimeStampTZ
の1番目の値が2番目の値以下であるかどうかを判断します。
宣言
// C# public static bool operator <= (OracleTimeStampTZ value1, OracleTimeStampTZ value2);
パラメータ
value1
最初のOracleTimeStampTZ
value2
2番目のOracleTimeStampTZ
戻り値
1番目のOracleTimeStampTZ
の値が2番目の値以下である場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStampTZ
は、NULL値を持つOracleTimeStampTZ
より大きくなります。
NULL値を含む2つのOracleTimeStampTZ
は等しくなります。
operator-
は指定された値を指定されたOracleTimeStampTZ
値から差し引き、新規OracleTimeStampTZ
構造を戻します。
オーバーロード・リスト:
operator - (OracleTimeStampTZ, OracleIntervalDS)
この静的演算子は指定されたOracleIntervalDS
値を指定されたOracleTimeStampTZ
値から差し引き、新規OracleTimeStampTZ
構造を戻します。
operator - (OracleTimeStampTZ, OracleIntervalYM)
この静的演算子は指定されたOracleIntervalYM
値を指定されたOracleTimeStampTZ
値から差し引き、新規OracleTimeStampTZ
構造を戻します。
operator - (OracleTimeStampTZ value1, TimeSpan value2)
この静的演算子は指定されたTimeSpan
値を指定されたOracleTimeStampTZ
値から差し引き、新規OracleTimeStampTZ
構造を戻します。
この静的演算子は指定されたOracleIntervalDS
値を指定されたOracleTimeStampTZ
値から差し引き、新規OracleTimeStampTZ
構造を戻します。
宣言
// C# public static operator - (OracleTimeStampTZ value1, OracleIntervalDS value2);
パラメータ
value1
OracleTimeStampTZ
value2
OracleIntervalDS
戻り値
OracleTimeStampTZ
構造
備考
いずれかのパラメータにNULL値がある場合、戻されたOracleTimeStampTZ
にNULL値があります。
この静的演算子は指定されたOracleIntervalYM
値を指定されたOracleTimeStampTZ
値から差し引き、新規OracleTimeStampTZ
構造を戻します。
宣言
// C# public static operator - (OracleTimeStampTZ value1, OracleIntervalYM value2);
パラメータ
value1
OracleTimeStampTZ
value2
OracleIntervalYM
戻り値
OracleTimeStampTZ
構造
備考
いずれかのパラメータにNULL値がある場合、戻されたOracleTimeStampTZ
にNULL値があります。
この静的演算子は指定されたTimeSpan
値を指定されたOracleTimeStampTZ
値から差し引き、新規OracleTimeStampTZ
構造を戻します。
宣言
// C# public static operator - (OracleTimeStampTZ value1, TimeSpan value2);
パラメータ
value1
OracleTimeStampTZ
value2
TimeSpan
戻り値
OracleTimeStampTZ
構造
備考
OracleTimeStampTZ
インスタンスにNULL値がある場合、戻されたOracleTimeStampTZ
構造にNULL値があります。
OracleTimeStampTZ
静的型変換を、表14-123にリストします。
表14-123 OracleTimeStampTZ静的型変換
演算子 | 説明 |
---|---|
インスタンス値を |
|
インスタンス値を |
|
|
explicit operator OracleTimeStampTZ
は、インスタンス値をOracleTimeStampTZ
構造に変換します。
オーバーロード・リスト:
explicit operator OracleTimeStampTZ(OracleTimeStamp)
この静的型変換演算子は、OracleTimeStamp
値をOracleTimeStampTZ
構造に変換します。
explicit operator OracleTimeStampTZ(OracleTimeStampLTZ)
この静的型変換演算子は、OracleTimeStampLTZ
値をOracleTimeStampTZ
構造に変換します。
explicit operator OracleTimeStampTZ(string)
この静的型変換演算子は、指定された文字列の値をOracleTimeStampTZ
構造に変換します。
この静的型変換演算子は、OracleTimeStamp
値をOracleTimeStampTZ
構造に変換します。
宣言
// C# public static explicit operator OracleTimeStampTZ(OracleTimeStamp value1);
パラメータ
value1
OracleTimeStamp
戻り値
戻されたOracleTimeStampTZ
には、OracleTimeStamp
からの日付および時間と、スレッドのOracleGlobalization.TimeZone
からのタイムゾーンが含まれています。
備考
OracleTimeStamp
構造のOracleTimeStampTZ
構造への変換に、スレッドのOracleGlobalization.TimeZone
が使用されます。
OracleTimeStamp
構造にNULL値がある場合、戻されたOracleTimeStampTZ
構造にもNULL値があります。
この静的型変換演算子は、OracleTimeStampLTZ
値をOracleTimeStampTZ
構造に変換します。
宣言
// C#
public static explicit operator OracleTimeStampTZ(OracleTimeStampLTZ value1);
パラメータ
value1
OracleTimeStampLTZ
戻り値
戻されたOracleTimeStampTZ
には、OracleTimeStampLTZ
からの日付および時間と、スレッドのOracleGlobalization.TimeZone
からのタイムゾーンが含まれています。
備考
OracleTimeStampLTZ
構造にNULL値がある場合、戻されたOracleTimeStampTZ
構造にもNULL値があります。
この静的型変換演算子は、指定された文字列の値をOracleTimeStampTZ
構造に変換します。
宣言
// C#
public static explicit operator OracleTimeStampTZ(string tsStr);
パラメータ
tsStr
OracleのTIMESTAMP
WITH
TIME
ZONE
を表す文字列
戻り値
OracleTimeStampTZ
値
例外
ArgumentException
: tsStr
がOracleのTIMESTAMP
WITH
TIME
ZONE
を表す文字列として無効であるか、tsStr
がOracle NLS_TIMESTAMP_TZ_FORMAT
パラメータを表すスレッドのOracleGlobalization
.TimeStampTZFormat
プロパティによって指定されたタイムスタンプ書式ではありません。
備考
月および日付に使用されている名称および略称は、スレッドのOracleGlobalization
オブジェクトのDateLanguage
およびCalendar
プロパティで指定されている言語による表記です。スレッドのグローバリゼーション・プロパティのいずれかがNULLまたは空の文字列に設定されている場合、クライアントのコンピュータの設定が使用されます。
例
// C# using System; using Oracle.DataAccess.Client; using Oracle.DataAccess.Types; class OracleTimeStampTZSample { static void Main() { // Set the nls_timestamp_tz_format for the explicit operator // OracleTimeStampTZ(string) OracleGlobalization info = OracleGlobalization.GetClientInfo(); info.TimeStampTZFormat = "DD-MON-YYYY HH:MI:SS.FF AM TZR"; OracleGlobalization.SetThreadInfo(info); // 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 info.TimeStampTZFormat = "YYYY-MON-DD HH:MI:SS.FF AM TZR"; OracleGlobalization.SetThreadInfo(info); Console.WriteLine(tstz.ToString()); } }
implicit operator OracleTimeStampTZ
は、DateTime
構造をOracleTimeStampTZ
構造に変換します。
オーバーロード・リスト:
implicit operator OracleTimeStampTZ(OracleDate)
この静的型変換演算子は、OracleDate
値をOracleTimeStampTZ
構造に変換します。
implicit operator OracleTimeStampTZ(DateTime)
この静的型変換演算子は、DateTime
構造をOracleTimeStampTZ
構造に変換します。
この静的型変換演算子は、OracleDate
値をOracleTimeStampTZ
構造に変換します。
宣言
// C#
public static implicit operator OracleTimeStampTZ(OracleDate value1);
パラメータ
value1
OracleDate
戻り値
戻されたOracleTimeStampTZ
には、OracleDate
からの日付および時間と、スレッドのOracleGlobalization.TimeZone
からのタイムゾーンが含まれています。
備考
OracleDate
構造のOracleTimeStampTZ
構造への変換に、スレッドのOracleGlobalization.TimeZone
が使用されます。OracleDate
構造にNULL値がある場合、戻されたOracleTimeStampTZ
構造にもNULL値があります。
この静的型変換演算子は、DateTime
構造をOracleTimeStampTZ
構造に変換します。
宣言
// C#
public static implicit operator OracleTimeStampTZ (DateTime value1);
パラメータ
value1
DateTime
構造
戻り値
戻されたOracleTimeStampTZ
には、DateTime
からの日付および時間と、スレッドのOracleGlobalization.TimeZone
からのタイムゾーンが含まれています。
備考
DateTime
構造のOracleTimeStampTZ
構造への変換に、スレッドのOracleGlobalization.TimeZone
が使用されます。
この静的型変換演算子は、OracleTimeStampTZ
値をDateTime
構造に変換し、タイムゾーン情報を切り捨てます。
宣言
// C#
public static explicit operator DateTime(OracleTimeStampTZ value1);
パラメータ
value1
OracleTimeStampTZ
戻り値
現行インスタンスでの日付および時間を含むDateTime
ですが、現行インスタンスのタイムゾーン情報は切り捨てられています。
例外
OracleNullValueException
: OracleTimeStampTZ
構造にNULL値があります。
備考
OracleTimeStampTZ
値の精度が変換中に失われる場合があり、現行インスタンスのタイムゾーン情報は切り捨てられます。
OracleTimeStampTZ
プロパティを、表14-124にリストします。
表14-124 OracleTimeStampTZプロパティ
プロパティ | 説明 |
---|---|
|
Oracleの |
|
|
|
現行インスタンスにNULL値があるかどうかを示します |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
このプロパティは、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
メソッドを、表14-125にリストします。
表14-125 OracleTimeStampTZメソッド
メソッド | 説明 |
---|---|
|
指定された日数を現行インスタンスに追加します |
|
指定された時間数を現行インスタンスに追加します |
|
指定されたミリ秒数を現行インスタンスに追加します |
|
指定された分数を現行インスタンスに追加します |
|
指定された月数を現行インスタンスに追加します |
指定されたナノ秒数を現行インスタンスに追加します |
|
指定された秒数を現行インスタンスに追加します |
|
|
指定された年数を現行インスタンスに追加します |
|
現行の |
|
オブジェクトに現行の |
|
現行インスタンスから |
|
|
|
現行の |
|
現行インスタンスから |
GetType |
|
|
現行の |
|
現行の |
|
現行の |
|
現行の |
|
現行の |
|
現行の日時を協定世界時(UTC)に変換します |
このメソッドは、現行インスタンスに指定された日数を加えます。
宣言
// C#
public OracleTimeStampTZ AddDays(double days);
パラメータ
days
指定された日数。範囲は(-1,000,000,000 < days
< 1,000,000,000)です。
戻り値
OracleTimeStampTZ
例外
OracleNullValueException
: 現行インスタンスにはNULL値があります。
ArgumentOutofRangeException
: 引数値が指定範囲を超えています。
このメソッドは、現行インスタンスに指定された時間数を加えます。
宣言
// C#
public OracleTimeStampTZ AddHours(double hours);
パラメータ
hours
指定された時間数。範囲は(-24,000,000,000 < hours
< 24,000,000,000)です。
戻り値
OracleTimeStampTZ
例外
OracleNullValueException
: 現行インスタンスにはNULL値があります。
ArgumentOutofRangeException
: 引数値が指定範囲を超えています。
このメソッドは、現行インスタンスに指定されたミリ秒数を加えます。
宣言
// C#
public OracleTimeStampTZ AddMilliseconds(double milliseconds);
パラメータ
milliseconds
指定されたミリ秒数。範囲は(-8.64 * 1016< milliseconds
< 8.64 * 1016)です。
戻り値
OracleTimeStampTZ
例外
OracleNullValueException
: 現行インスタンスにはNULL値があります。
ArgumentOutofRangeException
: 引数値が指定範囲を超えています。
このメソッドは、現行インスタンスに指定された分数を加えます。
宣言
// C#
public OracleTimeStampTZ AddMinutes(double minutes);
パラメータ
minutes
指定された分数。範囲は(-1,440,000,000,000 < minutes
< 1,440,000,000,000)です。
戻り値
OracleTimeStampTZ
例外
OracleNullValueException
: 現行インスタンスにはNULL値があります。
ArgumentOutofRangeException
: 引数値が指定範囲を超えています。
このメソッドは、現行インスタンスに指定された月数を加えます。
宣言
// C#
public OracleTimeStampTZ AddMonths(long months);
パラメータ
months
指定された月数。範囲は(-12,000,000,000 < months
< 12,000,000,000)です。
戻り値
OracleTimeStampTZ
例外
OracleNullValueException
: 現行インスタンスにはNULL値があります。
ArgumentOutofRangeException
: 引数値が指定範囲を超えています。
このメソッドは、現行インスタンスに指定されたナノ秒数を加えます。
宣言
// C#
public OracleTimeStampTZ AddNanoseconds(long nanoseconds);
パラメータ
nanoseconds
指定されたナノ秒数
戻り値
OracleTimeStampTZ
例外
OracleNullValueException
: 現行インスタンスにはNULL値があります。
このメソッドは、現行インスタンスに指定された秒数を加えます。
宣言
// C#
public OracleTimeStampTZ AddSeconds(double seconds);
パラメータ
seconds
指定された秒数。範囲は(-8.64 * 1013< seconds
< 8.64 * 1013)です。
戻り値
OracleTimeStampTZ
例外
OracleNullValueException
: 現行インスタンスにはNULL値があります。
ArgumentOutofRangeException
: 引数値が指定範囲を超えています。
このメソッドは、現行インスタンスに指定された年数を加えます。
宣言
// C#
public OracleTimeStampTZ AddYears(int years);
パラメータ
years
指定された年数。範囲は(-999,999,999 <= years
< = 999,999,999)です。
戻り値
OracleTimeStampTZ
例外
OracleNullValueException
: 現行インスタンスにはNULL値があります。
ArgumentOutofRangeException
: 引数値が指定範囲を超えています。
このメソッドは現行のOracleTimeStampTZ
インスタンスをオブジェクトと比較し、これらの相対値を表す整数を戻します。
宣言
// C#
public int CompareTo(object obj);
パラメータ
obj
現行のOracleTimeStampTZ
インスタンスと比較されるオブジェクト
戻り値
メソッドが戻す数値は次のとおりです。
ゼロ未満:現行のOracleTimeStampTZ
インスタンス値がobj
値より小さい場合
ゼロ:現行のOracleTimeStampTZ
インスタンス値がobj
値と等しい場合
ゼロ超過:現行のOracleTimeStampTZ
インスタンス値がobj
値より大きい場合
実装
IComparable
例外
ArgumentException
: obj
がタイプOracleTimeStampTZ
ではありません。
備考
次のルールが、このメソッドの動作に適用されます。
比較はOracleTimeStampTZ
間で行う必要があります。たとえば、OracleTimeStampTZ
インスタンスとOracleBinary
インスタンスを比較することはできません。OracleTimeStampTZ
が別のタイプと比較されると、ArgumentException
がスローされます。
値を持つすべてのOracleTimeStampTZ
は、NULL値を持つOracleTimeStampTZ
より大きくなります。
NULL値を含む2つのOracleTimeStampTZ
は等しくなります。
Object
をオーバーライドします。
このメソッドは、オブジェクトの日付と時間が現行のOracleTimeStampTZ
インスタンスのものと同じかどうかを判断します。
宣言
// C#
public override bool Equals(object obj);
パラメータ
obj
現行のOracleTimeStampTZ
インスタンスと比較されるオブジェクト
戻り値
obj
がタイプOracleTimeStampTZ
であり、同じ日付と時間を表す場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleTimeStampTZ
は、NULL値を持つOracleTimeStampTZ
より大きくなります。
NULL値を含む2つのOracleTimeStampTZ
は等しくなります。
このメソッドはOracleTimeStampTZ
値を現行インスタンスから差し引き、時間間隔を表すOracleIntervalDS
を戻します。
宣言
// C#
public OracleIntervalDS GetDaysBetween(OracleTimeStampTZ value1);
パラメータ
value1
差し引かれるOracleTimeStampTZ
値
戻り値
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);
パラメータ
val
差し引かれるOracleTimeStampTZ
値
戻り値
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
構造と同じ日付と時刻を表すstring
備考
戻された値は、スレッドのOracleGlobalization
.TimeStampTZFormat
プロパティで指定された書式を使用して、OracleTimeStampTZ
を文字列で表したものです。月および日付に使用されている名称および略称は、スレッドのOracleGlobalization
.DateLanguage
およびOracleGlobalization.Calendar
プロパティで指定されている言語による表記です。スレッドのグローバリゼーション・プロパティのいずれかがNULLまたは空の文字列に設定されている場合、クライアントのコンピュータの設定が使用されます。
例
// C# using System; using Oracle.DataAccess.Client; using Oracle.DataAccess.Types; class ToStringSample { static void Main() { // Set the nls parameters for the current thread OracleGlobalization info = OracleGlobalization.GetClientInfo(); info.TimeZone = "US/Eastern"; info.TimeStampFormat = "DD-MON-YYYY HH:MI:SS.FF AM"; info.TimeStampTZFormat = "DD-MON-YYYY HH:MI:SS.FF AM TZR"; OracleGlobalization.SetThreadInfo(info); // 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); // Prints "US/Pacific" Console.WriteLine("tstz1.TimeZone = " + tstz1.TimeZone); // Prints "US/Eastern" Console.WriteLine("tstz2.TimeZone = " + tstz2.TimeZone); // Prints 3 Console.WriteLine("idsDiff.Hours = " + idsDiff.Hours); // Prints 0 Console.WriteLine("idsDiff.Minutes = " + idsDiff.Minutes); } }
このメソッドは、現行の日時を協定世界時(UTC)に変換します。
宣言
// C# public OracleTimeStampTZ ToUniversalTime();
戻り値
OracleTimeStampTZ
構造
備考
現行インスタンスにNULL値がある場合、戻されたOracleTimeStampTZ
構造の値にNULL値があります。