请求一个指向新分配的 numeric 变量的指针。

numeric *PGTYPESnumeric_new(void);

释放一个 numeric 变量及其占用的全部内存。

void PGTYPESnumeric_free(numeric *var);

从字符串表示中解析一个 numeric 值。

numeric *PGTYPESnumeric_from_asc(char *str, char **endptr);

例如，可用的格式是：-2、.794、+3.44、592.49E07 或者 -32.84e-4。如果值能被成功地解析，将返回一个有效的指针，否则返回 NULL 指针。目前 ECPG 总是解析整个字符串并且因此当前不支持把第一个非法字符的地址存储在*endptr 中。你可以安全地把 endptr 设置为 NULL。

返回由 malloc 分配的字符串的指针，它包含 numeric 类型 num 的字符串表示。

char *PGTYPESnumeric_to_asc(numeric *num, int dscale);

numeric 值将以 dscale 位小数输出，必要时进行舍入。结果必须用 PGTYPESchar_free() 释放。

把两个 numeric 变量相加放到第三个 numeric 变量中。

int PGTYPESnumeric_add(numeric *var1, numeric *var2, numeric *result);

该函数把变量 var1 和 var2 相加放到结果变量 result 中。成功时该函数返回 0，出错时返回 -1。

把两个 numeric 变量相减并且把结果返回到第三个 numeric 变量。

int PGTYPESnumeric_sub(numeric *var1, numeric *var2, numeric *result);

该函数把变量 var2 从变量 var1 中减除。该操作的结果被存储在变量 result 中。成功时该函数返回 0，出错时返回 -1。

把两个 numeric 变量相乘并且把结果返回到第三个 numeric 变量。

int PGTYPESnumeric_mul(numeric *var1, numeric *var2, numeric *result);

该函数把变量 var1 和 var2 相乘。该操作的结果被存储在变量 result 中。成功时该函数返回 0，出错时返回 -1。

把两个 numeric 变量相除并且把结果返回到第三个 numeric 变量。

int PGTYPESnumeric_div(numeric *var1, numeric *var2, numeric *result);

该函数用变量 var2 除变量 var1。该操作的结果被存储在变量 result 中。成功时该函数返回 0，出错时返回 -1。

比较两个 numeric 变量。

int PGTYPESnumeric_cmp(numeric *var1, numeric *var2)

这个函数比较两个 numeric 变量。错误时会返回 INT_MAX。成功时，该函数返回三种可能结果之一：

将一个 int 变量转换为 numeric 变量。

int PGTYPESnumeric_from_int(signed int int_val, numeric *var);

该函数接收一个 signed int 类型的变量，并将其值存入 numeric 变量 var 中。成功时返回 0，失败时返回 -1。

将一个 long int 变量转换为 numeric 变量。

int PGTYPESnumeric_from_long(signed long int long_val, numeric *var);

该函数接收一个 signed long int 类型的变量，并将其值存入 numeric 变量 var 中。成功时返回 0，失败时返回 -1。

把一个 numeric 变量复制到另一个中。

int PGTYPESnumeric_copy(numeric *src, numeric *dst);

这个函数把 src 指向的变量的值复制到 dst 指向的变量中。成功时该函数返回 0，出错时返回 -1。

将一个 double 类型的变量转换为 numeric 变量。

int  PGTYPESnumeric_from_double(double d, numeric *dst);

该函数接收一个 double 类型的变量，并将结果存入 dst 指向的变量中。成功时返回 0，出错时返回 -1。

将一个 numeric 类型的变量转换为 double。

int PGTYPESnumeric_to_double(numeric *nv, double *dp)

该函数将 nv 指向的变量中的 numeric 值转换为 double，并存入 dp 指向的变量中。成功时返回 0，发生错误（包括溢出）时返回 -1。发生溢出时，还会将全局变量 errno 设为 PGTYPES_NUM_OVERFLOW。

将一个 numeric 类型的变量转换为 int。

