Value (OraTimeStampTZ) Property

Applies To

OraTimeStampTZ Object

Description

When read, Value provides a string representation of the value of the OraTimeStampTZ object. If the Format property is not null, the output string format is in the format specified by Format; otherwise, the output string format is in the session TIMESTAMP WITH TIME ZONE format (NLS_TIMESTAMP_TZ_FORMAT). When set, Value accepts a Variant of type String, Date, or OraTimeStampTZ.

Arguments

[in] value

A Variant of type String, Date, or OraTimeStampTZ.

Usage

string = OraTimeStampTZObj.Value

OraTimeStampObjTZ.Value= value

Datatype

String

Remarks

If the Variant is of type String and Format is not null, the string format must match the Format property. If the Format property is null, the string format must match the session TIMESTAMP WITH TIME ZONE format.

If the Variant is of type Date, the date time value in Date is interpreted as the date time value in the session time zone. The time zone information in the OraTimeStampTZ object contains the session time zone.

Example

Dim OraTimeStampTZ As OraTimeStampTZ

...

Set OraTimeStampTZ = OraSession.CreateOraTimeStampTZ("2003-APR-29

      12:00:00 -07:00", "YYYY-MON-DD HH:MI:SS TZH:TZM")

'returns a string for the Value property

tstzStr = OraTimeStampTZ.Value

...

'set OraTimeStampTZ.Value using a string

OraTimeStampTZ.Value = "2003-APR-29 12:00:00 -07:00"

Also see OraSession.CreateOraTimeStampTZ for more information.