diff --git a/doc/src/sgml/ecpg.sgml b/doc/src/sgml/ecpg.sgml index e7a53f3..48684cf 100644 --- a/doc/src/sgml/ecpg.sgml +++ b/doc/src/sgml/ecpg.sgml @@ -2942,8 +2942,14 @@ timestamp PGTYPEStimestamp_from_asc(char *str, char **endptr); The function returns the parsed timestamp on success. On error, - PGTYPESInvalidTimestamp is returned and errno is - set to PGTYPES_TS_BAD_TIMESTAMP. See for important notes on this value. + 0 is returned and errno is set to + PGTYPES_TS_BAD_TIMESTAMP. + Note that due to the internal representation of the timestamp data type, + 0 is also a valid timestamp at the same time. + It is set to 1900-01-01 00:00:00. In order + to detect errors, make sure that your application does not only test + for return value but also for errno != 0 after each call to + PGTYPEStimestamp_from_asc. In general, the input string can contain any combination of an allowed @@ -3717,31 +3723,6 @@ void PGTYPESdecimal_free(decimal *var); - - - Special Constants of pgtypeslib - - - - PGTYPESInvalidTimestamp - - - A value of type timestamp representing an invalid time stamp. This is - returned by the function PGTYPEStimestamp_from_asc on - parse error. - Note that due to the internal representation of the timestamp data type, - PGTYPESInvalidTimestamp is also a valid timestamp at - the same time. It is set to 1899-12-31 23:59:59. In order - to detect errors, make sure that your application does not only test - for PGTYPESInvalidTimestamp but also for - errno != 0 after each call to - PGTYPEStimestamp_from_asc. - - - - - -