---

CreateOraTimeStampTZメソッド

適用対象

OraSessionオブジェクト

説明

新規OraTimeStampTZオブジェクトを作成します。このOraTimeStampTZオブジェクトは、Oracle TIMESTAMP WITH TIME ZONEデータ型を表します。

使用方法

Set OraTimeStampTZObj = OraSession.CreateOraTimeStampTZ value format

引数

このメソッドの引数は、次のとおりです。

引数	説明
[in] value	Variant型の文字列、日付またはOraTimeStampTZ。
[[in] [オプション] format	OraTimeStampTZオブジェクトを文字列として表示または解析するときに使用するTIMESTAMP WITH TIME ZONE書式文字列。書式を指定しない場合、TIMESTAMP WITH TIME ZONE文字列は、セッションのTIMESTAMP WITH TIME ZONE書式(NLS_TIMESTAMP_TZ_FORMAT書式)を使用して解析されます。

戻り値

OraTimeStampTZオブジェクト

備考

OraTimeStampTZオブジェクトの作成前に、OraSessionオブジェクトを作成する必要があります。

valueがVariant型の文字列の場合、文字列の書式は、書式を指定した場合は書式引数で指定した日時書式と一致する必要があります。書式を指定しない場合はセッションのTIMESTAMP WITH TIME ZONE書式(NLS_TIMESTAMP_TZ_FORMAT)と一致する必要があります。

valueがVariant型のDateの場合、Dateの日時値は、セッションのタイムゾーンの日時値として解析されます。OraTimeStampTZオブジェクトのTimeZoneプロパティには、セッションのタイムゾーンが含まれます。

formatを指定した場合は、その書式がOraTimeStampTZオブジェクトのFormatプロパティに格納されます。指定しない場合は、セッションのTIMESTAMP WITH TIME ZONE書式がOraTimeStampTZオブジェクトのFormatプロパティに格納されます。

例

Dim oraTSZ as OraTimeStampTZ 
Dim oraTSZ1 as OraTimeStampTZ 
Dim date as Date 
 
'Create an OraTimeStampTZ using a string assuming the session 
'TIMESTAMP WITH TIME ZONE format is "DD-MON-RR HH.MI.SSXFF AM TZH:TZM"
Set oraTSZ = oo4oSession.CreateOraTimeStampTZ( "12-JAN-2003" & _
             "12.0.0.0 PM -03:00") 
 
'Create an OraTimeStampTZ using a string and a format 
Set oraTSZ = oo4oSession.CreateOraTimeStampTZ( "2003-01-12" & _
             "12:00:00 PM -03:00", "YYYY-MM-DD HH:MI:SS AM TZH:TZM") 
 
'Create an OraTimeStampTZ using a Date 
date = #1/12/2003# 
Set oraTSZ = oo4oSession.CreateOraTimeStampTZ(date) 
 
'Create an OraTimeStampTZ  using an OraTimeStampTZ 
Set oraTSZ1 = oo4oSession.CreateOraTimeStampTZ(oraTSZ) 

関連項目: OraTimeStampTZオブジェクト OraNumberオブジェクト