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

numeric *PGTYPESnumeric_new(void);

释放一个数值类型，释放其所有内存。

void PGTYPESnumeric_free(numeric *var);

从字符串表示中解析一个数值类型。

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

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

返回一个由malloc分配的字符串指针，该字符串包含数值类型 num的字符串表示形式。

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

数值将以dscale个小数位打印，如果需要，将应用四舍五入。 结果必须使用PGTYPESchar_free()释放。

将两个数值变量相加并存储到第三个变量中。

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

该函数将变量var1和var2相加， 并存储到结果变量result中。 如果成功，函数返回0；如果出错，返回-1。

减去两个数值变量，并将结果返回到第三个变量中。

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

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

将两个数值变量相乘，并将结果返回到第三个变量中。

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

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

将两个数值变量相除，并将结果存储在第三个变量中。

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

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

比较两个数值变量。

int PGTYPESnumeric_cmp(numeric *var1, numeric *var2)

此函数用于比较两个数值变量。如果发生错误， INT_MAX将被返回。成功时，函数返回以下三种可能结果之一：

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

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

此函数接受一个类型为signed int的变量，并将其存储在numeric变量 var中。成功时返回0，失败时返回-1。

将一个长整型变量转换为一个数值变量。

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

此函数接受一个类型为 signed long int 的变量，并将其存储在数值变量 var中。成功时返回 0，失败时返回 -1。

将一个数值变量复制到另一个变量中。

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

此函数将src指向的变量的值复制到dst 指向的变量中。如果成功返回0，如果发生错误则返回-1。

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

int  PGTYPESnumeric_from_double(double d, numeric *dst);

此函数接受一个double类型的变量，并将结果存储在 dst指向的变量中。成功时返回0，发生错误时返回-1。

将一个数值类型的变量转换为双精度类型。

int PGTYPESnumeric_to_double(numeric *nv, double *dp)

该函数将nv指向的变量中的数值转换为dp指向的双精度变量。 如果成功，返回0；如果发生错误（包括溢出），返回-1。在溢出情况下，全局变量 errno还会被设置为PGTYPES_NUM_OVERFLOW。

将一个数值类型的变量转换为整数。

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

该函数将nv指向的变量中的数值转换为ip 指向的整数变量。如果成功，返回0；如果发生错误（包括溢出），返回-1。 在溢出情况下，全局变量errno还会被设置为 PGTYPES_NUM_OVERFLOW。

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

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

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

将一个数值类型的变量转换为十进制。

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

该函数将src指向的变量中的数值转换为 dst指向的十进制变量。如果成功返回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 的字符串str以及一个指向 C 字符串的指针endptr。当前 ECPG 总是解析完整的字符串并且因此当前不支持将第一个非法字符的地址存储在*endptr中。你可以安全地把endptr设置为 NULL。

注意该函数总是假定格式按照 MDY 格式化并且当前在 ECPG 中没有变体可以改变这种格式。

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

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

char *PGTYPESdate_to_asc(date dDate);

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

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

void PGTYPESdate_julmdy(date d, int *mdy);

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

从一个由 3 个整数构成的数组创建一个日期值，3 个整数分别指定日、月和年。

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

这个函数接收 3 个整数（mdy）组成的数组作为其第一个参数，其第二个参数是一个指向日期类型变量的指针，它被用来保存操作的结果。

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

int PGTYPESdate_dayofweek(date d);

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

得到当前日期。

void PGTYPESdate_today(date *d);

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

使用一个格式掩码将一个日期类型的变量转换成它的文本表达。

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

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

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

下面是你可以使用的域指示符：

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

Table 34.3指出了一些可能的格式。这将给你一些线索如何使用这个函数。所有输出都是基于同一个日期：1959年11月23日。

使用一个格式掩码把一个 C 的 char*子返回串转换成一个日期类型的值。

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

该函数接收一个用来保存操作结果的指向日期值的指针（d）、用于解析日期的格式掩码（fmt）以及包含日期文本表达的 C char* 串（str）。该函数期望文本表达匹配格式掩码。不过你不需要字符串和格式掩码的一一映射。该函数只分析相继顺序并且查找表示年份位置的文字yy或者yyyy、表示月份位置的mm以及表示日位置的dd。

Table 34.4给出了一些可能的格式。这将给你一些线索如何使用这个函数。

从其文本表示中解析时间戳为时间戳变量。

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服务器那样应用任何计算。时区标识符会被静默丢弃。

Table 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函数中使用的相同。任何非格式说明符都将被复制到输出缓冲区中。

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

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

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

当成功时，该函数返回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相反的函数。请参阅那里的文档，以了解可能的格式掩码条目。

向时间戳变量添加一个间隔变量。

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

该函数接收一个指向时间戳变量tin的指针和一个指向间隔变量span的指针。 它将间隔添加到时间戳中，并将结果时间戳保存在tout指向的变量中。

当成功时，该函数返回0，如果发生错误则返回负值。

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

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

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

当成功时，该函数返回0，如果发生错误则返回负值。

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

interval *PGTYPESinterval_new(void);

释放先前分配的区间变量的内存。

void PGTYPESinterval_free(interval *intvl);

从文本表达解析一个区间。

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

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

将一个区间类型的变量转换成它的文本表达。

char *PGTYPESinterval_to_asc(interval *span);

该函数将span指向的区间变量转换成一个 C char*。输出看起来像这个例子： @ 1 day 12 hours 59 mins 10 secs。结果必须用PGTYPESchar_free()释放。

复制一个区间类型的变量。

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

该函数将intvlsrc指向的区间变量复制到intvldest指向的区间变量。注意你需要现为目标变量分配好内存。

请求一个指向新分配的十进制变量的指针。

decimal *PGTYPESdecimal_new(void);

释放一个十进制类型，释放其所有内存。

void PGTYPESdecimal_free(decimal *var);

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

发生了溢出。由于数值类型可以处理几乎任意的精度，将数值变量转换为其他 类型可能会导致溢出。

发生了下溢。由于数值类型可以处理几乎任意的精度，将数值变量转换为其他 类型可能会导致下溢。

已尝试进行除以零的操作。

一个无效的日期字符串被传递给 PGTYPESdate_from_asc 函数。

向PGTYPESdate_defmt_asc函数传递了无效的参数。

在输入字符串中发现了一个无效的标记， 由PGTYPESdate_defmt_asc函数检测到。

一个无效的时间间隔字符串被传递给 PGTYPESinterval_from_asc 函数，或者一个 无效的时间间隔值被传递给 PGTYPESinterval_to_asc 函数。

在PGTYPESdate_defmt_asc函数中，日/月/年的分配存在不匹配。

在PGTYPESdate_defmt_asc函数中发现了一个无效的月份日期值。

在PGTYPESdate_defmt_asc函数中发现了一个无效的月份值。

一个无效的时间戳字符串被传递给 PGTYPEStimestamp_from_asc函数， 或者一个无效的时间戳值被传递给 PGTYPEStimestamp_to_asc函数。

在无法处理的上下文中遇到了一个无限的时间戳值。

表示一个非法时间戳的时间戳类型值。在解析错误时，函数PGTYPEStimestamp_from_asc会返回这个值。注意由于timestamp数据类型的内部表达，PGTYPESInvalidTimestamp在同时也是一个合法的时间戳。它被设置为1899-12-31 23:59:59。为了检测到错误，确认你的应用在每次调用PGTYPEStimestamp_from_asc后不仅仅测试PGTYPESInvalidTimestamp，还应该测试errno != 0。