int PGTYPESnumeric_to_int(numeric *nv, int *ip);

该函数将 nv 指向的变量中的 numeric 值转换为 int，并存入 ip 指向的变量中。成功时返回 0，发生错误（包括溢出）时返回 -1。发生溢出时，还会将全局变量 errno 设为 PGTYPES_NUM_OVERFLOW。

将一个 numeric 类型的变量转换为 long。

int PGTYPESnumeric_to_long(numeric *nv, long *lp);

该函数将 nv 指向的变量中的 numeric 值转换为 long，并存入 lp 指向的变量中。成功时返回 0，发生错误（包括溢出和下溢）时返回 -1。发生溢出时，全局变量 errno 会被设为 PGTYPES_NUM_OVERFLOW；发生下溢时，errno 会被设为 PGTYPES_NUM_UNDERFLOW。

将一个 numeric 类型的变量转换为 decimal。

int PGTYPESnumeric_to_decimal(numeric *src, decimal *dst);

该函数将 src 指向的变量中的 numeric 值转换成 dst 指向的 decimal 变量。成功时该函数返回 0，出错时返回 -1，包括溢出。发生溢出时，全局变量 errno 会被设置为 PGTYPES_NUM_OVERFLOW。

将一个 decimal 类型的变量转换为 numeric。

int PGTYPESnumeric_from_decimal(decimal *src, numeric *dst);

该函数将 src 指向的变量中的 decimal 值转换成 dst 指向的 numeric 变量。成功时该函数返回 0，出错时返回 -1。由于 decimal 类型被实现为 numeric 类型的一个受限版本，这种转换不会发生溢出。

从一个时间戳中抽取日期部分。

date PGTYPESdate_from_timestamp(timestamp dt);

该函数接收一个时间戳作为它的唯一参数并且从这个时间戳返回抽取的日期部分。

从日期的文本表示解析一个日期。

date PGTYPESdate_from_asc(char *str, char **endptr);

该函数接收一个 C char* 字符串 str 以及一个指向 C char* 字符串的指针 endptr。目前 ECPG 始终解析整个字符串，因此尚不支持将第一个无效字符的地址存入*endptr 中。可以放心地将 endptr 设为 NULL。

注意，该函数始终假定日期采用 MDY 格式，目前 ECPG 中没有变量可以改变这一点。

表 34.2 展示了所有允许的输入格式。

返回一个日期变量的文本表示。

char *PGTYPESdate_to_asc(date dDate);

该函数接收日期 dDate 作为它的唯一参数。它将以形式 1999-01-18 输出该日期，即以 YYYY-MM-DD 格式输出。结果必须用 PGTYPESchar_free() 释放。

从一个 date 类型的变量中提取日、月和年的值。

void PGTYPESdate_julmdy(date d, int *mdy);

该函数接收日期 d 以及一个指向有 3 个整数值的数组 mdy 的指针。变量名就表明了顺序：mdy[0] 将被设置为包含月份，mdy[1] 将被设置为日的值，而 mdy[2] 将包含年。

根据一个包含 3 个整数的数组创建日期值，这些整数指定日期的日、月和年。

void PGTYPESdate_mdyjul(int *mdy, date *jdate);

该函数的第一个参数是包含 3 个整数的数组（mdy），第二个参数是一个指向 date 类型变量的指针，用来保存操作结果。

为一个日期值返回表示它是星期几的数字。

int PGTYPESdate_dayofweek(date d);

这个函数接收日期变量 d 作为它唯一的参数并且返回一个整数说明这个日期是星期几。

得到当前日期。

void PGTYPESdate_today(date *d);

该函数接收一个指向 date 变量的指针（d），并将其指向的变量设为当前日期。

使用格式掩码将一个 date 类型的变量转换为文本表示。

int PGTYPESdate_fmt_asc(date dDate, char *fmtstring, char *outbuf);

