IntervalYM类¶

IntervalYM支持SQL标准数据类型年月间隔。

如何通过直接分配使用一个空间IntervalYM对象。

Environment *env = Environment::createEnvironment();

// 创建一个空的年月间隔

IntervalYM ym

if(ym.isNull())

   cout << "\n ym is null";

// 给ym赋一个非空值

IntervalYM anotherYM(env, "10-30");

ym=anotherYM;

如何通过ResultSet和toText()方法使用一个IntervalYM对象

//SELECT WARRANT_PERIOD from PRODUCT_INFORMATION

//获取结果集

resultset->next();

//从resultset中获取区间值

IntervalYM ym1 = resultset->getIntervalYM(1);

IntervalYM addWith(env, 10, 1);

ym1 += addWith;    //调用+= 运算符

IntervalYM mulYm1 = ym1 * Number(env, 10);    //调用* 运算符

if(ym1<mulYm1)    //比较

IntervalYM()¶

IntervalYM类构造函数。

语法

描述

IntervalYM();

构造一个空的区间对象。可以通过赋值操作符或调用方法operator*()初始化空间隔对象。可以对空间隔对象调用的方法是setName()和isNull()。

IntervalYM(

const Environment * env,

int year = 0,

int month = 0);

在指定的环境中创建IntervalYM对象

IntervalDS(

const IntervalYM &src);

拷贝构造函数。

参数	描述
env	环境
year	IntervalYM对象的年字段。
month	IntervalYM对象的month字段。
src	复制IntervalYM对象的源IntervalYM。

fromText()¶

此方法将间隔初始化为inpstr中的值。

语法

void fromText(

   const string &inpStr,

   const string &nlsParam = "",

   const Environment *env = NULL);

参数	描述
inpStr	代表intervalYM对象的输入字符串，格式例如'年-月'
nlsParam	不支持
env	环境指针

fromUText()¶

此方法将间隔初始化为inpstr中的值。

语法

void fromUText(

      const UString &inpstr,

      const Environment *env=NULL );

参数	描述
inpStr	代表intervalYM对象的输入字符串，格式例如'年-月'
env	环境指针

getMonth()¶

返回间隔的月份部分。

语法

int getMonth() const;

getYear()¶

语法

int getYear() const;

isNull()¶

此方法测试时间间隔是否为空。如果间隔为NULL，则返回TRUE;否则，返回FALSE。

语法

bool isNull() const;

operator*()¶

返回时间间隔乘以一个因子的结果。

语法

const IntervalYM operator*(

   const IntervalDS &interval

   const Number &val);

参数	描述
interval	要乘的间隔。
val	间隔要乘的值

operator*=()¶

计算间隔乘以指定的值的结果。

语法

IntervalYM& operator*=(

   const Number &factor);

参数	描述
factor	要乘的值。

operator=()¶

将指定的值赋给间隔。

语法

IntervalYM& operator=(

    const IntervalYM &src);

参数	描述
src	要分配的值。

operator==()¶

此方法比较指定的间隔。如果间隔相等，则返回TRUE;否则，返回FALSE。如果任何一个间隔为空，则抛出SQLException。

语法

bool operator==(

   const IntervalYM &first,

   const IntervalYM &second);

参数	描述
first	要比较的第一个间隔。
second	要比较的第二个间隔。

operator!=()¶

此方法比较指定的间隔。如果间隔不相等，则返回TRUE;否则，返回FALSE。如果任何一个间隔为空，则抛出SQLException。

语法

bool operator!=(

   const IntervalYM &first,

   const IntervalYM &second);

参数	描述
first	要比较的第一个间隔。
second	要比较的第二个间隔。

operator/()¶

返回间隔除以一个因子的结果。

语法

const IntervalYM operator/(

   const IntervalYM &dividend,

   const Number &factor);

参数	描述
dividend	要分割的区间。
factor	要除以区间的值。

operator/=()¶

计算间隔除以一个因子的结果。

语法

IntervalYM& operator/=(

   const Number &factor);

参数	描述
factor	要除以区间的值。

operator>()¶

此方法比较指定的间隔。如果第一个间隔大于第二个间隔，那么返回TRUE;否则，返回FALSE。如果任何一个间隔为空，则抛出SQLException。

语法

bool operator>(

   const IntervalYM &first,

   const IntervalYM &second);

参数	描述
first	要比较的第一个间隔。
second	要比较的第二个间隔。

operator>=()¶

此方法比较指定的间隔。如果第一个间隔大于或等于第二个间隔，那么返回TRUE;否则，返回FALSE。如果任何一个间隔为空，则抛出SQLException。

语法

bool operator>=(

   const IntervalYM &first,

   const IntervalYM &second);

参数	描述
first	要比较的第一个间隔。
second	要比较的第二个间隔。

operator<()¶

此方法比较指定的间隔。如果第一个间隔小于第二个间隔，则返回TRUE;否则，返回FALSE。如果任何一个间隔为空，则抛出SQLException。

语法

bool operator<(

    const IntervalYM &first,

    const IntervalYM &second);

参数	描述
first	要比较的第一个间隔。
second	要比较的第二个间隔。

operator<=()¶

此方法比较指定的间隔。如果第一个间隔小于或等于第二个间隔，则返回TRUE;否则，返回FALSE。如果任何一个间隔为空，则抛出SQLException。

语法

bool operator<=(

   const IntervalYM &first,

   const IntervalYM &second);

参数	描述
first	要比较的第一个间隔。
second	要比较的第二个间隔。

operator-()¶

此方法返回指定的间隔之间的差。

语法

const IntervalYM operator-(

   const IntervalYM &first,

   const IntervalYM &second);

参数	描述
first	要比较的第一个间隔。
second	要比较的第二个间隔。

operator-=()¶

此方法计算间隔与另一个间隔之间的差。

语法

IntervalYM& operator-=(

     const IntervalYM &val);

参数	描述
val	要减去的间隔

operator+()¶

返回指定的间隔的和。

语法

const IntervalYM operator-(

   const IntervalYM &first,

   const IntervalYM &second);

参数	描述
first	要比较的第一个间隔。
second	要比较的第二个间隔。

operator+=()¶

将IntervalYM和val的和赋值给IntervalYM。

语法

IntervalYM& operator+=(

   const IntervalYM &val);

参数	描述
val	要加的间隔

set()¶

将间隔设置为指定的值。

语法

void set(

   int year,

   int month);

参数	描述
year	年。有效值是-10^9到10^9。
month	月。有效值是-11到11。

setNull()¶

将间隔设置为NULL。

语法

void setNull();

toText()¶

返回间隔的字符串表示形式。

语法

string toText(

   unsigned int lfprec,

   const string &nlsParam = "") const;

参数	描述
lfprec	主字段的精度
nlsParam	不支持

toUText()¶

返回间隔的字符串表示形式。

语法

UString toUText(

      unsigned int lfprec ) const;

参数	描述
lfprec	主字段的精度