请求一个指向新分配的 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 变量相加，结果存入第三个变量。

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

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

把两个 numeric 变量相减，结果存入第三个变量。

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

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

把两个 numeric 变量相乘，结果存入第三个变量。

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

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

把两个 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 值转换为 dp 所指向的 double 变量。成功时返回 0，发生错误（包括溢出）时 返回 -1。发生溢出时，全局变量 errno 还会被设置为 PGTYPES_NUM_OVERFLOW。

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

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

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

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

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

该函数把 nv 所指向变量中的 numeric 值转换为 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 中没有可以改变这一行为的变量。

Table 34.2 展示了允许的输入格式。

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

char *PGTYPESdate_to_asc(date dDate);

该函数以 date 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 个整数的数组 创建一个 date 值。

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

该函数以 3 个整数组成的数组（mdy） 作为第一个参数，并以一个指向 date 类型变量的指针 作为第二个参数，该变量将保存这一操作的结果。

返回一个表示 date 值是星期几的数字。

int PGTYPESdate_dayofweek(date d);

该函数以 date 变量 d 作为其唯一参数， 并返回一个指出该日期是星期几的整数。

获取当前日期。

void PGTYPESdate_today(date *d);

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

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

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

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

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

以下字面值是你可用的字段说明符：

All other characters are copied 1:1 to the output string.

Table 34.3 给出了几种可能的格式。 这能让你了解如何使用这个函数。 所有输出行都基于同一个日期：1959 年 11 月 23 日。

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

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

该函数接收一个指针，指向应保存操作结果的 date 值 （d）、用于解析日期字符串的格式掩码 （fmt）以及要解析的日期字符串 （str）。

Table 34.4 给出了几种可能的格式。 这能让你了解如何使用这个函数。

把一个时间戳从其文本表示解析到一个时间戳变量中。

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

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

总的来说，输入字符串可以包含一个允许的日期规定、 一个空白字符和一个允许的时间规定的任意组合。 注意，ECPG 不支持时区。它可以解析时区， 但不会像 PostgreSQL 服务器那样 做任何计算。时区说明符会被静默丢弃。

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

把一个日期转换为 C char* 字符串。

char *PGTYPEStimestamp_to_asc(timestamp tstamp);

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

检索当前的时间戳。

void PGTYPEStimestamp_current(timestamp *ts);

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

使用格式掩码把一个 timestamp 变量转换为 C char* 字符串。

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

该函数的第一个参数（ts）是指向要转换的 timestamp 的指针，此外还接收指向输出缓冲区的指针 （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）以及一个指向 timestamp 类型变量的指针（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 的指针， 以及一个指向 timestamp 类型变量 tout 的指针， 它将把 interval 加到时间戳上并把结果保存到 tout 所指向的变量中。

成功时该函数返回 0，发生错误时返回一个负值。

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

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

该函数从 tin 所指向的时间戳变量中 减去 span 所指向的 interval 变量， 并把结果保存到 tout 所指向的变量中。

成功时该函数返回 0，发生错误时返回一个负值。

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

释放之前分配的 interval 变量的内存。

void PGTYPESinterval_free(interval *intvl);

从文本表示解析一个 interval。

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

该函数解析输入字符串 str 并返回一个指向 已分配的 interval 变量的指针。出错时会返回 NULL， 并把 errno 设置为 PGTYPES_INTVL_BAD_INTERVAL。

把一个 interval 类型的变量转换为它的文本表示。

char *PGTYPESinterval_to_asc(interval *span);

该函数把 span 所指向的 interval 变量 转换为 C char* 字符串，例如 @ 1 day 12 hours @。 结果必须用 PGTYPESchar_free() 释放。

复制一个 interval 类型的变量。

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

该函数把 intvlsrc 所指向的 interval 变量 复制到 intvldest 所指向的变量中。 如果出错则返回一个非零值。

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

decimal *PGTYPESdecimal_new(void);

释放一个 decimal 类型，归还它的全部内存。

void PGTYPESdecimal_free(decimal *var);

一个参数应当包含一个 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。 为了检测错误，请确保你的应用不仅测试 PGTYPESInvalidTimestamp， 还在每次调用 PGTYPEStimestamp_from_asc 之后测试 errno != 0。