该函数接收要转换的日期（dDate）、格式掩码（fmtstring）以及将要保存日期的文本表示的字符串（outbuf）。

成功时，返回 0；如果发生错误，则返回一个负值。

下列字面量是可用的字段说明符：

所有其他字符会被原封不动地复制到输出字符串中。

表 34.3 给出了一些可用格式，有助于理解此函数的用法。所有输出行都基于同一个日期：1959 年 11 月 23 日。

使用格式掩码把一个 C char* 字符串转换成 date 类型的值。

int PGTYPESdate_defmt_asc(date *d, char *fmt, char *str);

该函数接收一个指向用于保存操作结果的 date 值的指针（d）、用于解析日期的格式掩码（fmt），以及包含日期文本表示的 C char* 字符串（str）。文本表示应与格式掩码匹配，但字符串与格式掩码无需一一对应。该函数只分析先后顺序，并查找表示年份位置的 yy 或 yyyy、表示月份位置的 mm 以及表示日位置的 dd。

表 34.4 给出了一些可用格式，有助于理解此函数的用法。

将时间戳的文本表示解析为 timestamp 变量。

timestamp PGTYPEStimestamp_from_asc(char *str, char **endptr);

该函数接收要解析的字符串（str）和一个指向 C char* 的指针（endptr）。目前 ECPG 始终解析整个字符串，因此尚不支持将第一个无效字符的地址存入*endptr 中。可以放心地将 endptr 设为 NULL。

该函数在成功时返回解析后的时间戳。出错时返回 PGTYPESInvalidTimestamp，并将 errno 设置为 PGTYPES_TS_BAD_TIMESTAMP。关于该值的重要说明，见 PGTYPESInvalidTimestamp。

通常，输入字符串可以包含允许的日期规范、空白字符和允许的时间规范的任意组合。请注意，ECPG 不支持时区。它可以解析时区，但不像 PostgreSQL 服务器那样进行任何换算。时区标识符会被静默丢弃。

表 34.5 包含了一些输入字符串的示例。

将时间戳转换为 C char* 字符串。

char *PGTYPEStimestamp_to_asc(timestamp tstamp);

该函数接收时间戳 tstamp 作为其唯一参数，并返回一个包含时间戳文本表示的已分配字符串。结果必须使用 PGTYPESchar_free() 释放。

检索当前时间戳。

void PGTYPEStimestamp_current(timestamp *ts);

该函数检索当前时间戳，并将其保存到 ts 指向的时间戳变量中。

使用格式掩码将时间戳变量转换为 C char*。

int PGTYPEStimestamp_fmt_asc(timestamp *ts, char *output, int str_len, char *fmtstr);

该函数接收一个指向要转换的时间戳的指针作为第一个参数（ts），一个指向输出缓冲区的指针（output），已为输出缓冲区分配的最大长度（str_len），以及用于转换的格式掩码（fmtstr）。

成功时返回 0，发生错误时返回负值。

格式掩码可以使用以下格式说明符。它们与 libc 中 strftime 函数使用的格式说明符相同。不是格式说明符的内容都会被复制到输出缓冲区中。

从一个时间戳减去另一个时间戳，并将结果保存在 interval 类型变量中。

int PGTYPEStimestamp_sub(timestamp *ts1, timestamp *ts2, interval *iv);

该函数从 ts1 指向的时间戳变量中减去 ts2 指向的时间戳变量，并将结果存入 iv 指向的 interval 变量中。

成功时返回 0，发生错误时返回负值。

使用格式掩码从文本表示中解析时间戳值。

int PGTYPEStimestamp_defmt_asc(char *str, char *fmt, timestamp *d);

该函数接收变量 str 中的时间戳文本表示，以及变量 fmt 中的格式掩码。结果存入 d 指向的变量中。

如果格式掩码 fmt 为 NULL，函数将退回到默认格式掩码，即 %Y-%m-%d %H:%M:%S。

这是 PGTYPEStimestamp_fmt_asc 的逆函数。可用的格式掩码项见该函数的说明。

