mirror of
https://github.com/postgres/postgres.git
synced 2026-02-28 04:10:35 -05:00
0059bbe1ec
Previous commits invented timestamp2timestamptz_opt_overflow, date2timestamp_opt_overflow, and date2timestamptz_opt_overflow functions to perform non-error-throwing conversions between datetime types. This patch completes the set by adding timestamp2date_opt_overflow, timestamptz2date_opt_overflow, and timestamptz2timestamp_opt_overflow. In addition, adjust timestamp2timestamptz_opt_overflow so that it doesn't throw error if timestamp2tm fails, but treats that as an overflow case. The situation probably can't arise except with an invalid timestamp value, and I can't think of a way that that would happen except data corruption. However, it's pretty silly to have a function whose entire reason for existence is to not throw errors for out-of-range inputs nonetheless throw an error for out-of-range input. The new APIs are not used in this patch, but will be needed in upcoming btree_gin changes. Author: Tom Lane <tgl@sss.pgh.pa.us> Reviewed-by: Arseniy Mukhin <arseniy.mukhin.dev@gmail.com> Discussion: https://postgr.es/m/262624.1738460652@sss.pgh.pa.us
120 lines
3.5 KiB
C
120 lines
3.5 KiB
C
/*-------------------------------------------------------------------------
|
|
*
|
|
* date.h
|
|
* Definitions for the SQL "date" and "time" types.
|
|
*
|
|
*
|
|
* Portions Copyright (c) 1996-2025, PostgreSQL Global Development Group
|
|
* Portions Copyright (c) 1994, Regents of the University of California
|
|
*
|
|
* src/include/utils/date.h
|
|
*
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
#ifndef DATE_H
|
|
#define DATE_H
|
|
|
|
#include <math.h>
|
|
|
|
#include "datatype/timestamp.h"
|
|
#include "fmgr.h"
|
|
#include "pgtime.h"
|
|
|
|
typedef int32 DateADT;
|
|
|
|
typedef int64 TimeADT;
|
|
|
|
typedef struct
|
|
{
|
|
TimeADT time; /* all time units other than months and years */
|
|
int32 zone; /* numeric time zone, in seconds */
|
|
} TimeTzADT;
|
|
|
|
/*
|
|
* Infinity and minus infinity must be the max and min values of DateADT.
|
|
*/
|
|
#define DATEVAL_NOBEGIN ((DateADT) PG_INT32_MIN)
|
|
#define DATEVAL_NOEND ((DateADT) PG_INT32_MAX)
|
|
|
|
#define DATE_NOBEGIN(j) ((j) = DATEVAL_NOBEGIN)
|
|
#define DATE_IS_NOBEGIN(j) ((j) == DATEVAL_NOBEGIN)
|
|
#define DATE_NOEND(j) ((j) = DATEVAL_NOEND)
|
|
#define DATE_IS_NOEND(j) ((j) == DATEVAL_NOEND)
|
|
#define DATE_NOT_FINITE(j) (DATE_IS_NOBEGIN(j) || DATE_IS_NOEND(j))
|
|
|
|
#define MAX_TIME_PRECISION 6
|
|
|
|
/*
|
|
* Functions for fmgr-callable functions.
|
|
*
|
|
* For TimeADT, we make use of the same support routines as for int64.
|
|
* Therefore TimeADT is pass-by-reference if and only if int64 is!
|
|
*/
|
|
static inline DateADT
|
|
DatumGetDateADT(Datum X)
|
|
{
|
|
return (DateADT) DatumGetInt32(X);
|
|
}
|
|
|
|
static inline TimeADT
|
|
DatumGetTimeADT(Datum X)
|
|
{
|
|
return (TimeADT) DatumGetInt64(X);
|
|
}
|
|
|
|
static inline TimeTzADT *
|
|
DatumGetTimeTzADTP(Datum X)
|
|
{
|
|
return (TimeTzADT *) DatumGetPointer(X);
|
|
}
|
|
|
|
static inline Datum
|
|
DateADTGetDatum(DateADT X)
|
|
{
|
|
return Int32GetDatum(X);
|
|
}
|
|
|
|
static inline Datum
|
|
TimeADTGetDatum(TimeADT X)
|
|
{
|
|
return Int64GetDatum(X);
|
|
}
|
|
|
|
static inline Datum
|
|
TimeTzADTPGetDatum(const TimeTzADT *X)
|
|
{
|
|
return PointerGetDatum(X);
|
|
}
|
|
|
|
#define PG_GETARG_DATEADT(n) DatumGetDateADT(PG_GETARG_DATUM(n))
|
|
#define PG_GETARG_TIMEADT(n) DatumGetTimeADT(PG_GETARG_DATUM(n))
|
|
#define PG_GETARG_TIMETZADT_P(n) DatumGetTimeTzADTP(PG_GETARG_DATUM(n))
|
|
|
|
#define PG_RETURN_DATEADT(x) return DateADTGetDatum(x)
|
|
#define PG_RETURN_TIMEADT(x) return TimeADTGetDatum(x)
|
|
#define PG_RETURN_TIMETZADT_P(x) return TimeTzADTPGetDatum(x)
|
|
|
|
|
|
/* date.c */
|
|
extern int32 anytime_typmod_check(bool istz, int32 typmod);
|
|
extern double date2timestamp_no_overflow(DateADT dateVal);
|
|
extern Timestamp date2timestamp_opt_overflow(DateADT dateVal, int *overflow);
|
|
extern TimestampTz date2timestamptz_opt_overflow(DateADT dateVal, int *overflow);
|
|
extern DateADT timestamp2date_opt_overflow(Timestamp timestamp, int *overflow);
|
|
extern DateADT timestamptz2date_opt_overflow(TimestampTz timestamp, int *overflow);
|
|
extern int32 date_cmp_timestamp_internal(DateADT dateVal, Timestamp dt2);
|
|
extern int32 date_cmp_timestamptz_internal(DateADT dateVal, TimestampTz dt2);
|
|
|
|
extern void EncodeSpecialDate(DateADT dt, char *str);
|
|
extern DateADT GetSQLCurrentDate(void);
|
|
extern TimeTzADT *GetSQLCurrentTime(int32 typmod);
|
|
extern TimeADT GetSQLLocalTime(int32 typmod);
|
|
extern int time2tm(TimeADT time, struct pg_tm *tm, fsec_t *fsec);
|
|
extern int timetz2tm(TimeTzADT *time, struct pg_tm *tm, fsec_t *fsec, int *tzp);
|
|
extern int tm2time(struct pg_tm *tm, fsec_t fsec, TimeADT *result);
|
|
extern int tm2timetz(struct pg_tm *tm, fsec_t fsec, int tz, TimeTzADT *result);
|
|
extern bool time_overflows(int hour, int min, int sec, fsec_t fsec);
|
|
extern bool float_time_overflows(int hour, int min, double sec);
|
|
extern void AdjustTimeForTypmod(TimeADT *time, int32 typmod);
|
|
|
|
#endif /* DATE_H */
|