向时间戳变量加上一个 interval 变量。

int PGTYPEStimestamp_add_interval(timestamp *tin, interval *span, timestamp *tout);

该函数接收一个指向 timestamp 变量 tin 的指针，以及一个指向 interval 变量 span 的指针。它将时间间隔加到时间戳上，并将得到的时间戳存入 tout 指向的变量中。

成功时返回 0，发生错误时返回负值。

从时间戳变量中减去一个 interval 变量。

int PGTYPEStimestamp_sub_interval(timestamp *tin, interval *span, timestamp *tout);

该函数从 tin 指向的时间戳变量中减去 span 指向的时间间隔变量，并将结果存入 tout 指向的变量中。

成功时返回 0，发生错误时返回负值。

返回一个指向新分配 interval 变量的指针。

interval *PGTYPESinterval_new(void);

释放先前分配的 interval 变量所占用的内存。

void PGTYPESinterval_free(interval *intvl);

从文本表示中解析一个 interval 值。

interval *PGTYPESinterval_from_asc(char *str, char **endptr);

该函数解析输入字符串 str，并返回一个已分配 interval 变量的指针。目前 ECPG 总是解析整个字符串，因此暂不支持把第一个非法字符的地址存储在*endptr 中。可以安全地把 endptr 设为 NULL。

将 interval 类型变量转换成文本表示。

char *PGTYPESinterval_to_asc(interval *span);

该函数把 span 指向的 interval 变量转换成 C char*。输出形式类似于：@ 1 day 12 hours 59 mins 10 secs。结果必须用 PGTYPESchar_free() 释放。

复制一个 interval 类型变量。

int PGTYPESinterval_copy(interval *intvlsrc, interval *intvldest);

该函数把 intvlsrc 指向的 interval 变量复制到 intvldest 指向的 interval 变量中。注意，需要事先为目标变量分配好内存。

请求一个指向新分配的 decimal 变量的指针。

decimal *PGTYPESdecimal_new(void);

释放一个 decimal 变量及其占用的全部内存。

void PGTYPESdecimal_free(decimal *var);

一个参数应该包含一个 numeric 变量（或者指向一个 numeric 变量），但是实际上它的内存表示非法。

发生一次溢出。由于 numeric 类型可以处理几乎任何精度，将一个 numeric 变量转换成其他类型可能导致溢出。

发生一次下溢。由于 numeric 类型可以处理几乎任何精度，将一个 numeric 变量转换成其他类型可能导致下溢。

尝试了一次除零。

一个非法的日期字符串被传给了 PGTYPESdate_from_asc 函数。

非法参数被传给了 PGTYPESdate_defmt_asc 函数。

PGTYPESdate_defmt_asc 函数在输入字符串中发现了一个非法词元。

向 PGTYPESinterval_from_asc 函数传入了无效的 interval 字符串，或者向 PGTYPESinterval_to_asc 函数传入了无效的 interval 值。

PGTYPESdate_defmt_asc 函数中的日、月、年赋值不匹配。

PGTYPESdate_defmt_asc 函数发现了月中的一个非法日值。

PGTYPESdate_defmt_asc 函数发现了一个非法的月值。

一个非法的时间戳字符串被传给了 PGTYPEStimestamp_from_asc 函数，或者一个非法的时间戳值被传给了 PGTYPEStimestamp_to_asc 函数。

在一个无法处理无限时间戳值的环境中遇到了这样一个值。

一个表示无效时间戳的 timestamp 类型值。PGTYPEStimestamp_from_asc 函数在解析出错时返回此值。注意，由于 timestamp 数据类型的内部表示，PGTYPESInvalidTimestamp 同时也是一个有效的时间戳，其值为 1899-12-31 23:59:59。为了检测错误，应用程序每次调用 PGTYPEStimestamp_from_asc 后，不仅要检查 PGTYPESInvalidTimestamp，还要检查 errno != 0。