#include "datatype/timestamp.h"
#include "fmgr.h"
#include "pgtime.h"

Include dependency graph for timestamp.h:

This graph shows which files directly or indirectly include this file:

Macros
#define	DatumGetTimestamp(X) ((Timestamp) DatumGetInt64(X))

#define	DatumGetTimestampTz(X) ((TimestampTz) DatumGetInt64(X))

#define	DatumGetIntervalP(X) ((Interval *) DatumGetPointer(X))

#define	TimestampGetDatum(X) Int64GetDatum(X)

#define	TimestampTzGetDatum(X) Int64GetDatum(X)

#define	IntervalPGetDatum(X) PointerGetDatum(X)

#define	PG_GETARG_TIMESTAMP(n) DatumGetTimestamp(PG_GETARG_DATUM(n))

#define	PG_GETARG_TIMESTAMPTZ(n) DatumGetTimestampTz(PG_GETARG_DATUM(n))

#define	PG_GETARG_INTERVAL_P(n) DatumGetIntervalP(PG_GETARG_DATUM(n))

#define	PG_RETURN_TIMESTAMP(x) return TimestampGetDatum(x)

#define	PG_RETURN_TIMESTAMPTZ(x) return TimestampTzGetDatum(x)

#define	PG_RETURN_INTERVAL_P(x) return IntervalPGetDatum(x)

#define	TIMESTAMP_MASK(b) (1 << (b))

#define	INTERVAL_MASK(b) (1 << (b))

#define	INTERVAL_FULL_RANGE (0x7FFF)

#define	INTERVAL_RANGE_MASK (0x7FFF)

#define	INTERVAL_FULL_PRECISION (0xFFFF)

#define	INTERVAL_PRECISION_MASK (0xFFFF)

#define	INTERVAL_TYPMOD(p, r) ((((r) & INTERVAL_RANGE_MASK) << 16) \| ((p) & INTERVAL_PRECISION_MASK))

#define	INTERVAL_PRECISION(t) ((t) & INTERVAL_PRECISION_MASK)

#define	INTERVAL_RANGE(t) (((t) >> 16) & INTERVAL_RANGE_MASK)

#define	TimestampTzPlusMilliseconds(tz, ms) ((tz) + ((ms) * (int64) 1000))

#define	timestamptz_cmp_internal(dt1, dt2) timestamp_cmp_internal(dt1, dt2)

Functions
int32	anytimestamp_typmod_check (bool istz, int32 typmod)

TimestampTz	GetCurrentTimestamp (void)

TimestampTz	GetSQLCurrentTimestamp (int32 typmod)

Timestamp	GetSQLLocalTimestamp (int32 typmod)

void	TimestampDifference (TimestampTz start_time, TimestampTz stop_time, long secs, int microsecs)

long	TimestampDifferenceMilliseconds (TimestampTz start_time, TimestampTz stop_time)

bool	TimestampDifferenceExceeds (TimestampTz start_time, TimestampTz stop_time, int msec)

TimestampTz	time_t_to_timestamptz (pg_time_t tm)

pg_time_t	timestamptz_to_time_t (TimestampTz t)

const char *	timestamptz_to_str (TimestampTz t)

int	tm2timestamp (struct pg_tm tm, fsec_t fsec, int tzp, Timestamp *dt)

int	timestamp2tm (Timestamp dt, int tzp, struct pg_tm tm, fsec_t fsec, const char tzn, pg_tz attimezone)

void	dt2time (Timestamp dt, int hour, int min, int sec, fsec_t fsec)

int	interval2tm (Interval span, struct pg_tm tm, fsec_t fsec)

int	tm2interval (struct pg_tm tm, fsec_t fsec, Interval span)

Timestamp	SetEpochTimestamp (void)

void	GetEpochTime (struct pg_tm *tm)

int	timestamp_cmp_internal (Timestamp dt1, Timestamp dt2)

TimestampTz	timestamp2timestamptz_opt_overflow (Timestamp timestamp, int *overflow)

int32	timestamp_cmp_timestamptz_internal (Timestamp timestampVal, TimestampTz dt2)

int	isoweek2j (int year, int week)

void	isoweek2date (int woy, int year, int mon, int *mday)

void	isoweekdate2date (int isoweek, int wday, int year, int mon, int *mday)

int	date2isoweek (int year, int mon, int mday)

int	date2isoyear (int year, int mon, int mday)

int	date2isoyearday (int year, int mon, int mday)

bool	TimestampTimestampTzRequiresRewrite (void)

Variables
TimestampTz	PgStartTime

TimestampTz	PgReloadTime

Macro Definition Documentation

◆ DatumGetIntervalP

#define DatumGetIntervalP ( X ) ((Interval *) DatumGetPointer(X))

Definition at line 29 of file timestamp.h.

Referenced by abs_interval(), check_timezone(), convert_timevalue_to_scalar(), gbt_intv_compress(), gbt_time_dist(), gbt_time_penalty(), gbt_ts_dist(), in_range_interval_interval(), interval_accum(), interval_accum_inv(), interval_avg(), interval_combine(), interval_dist(), time_dist(), timestamp_mi(), ts_dist(), and tstz_dist().

◆ DatumGetTimestamp

#define DatumGetTimestamp ( X ) ((Timestamp) DatumGetInt64(X))

Definition at line 27 of file timestamp.h.

Referenced by compareDatetime(), convert_timevalue_to_scalar(), gbt_num_compress(), generate_series_timestamp(), in_range_timestamp_interval(), JsonEncodeDateTime(), map_sql_value_to_xml_value(), and timestamp_fastcmp().

◆ DatumGetTimestampTz

#define DatumGetTimestampTz ( X ) ((TimestampTz) DatumGetInt64(X))

Definition at line 28 of file timestamp.h.

Referenced by compareDatetime(), convert_timevalue_to_scalar(), gbt_tstz_compress(), generate_series_timestamptz(), get_role_password(), in_range_timestamptz_interval(), JsonEncodeDateTime(), and validateRecoveryParameters().

◆ INTERVAL_FULL_PRECISION

#define INTERVAL_FULL_PRECISION (0xFFFF)

Definition at line 50 of file timestamp.h.

Referenced by AdjustIntervalForTypmod(), interval_support(), intervaltypmodin(), and intervaltypmodout().

◆ INTERVAL_FULL_RANGE

#define INTERVAL_FULL_RANGE (0x7FFF)

Definition at line 48 of file timestamp.h.

Referenced by AdjustIntervalForTypmod(), DecodeDateTime(), DecodeInterval(), DecodeTimeOnly(), interval_in(), intervaltypmodin(), intervaltypmodleastfield(), and intervaltypmodout().

◆ INTERVAL_MASK

#define INTERVAL_MASK ( b ) (1 << (b))

Definition at line 45 of file timestamp.h.

Referenced by AdjustIntervalForTypmod(), DecodeInterval(), DecodeTime(), intervaltypmodin(), intervaltypmodleastfield(), and intervaltypmodout().

◆ INTERVAL_PRECISION

#define INTERVAL_PRECISION ( t ) ((t) & INTERVAL_PRECISION_MASK)

Definition at line 53 of file timestamp.h.

Referenced by AdjustIntervalForTypmod(), interval_support(), and intervaltypmodout().

◆ INTERVAL_PRECISION_MASK

#define INTERVAL_PRECISION_MASK (0xFFFF)

Definition at line 51 of file timestamp.h.

◆ INTERVAL_RANGE

#define INTERVAL_RANGE ( t ) (((t) >> 16) & INTERVAL_RANGE_MASK)

Definition at line 54 of file timestamp.h.

Referenced by AdjustIntervalForTypmod(), interval_in(), intervaltypmodleastfield(), and intervaltypmodout().

◆ INTERVAL_RANGE_MASK

#define INTERVAL_RANGE_MASK (0x7FFF)

Definition at line 49 of file timestamp.h.

◆ INTERVAL_TYPMOD

#define INTERVAL_TYPMOD	(	p,
		r
	)	((((r) & INTERVAL_RANGE_MASK) << 16) \| ((p) & INTERVAL_PRECISION_MASK))

Definition at line 52 of file timestamp.h.

Referenced by intervaltypmodin().

◆ IntervalPGetDatum

#define IntervalPGetDatum ( X ) PointerGetDatum(X)

◆ PG_GETARG_INTERVAL_P

#define PG_GETARG_INTERVAL_P ( n ) DatumGetIntervalP(PG_GETARG_DATUM(n))

Definition at line 37 of file timestamp.h.

Referenced by brin_minmax_multi_distance_interval(), date_mi_interval(), date_pl_interval(), gbt_intv_consistent(), gbt_intv_distance(), generate_series_timestamp(), generate_series_timestamptz(), in_range_date_interval(), in_range_interval_interval(), in_range_time_interval(), in_range_timestamp_interval(), in_range_timestamptz_interval(), in_range_timetz_interval(), interval_accum(), interval_accum_inv(), interval_cmp(), interval_div(), interval_eq(), interval_ge(), interval_gt(), interval_hash(), interval_hash_extended(), interval_justify_days(), interval_justify_hours(), interval_justify_interval(), interval_larger(), interval_le(), interval_lt(), interval_mi(), interval_mul(), interval_ne(), interval_out(), interval_part_common(), interval_pl(), interval_scale(), interval_send(), interval_smaller(), interval_time(), interval_to_char(), interval_trunc(), interval_um(), time_mi_interval(), time_pl_interval(), timestamp_bin(), timestamp_izone(), timestamp_mi_interval(), timestamp_pl_interval(), timestamptz_bin(), timestamptz_izone(), timestamptz_mi_interval(), timestamptz_pl_interval(), timetz_izone(), timetz_mi_interval(), and timetz_pl_interval().

◆ PG_GETARG_TIMESTAMP

#define PG_GETARG_TIMESTAMP ( n ) DatumGetTimestamp(PG_GETARG_DATUM(n))

Definition at line 35 of file timestamp.h.

◆ PG_GETARG_TIMESTAMPTZ

#define PG_GETARG_TIMESTAMPTZ ( n ) DatumGetTimestampTz(PG_GETARG_DATUM(n))

Definition at line 36 of file timestamp.h.

Referenced by date_cmp_timestamptz(), date_eq_timestamptz(), date_ge_timestamptz(), date_gt_timestamptz(), date_le_timestamptz(), date_lt_timestamptz(), date_ne_timestamptz(), gbt_tstz_consistent(), gbt_tstz_distance(), generate_series_timestamptz(), in_range_timestamptz_interval(), pg_replication_origin_xact_setup(), timestamp_cmp_timestamptz(), timestamp_eq_timestamptz(), timestamp_ge_timestamptz(), timestamp_gt_timestamptz(), timestamp_le_timestamptz(), timestamp_lt_timestamptz(), timestamp_ne_timestamptz(), timestamptz_age(), timestamptz_bin(), timestamptz_cmp_date(), timestamptz_cmp_timestamp(), timestamptz_eq_date(), timestamptz_eq_timestamp(), timestamptz_ge_date(), timestamptz_ge_timestamp(), timestamptz_gt_date(), timestamptz_gt_timestamp(), timestamptz_izone(), timestamptz_le_date(), timestamptz_le_timestamp(), timestamptz_lt_date(), timestamptz_lt_timestamp(), timestamptz_mi_interval(), timestamptz_ne_date(), timestamptz_ne_timestamp(), timestamptz_out(), timestamptz_part_common(), timestamptz_pl_interval(), timestamptz_scale(), timestamptz_send(), timestamptz_timestamp(), timestamptz_trunc(), timestamptz_trunc_zone(), timestamptz_zone(), and tstz_dist().

◆ PG_RETURN_INTERVAL_P

#define PG_RETURN_INTERVAL_P ( x ) return IntervalPGetDatum(x)

◆ PG_RETURN_TIMESTAMP

#define PG_RETURN_TIMESTAMP ( x ) return TimestampGetDatum(x)

◆ PG_RETURN_TIMESTAMPTZ

#define PG_RETURN_TIMESTAMPTZ ( x ) return TimestampTzGetDatum(x)

Definition at line 40 of file timestamp.h.

Referenced by clock_timestamp(), make_timestamptz(), make_timestamptz_at_timezone(), now(), pg_conf_load_time(), pg_last_xact_replay_timestamp(), pg_postmaster_start_time(), pg_stat_get_backend_activity_start(), pg_stat_get_backend_start(), pg_stat_get_backend_xact_start(), pg_stat_get_bgwriter_stat_reset_time(), pg_stat_get_db_checksum_last_failure(), pg_stat_get_db_stat_reset_time(), pg_stat_get_last_analyze_time(), pg_stat_get_last_autoanalyze_time(), pg_stat_get_last_autovacuum_time(), pg_stat_get_last_vacuum_time(), pg_stat_get_snapshot_timestamp(), pg_xact_commit_timestamp(), statement_timestamp(), timestamp_izone(), timestamp_timestamptz(), timestamp_zone(), timestamptz_bin(), timestamptz_in(), timestamptz_recv(), timestamptz_scale(), timestamptz_trunc(), and timestamptz_trunc_zone().

◆ TIMESTAMP_MASK

#define TIMESTAMP_MASK ( b ) (1 << (b))

Definition at line 44 of file timestamp.h.

◆ TimestampGetDatum

#define TimestampGetDatum ( X ) Int64GetDatum(X)

Definition at line 31 of file timestamp.h.

Referenced by date_mi_interval(), date_pl_interval(), ExecEvalSQLValueFunction(), gbt_num_fetch(), generate_series_timestamp(), in_range_date_interval(), in_range_timestamp_interval(), leftmostvalue_timestamp(), parse_datetime(), timestamp_mi_interval(), and timestamptz_mi_interval().

◆ timestamptz_cmp_internal

#define timestamptz_cmp_internal	(	dt1,
		dt2
	)	timestamp_cmp_internal(dt1, dt2)

Definition at line 100 of file timestamp.h.

Referenced by date_cmp_timestamptz_internal(), and timestamp_cmp_timestamptz_internal().

◆ TimestampTzGetDatum

◆ TimestampTzPlusMilliseconds

#define TimestampTzPlusMilliseconds	(	tz,
		ms
	)	((tz) + ((ms) * (int64) 1000))

Function Documentation

◆ anytimestamp_typmod_check()

int32 anytimestamp_typmod_check	(	bool	istz,
		int32	typmod
	)

Definition at line 104 of file timestamp.c.

References ereport, errcode(), errmsg(), ERROR, MAX_TIMESTAMP_PRECISION, and WARNING.

Referenced by anytimestamp_typmodin(), and transformSQLValueFunction().

 {
     if (typmod < 0)
         ereport(ERROR,
                 (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
                  errmsg("TIMESTAMP(%d)%s precision must not be negative",
                         typmod, (istz ? " WITH TIME ZONE" : ""))));
     if (typmod > MAX_TIMESTAMP_PRECISION)
     {
         ereport(WARNING,
                 (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
                  errmsg("TIMESTAMP(%d)%s precision reduced to maximum allowed, %d",
                         typmod, (istz ? " WITH TIME ZONE" : ""),
                         MAX_TIMESTAMP_PRECISION)));
         typmod = MAX_TIMESTAMP_PRECISION;
     }
 
     return typmod;
 }

◆ date2isoweek()

int date2isoweek	(	int	year,
		int	mon,
		int	mday
	)

Definition at line 4432 of file timestamp.c.

References date2j(), and j2day().

Referenced by DCH_to_char(), extract_date(), timestamp_part_common(), timestamp_trunc(), timestamptz_part_common(), and timestamptz_trunc_internal().

 {
     float8      result;
     int         day0,
                 day4,
                 dayn;
 
     /* current day */
     dayn = date2j(year, mon, mday);
 
     /* fourth day of current year */
     day4 = date2j(year, 1, 4);
 
     /* day0 == offset to first day of week (Monday) */
     day0 = j2day(day4 - 1);
 
     /*
      * We need the first week containing a Thursday, otherwise this day falls
      * into the previous year for purposes of counting weeks
      */
     if (dayn < day4 - day0)
     {
         day4 = date2j(year - 1, 1, 4);
 
         /* day0 == offset to first day of week (Monday) */
         day0 = j2day(day4 - 1);
     }
 
     result = (dayn - (day4 - day0)) / 7 + 1;
 
     /*
      * Sometimes the last few days in a year will fall into the first week of
      * the next year, so check for this.
      */
     if (result >= 52)
     {
         day4 = date2j(year + 1, 1, 4);
 
         /* day0 == offset to first day of week (Monday) */
         day0 = j2day(day4 - 1);
 
         if (dayn >= day4 - day0)
             result = (dayn - (day4 - day0)) / 7 + 1;
     }
 
     return (int) result;
 }

◆ date2isoyear()

int date2isoyear	(	int	year,
		int	mon,
		int	mday
	)

Definition at line 4487 of file timestamp.c.

References date2j(), and j2day().

Referenced by date2isoyearday(), DCH_to_char(), extract_date(), timestamp_part_common(), and timestamptz_part_common().

 {
     float8      result;
     int         day0,
                 day4,
                 dayn;
 
     /* current day */
     dayn = date2j(year, mon, mday);
 
     /* fourth day of current year */
     day4 = date2j(year, 1, 4);
 
     /* day0 == offset to first day of week (Monday) */
     day0 = j2day(day4 - 1);
 
     /*
      * We need the first week containing a Thursday, otherwise this day falls
      * into the previous year for purposes of counting weeks
      */
     if (dayn < day4 - day0)
     {
         day4 = date2j(year - 1, 1, 4);
 
         /* day0 == offset to first day of week (Monday) */
         day0 = j2day(day4 - 1);
 
         year--;
     }
 
     result = (dayn - (day4 - day0)) / 7 + 1;
 
     /*
      * Sometimes the last few days in a year will fall into the first week of
      * the next year, so check for this.
      */
     if (result >= 52)
     {
         day4 = date2j(year + 1, 1, 4);
 
         /* day0 == offset to first day of week (Monday) */
         day0 = j2day(day4 - 1);
 
         if (dayn >= day4 - day0)
             year++;
     }
 
     return year;
 }

◆ date2isoyearday()

int date2isoyearday	(	int	year,
		int	mon,
		int	mday
	)

Definition at line 4544 of file timestamp.c.

References date2isoyear(), date2j(), and isoweek2j().

Referenced by DCH_to_char().

 {
     return date2j(year, mon, mday) - isoweek2j(date2isoyear(year, mon, mday), 1) + 1;
 }

◆ dt2time()

void dt2time	(	Timestamp	dt,
		int *	hour,
		int *	min,
		int *	sec,
		fsec_t *	fsec
	)

Definition at line 1795 of file timestamp.c.

References USECS_PER_HOUR, USECS_PER_MINUTE, and USECS_PER_SEC.

Referenced by DecodeDateTime(), DecodeTimeOnly(), and timestamp2tm().

 {
     TimeOffset  time;
 
     time = jd;
 
     *hour = time / USECS_PER_HOUR;
     time -= (*hour) * USECS_PER_HOUR;
     *min = time / USECS_PER_MINUTE;
     time -= (*min) * USECS_PER_MINUTE;
     *sec = time / USECS_PER_SEC;
     *fsec = time - (*sec * USECS_PER_SEC);
 }                               /* dt2time() */

◆ GetCurrentTimestamp()

TimestampTz GetCurrentTimestamp ( void )

Definition at line 1580 of file timestamp.c.

References gettimeofday(), POSTGRES_EPOCH_JDATE, SECS_PER_DAY, UNIX_EPOCH_JDATE, and USECS_PER_SEC.

Referenced by ApplyLauncherMain(), ApplyWorkerMain(), asyncQueueFillWarning(), autoprewarm_main(), autovac_refresh_stats(), AutoVacLauncherMain(), backend_read_statsfile(), BackgroundWriterMain(), check_log_duration(), CheckPointGuts(), CleanupBackgroundWorker(), clock_timestamp(), CreateCheckPoint(), CreateEndOfRecoveryRecord(), CreateRestartPoint(), DetermineSleepTime(), disable_timeout(), disable_timeouts(), do_analyze_rel(), do_start_bgworker(), do_start_worker(), drandom(), enable_timeout_after(), enable_timeout_at(), enable_timeouts(), entry_reset(), get_role_password(), GetCurrentTransactionStopTimestamp(), GetReplicationApplyDelay(), GetSnapshotCurrentTimestamp(), handle_sig_alarm(), heap_vacuum_rel(), InitProcessGlobals(), launcher_determine_sleep(), LockBufferForCleanup(), log_disconnections(), LogCheckpointEnd(), logicalrep_worker_launch(), LogicalRepApplyLoop(), maybe_start_bgworkers(), perform_base_backup(), pgfdw_cancel_query(), pgfdw_exec_cleanup_query(), pgfdw_get_cleanup_result(), pgss_shmem_startup(), pgstat_read_statsfiles(), pgstat_recv_inquiry(), pgstat_recv_resetreplslotcounter(), pgstat_recv_resetsharedcounter(), pgstat_recv_resetsinglecounter(), pgstat_recv_resetslrucounter(), pgstat_report_activity(), pgstat_report_analyze(), pgstat_report_autovac(), pgstat_report_checksum_failures_in_db(), pgstat_report_vacuum(), pgstat_send_archiver(), pgstat_send_connstats(), pgstat_send_wal(), pgstat_write_statsfiles(), PostgresMain(), PostmasterMain(), PrepareTransaction(), process_syncing_tables_for_apply(), ProcessRepliesIfAny(), ProcessStandbyReplyMessage(), ProcessWalSndrMessage(), ProcSleep(), rebuild_database_list(), RecordTransactionAbort(), RecordTransactionAbortPrepared(), RecordTransactionCommitPrepared(), recoveryApplyDelay(), reschedule_timeouts(), reset_dbentry_counters(), ResolveRecoveryConflictWithBufferPin(), ResolveRecoveryConflictWithLock(), ResolveRecoveryConflictWithVirtualXIDs(), send_feedback(), SetCurrentStatementStartTimestamp(), SetCurrentTransactionStopTimestamp(), StartTransaction(), StartupXLOG(), test_pattern(), throttle(), UpdateWorkerStats(), WaitExceedsMaxStandbyDelay(), WaitForWALToBecomeAvailable(), WalReceiverMain(), WalSndKeepalive(), WalSndLoop(), WalSndUpdateProgress(), WalSndWaitForWal(), WalSndWriteData(), XLogBackgroundFlush(), XLogFileRead(), XLogRestorePoint(), XLogSendPhysical(), XLogWalRcvSendHSFeedback(), and XLogWalRcvSendReply().

 {
     TimestampTz result;
     struct timeval tp;
 
     gettimeofday(&tp, NULL);
 
     result = (TimestampTz) tp.tv_sec -
         ((POSTGRES_EPOCH_JDATE - UNIX_EPOCH_JDATE) * SECS_PER_DAY);
     result = (result * USECS_PER_SEC) + tp.tv_usec;
 
     return result;
 }

◆ GetEpochTime()

void GetEpochTime ( struct pg_tm * tm )

Definition at line 2048 of file timestamp.c.

References elog, epoch, ERROR, pg_gmtime(), pg_tm::tm_hour, pg_tm::tm_mday, pg_tm::tm_min, pg_tm::tm_mon, pg_tm::tm_sec, and pg_tm::tm_year.

Referenced by date_in(), PGTYPESdate_from_asc(), and SetEpochTimestamp().

 {
     struct pg_tm *t0;
     pg_time_t   epoch = 0;
 
     t0 = pg_gmtime(&epoch);
 
     if (t0 == NULL)
         elog(ERROR, "could not convert epoch to timestamp: %m");
 
     tm->tm_year = t0->tm_year;
     tm->tm_mon = t0->tm_mon;
     tm->tm_mday = t0->tm_mday;
     tm->tm_hour = t0->tm_hour;
     tm->tm_min = t0->tm_min;
     tm->tm_sec = t0->tm_sec;
 
     tm->tm_year += 1900;
     tm->tm_mon++;
 }

◆ GetSQLCurrentTimestamp()

TimestampTz GetSQLCurrentTimestamp ( int32 typmod )

Definition at line 1598 of file timestamp.c.

References AdjustTimestampForTypmod(), and GetCurrentTransactionStartTimestamp().

Referenced by ExecEvalSQLValueFunction().

 {
     TimestampTz ts;
 
     ts = GetCurrentTransactionStartTimestamp();
     if (typmod >= 0)
         AdjustTimestampForTypmod(&ts, typmod);
     return ts;
 }

◆ GetSQLLocalTimestamp()

Timestamp GetSQLLocalTimestamp ( int32 typmod )

Definition at line 1612 of file timestamp.c.

References AdjustTimestampForTypmod(), GetCurrentTransactionStartTimestamp(), and timestamptz2timestamp().

Referenced by ExecEvalSQLValueFunction().

 {
     Timestamp   ts;
 
     ts = timestamptz2timestamp(GetCurrentTransactionStartTimestamp());
     if (typmod >= 0)
         AdjustTimestampForTypmod(&ts, typmod);
     return ts;
 }

◆ interval2tm()

int interval2tm	(	Interval	span,
		struct pg_tm *	tm,
		fsec_t *	fsec
	)

Definition at line 1966 of file timestamp.c.

References Interval::day, ereport, errcode(), errmsg(), ERROR, Interval::month, MONTHS_PER_YEAR, SAMESIGN, Interval::time, pg_tm::tm_hour, pg_tm::tm_mday, pg_tm::tm_min, pg_tm::tm_mon, pg_tm::tm_sec, pg_tm::tm_year, USECS_PER_HOUR, USECS_PER_MINUTE, and USECS_PER_SEC.

Referenced by interval_out(), interval_part_common(), interval_to_char(), and interval_trunc().

 {
     TimeOffset  time;
     TimeOffset  tfrac;
 
     tm->tm_year = span.month / MONTHS_PER_YEAR;
     tm->tm_mon = span.month % MONTHS_PER_YEAR;
     tm->tm_mday = span.day;
     time = span.time;
 
     tfrac = time / USECS_PER_HOUR;
     time -= tfrac * USECS_PER_HOUR;
     tm->tm_hour = tfrac;
     if (!SAMESIGN(tm->tm_hour, tfrac))
         ereport(ERROR,
                 (errcode(ERRCODE_DATETIME_VALUE_OUT_OF_RANGE),
                  errmsg("interval out of range")));
     tfrac = time / USECS_PER_MINUTE;
     time -= tfrac * USECS_PER_MINUTE;
     tm->tm_min = tfrac;
     tfrac = time / USECS_PER_SEC;
     *fsec = time - (tfrac * USECS_PER_SEC);
     tm->tm_sec = tfrac;
 
     return 0;
 }

◆ isoweek2date()

void isoweek2date	(	int	woy,
		int *	year,
		int *	mon,
		int *	mday
	)

Definition at line 4401 of file timestamp.c.

References isoweek2j(), and j2date().

Referenced by do_to_timestamp(), timestamp_trunc(), and timestamptz_trunc_internal().

 {
     j2date(isoweek2j(*year, woy), year, mon, mday);
 }

◆ isoweek2j()

int isoweek2j	(	int	year,
		int	week
	)

Definition at line 4381 of file timestamp.c.

References date2j(), and j2day().

Referenced by date2isoyearday(), do_to_timestamp(), isoweek2date(), and isoweekdate2date().

 {
     int         day0,
                 day4;
 
     /* fourth day of current year */
     day4 = date2j(year, 1, 4);
 
     /* day0 == offset to first day of week (Monday) */
     day0 = j2day(day4 - 1);
 
     return ((week - 1) * 7) + (day4 - day0);
 }

◆ isoweekdate2date()

void isoweekdate2date	(	int	isoweek,
		int	wday,
		int *	year,
		int *	mon,
		int *	mday
	)

Definition at line 4414 of file timestamp.c.

References isoweek2j(), and j2date().

Referenced by do_to_timestamp().

 {
     int         jday;
 
     jday = isoweek2j(*year, isoweek);
     /* convert Gregorian week start (Sunday=1) to ISO week start (Monday=1) */
     if (wday > 1)
         jday += wday - 2;
     else
         jday += 6;
     j2date(jday, year, mon, mday);
 }

◆ SetEpochTimestamp()

Timestamp SetEpochTimestamp ( void )

Definition at line 2070 of file timestamp.c.

References GetEpochTime(), tm, and tm2timestamp().

Referenced by dttofmtasc_replace(), PGTYPEStimestamp_from_asc(), timestamp_in(), timestamp_part_common(), timestamptz_in(), and timestamptz_part_common().

 {
     Timestamp   dt;
     struct pg_tm tt,
                *tm = &tt;
 
     GetEpochTime(tm);
     /* we don't bother to test for failure ... */
     tm2timestamp(tm, 0, NULL, &dt);
 
     return dt;
 }                               /* SetEpochTimestamp() */

◆ time_t_to_timestamptz()

TimestampTz time_t_to_timestamptz ( pg_time_t tm )

Definition at line 1732 of file timestamp.c.

References POSTGRES_EPOCH_JDATE, SECS_PER_DAY, UNIX_EPOCH_JDATE, and USECS_PER_SEC.

Referenced by pg_control_checkpoint(), pg_control_system(), pg_ls_dir_files(), and pg_stat_file().

 {
     TimestampTz result;
 
     result = (TimestampTz) tm -
         ((POSTGRES_EPOCH_JDATE - UNIX_EPOCH_JDATE) * SECS_PER_DAY);
     result *= USECS_PER_SEC;
 
     return result;
 }

◆ timestamp2timestamptz_opt_overflow()

TimestampTz timestamp2timestamptz_opt_overflow	(	Timestamp	timestamp,
		int *	overflow
	)

Definition at line 5521 of file timestamp.c.

References DetermineTimeZoneOffset(), dt2local(), ereport, errcode(), errmsg(), ERROR, IS_VALID_TIMESTAMP, MIN_TIMESTAMP, session_timezone, timestamp2tm(), TIMESTAMP_NOBEGIN, TIMESTAMP_NOEND, TIMESTAMP_NOT_FINITE, and tm.

Referenced by timestamp2timestamptz(), and timestamp_cmp_timestamptz_internal().

 {
     TimestampTz result;
     struct pg_tm tt,
                *tm = &tt;
     fsec_t      fsec;
     int         tz;
 
     if (overflow)
         *overflow = 0;
 
     if (TIMESTAMP_NOT_FINITE(timestamp))
         return timestamp;
 
     /* We don't expect this to fail, but check it pro forma */
     if (timestamp2tm(timestamp, NULL, tm, &fsec, NULL, NULL) == 0)
     {
         tz = DetermineTimeZoneOffset(tm, session_timezone);
 
         result = dt2local(timestamp, -tz);
 
         if (IS_VALID_TIMESTAMP(result))
         {
             return result;
         }
         else if (overflow)
         {
             if (result < MIN_TIMESTAMP)
             {
                 *overflow = -1;
                 TIMESTAMP_NOBEGIN(result);
             }
             else
             {
                 *overflow = 1;
                 TIMESTAMP_NOEND(result);
             }
             return result;
         }
     }
 
     ereport(ERROR,
             (errcode(ERRCODE_DATETIME_VALUE_OUT_OF_RANGE),
              errmsg("timestamp out of range")));
 
     return 0;
 }

◆ timestamp2tm()

int timestamp2tm	(	Timestamp	dt,
		int *	tzp,
		struct pg_tm *	tm,
		fsec_t *	fsec,
		const char **	tzn,
		pg_tz *	attimezone
	)

Definition at line 1822 of file timestamp.c.

References dt2time(), j2date(), pg_localtime(), POSTGRES_EPOCH_JDATE, SECS_PER_DAY, session_timezone, pg_tm::tm_gmtoff, pg_tm::tm_hour, pg_tm::tm_isdst, pg_tm::tm_mday, pg_tm::tm_min, pg_tm::tm_mon, pg_tm::tm_sec, pg_tm::tm_year, pg_tm::tm_zone, TMODULO, UNIX_EPOCH_JDATE, USECS_PER_DAY, and USECS_PER_SEC.

Referenced by DetermineTimeZoneAbbrevOffsetTS(), GetCurrentTimeUsec(), JsonEncodeDateTime(), make_timestamptz_at_timezone(), map_sql_value_to_xml_value(), pg_timezone_names(), PGTYPEStimestamp_add_interval(), PGTYPEStimestamp_fmt_asc(), PGTYPEStimestamp_to_asc(), timestamp2timestamptz_opt_overflow(), timestamp_age(), timestamp_date(), timestamp_out(), timestamp_part_common(), timestamp_pl_interval(), timestamp_recv(), timestamp_time(), timestamp_to_char(), timestamp_trunc(), timestamp_zone(), timestamptz2timestamp(), timestamptz_age(), timestamptz_date(), timestamptz_out(), timestamptz_part_common(), timestamptz_pl_interval(), timestamptz_recv(), timestamptz_time(), timestamptz_timetz(), timestamptz_to_char(), timestamptz_to_str(), timestamptz_trunc_internal(), and timestamptz_zone().

 {
     Timestamp   date;
     Timestamp   time;
     pg_time_t   utime;
 
     /* Use session timezone if caller asks for default */
     if (attimezone == NULL)
         attimezone = session_timezone;
 
     time = dt;
     TMODULO(time, date, USECS_PER_DAY);
 
     if (time < INT64CONST(0))
     {
         time += USECS_PER_DAY;
         date -= 1;
     }
 
     /* add offset to go from J2000 back to standard Julian date */
     date += POSTGRES_EPOCH_JDATE;
 
     /* Julian day routine does not work for negative Julian days */
     if (date < 0 || date > (Timestamp) INT_MAX)
         return -1;
 
     j2date((int) date, &tm->tm_year, &tm->tm_mon, &tm->tm_mday);
     dt2time(time, &tm->tm_hour, &tm->tm_min, &tm->tm_sec, fsec);
 
     /* Done if no TZ conversion wanted */
     if (tzp == NULL)
     {
         tm->tm_isdst = -1;
         tm->tm_gmtoff = 0;
         tm->tm_zone = NULL;
         if (tzn != NULL)
             *tzn = NULL;
         return 0;
     }
 
     /*
      * If the time falls within the range of pg_time_t, use pg_localtime() to
      * rotate to the local time zone.
      *
      * First, convert to an integral timestamp, avoiding possibly
      * platform-specific roundoff-in-wrong-direction errors, and adjust to
      * Unix epoch.  Then see if we can convert to pg_time_t without loss. This
      * coding avoids hardwiring any assumptions about the width of pg_time_t,
      * so it should behave sanely on machines without int64.
      */
     dt = (dt - *fsec) / USECS_PER_SEC +
         (POSTGRES_EPOCH_JDATE - UNIX_EPOCH_JDATE) * SECS_PER_DAY;
     utime = (pg_time_t) dt;
     if ((Timestamp) utime == dt)
     {
         struct pg_tm *tx = pg_localtime(&utime, attimezone);
 
         tm->tm_year = tx->tm_year + 1900;
         tm->tm_mon = tx->tm_mon + 1;
         tm->tm_mday = tx->tm_mday;
         tm->tm_hour = tx->tm_hour;
         tm->tm_min = tx->tm_min;
         tm->tm_sec = tx->tm_sec;
         tm->tm_isdst = tx->tm_isdst;
         tm->tm_gmtoff = tx->tm_gmtoff;
         tm->tm_zone = tx->tm_zone;
         *tzp = -tm->tm_gmtoff;
         if (tzn != NULL)
             *tzn = tm->tm_zone;
     }
     else
     {
         /*
          * When out of range of pg_time_t, treat as GMT
          */
         *tzp = 0;
         /* Mark this as *no* time zone available */
         tm->tm_isdst = -1;
         tm->tm_gmtoff = 0;
         tm->tm_zone = NULL;
         if (tzn != NULL)
             *tzn = NULL;
     }
 
     return 0;
 }

◆ timestamp_cmp_internal()

int timestamp_cmp_internal	(	Timestamp	dt1,
		Timestamp	dt2
	)

Definition at line 2090 of file timestamp.c.

Referenced by date_cmp_timestamp_internal(), generate_series_timestamp(), generate_series_timestamptz(), timestamp_cmp(), timestamp_eq(), timestamp_fastcmp(), timestamp_ge(), timestamp_gt(), timestamp_larger(), timestamp_le(), timestamp_lt(), timestamp_ne(), and timestamp_smaller().

 {
     return (dt1 < dt2) ? -1 : ((dt1 > dt2) ? 1 : 0);
 }

◆ timestamp_cmp_timestamptz_internal()

int32 timestamp_cmp_timestamptz_internal	(	Timestamp	timestampVal,
		TimestampTz	dt2
	)

Definition at line 2194 of file timestamp.c.

References timestamp2timestamptz_opt_overflow(), TIMESTAMP_IS_NOBEGIN, TIMESTAMP_IS_NOEND, and timestamptz_cmp_internal.

Referenced by cmpTimestampToTimestampTz(), timestamp_cmp_timestamptz(), timestamp_eq_timestamptz(), timestamp_ge_timestamptz(), timestamp_gt_timestamptz(), timestamp_le_timestamptz(), timestamp_lt_timestamptz(), timestamp_ne_timestamptz(), timestamptz_cmp_timestamp(), timestamptz_eq_timestamp(), timestamptz_ge_timestamp(), timestamptz_gt_timestamp(), timestamptz_le_timestamp(), timestamptz_lt_timestamp(), and timestamptz_ne_timestamp().

 {
     TimestampTz dt1;
     int         overflow;
 
     dt1 = timestamp2timestamptz_opt_overflow(timestampVal, &overflow);
     if (overflow > 0)
     {
         /* dt1 is larger than any finite timestamp, but less than infinity */
         return TIMESTAMP_IS_NOEND(dt2) ? -1 : +1;
     }
     if (overflow < 0)
     {
         /* dt1 is less than any finite timestamp, but more than -infinity */
         return TIMESTAMP_IS_NOBEGIN(dt2) ? +1 : -1;
     }
 
     return timestamptz_cmp_internal(dt1, dt2);
 }

◆ TimestampDifference()

void TimestampDifference	(	TimestampTz	start_time,
		TimestampTz	stop_time,
		long *	secs,
		int *	microsecs
	)

Definition at line 1656 of file timestamp.c.

References start_time, and USECS_PER_SEC.

Referenced by check_log_duration(), DetermineSleepTime(), heap_vacuum_rel(), launcher_determine_sleep(), log_disconnections(), LogRecoveryConflict(), pgstat_report_activity(), pgstat_send_connstats(), ProcSleep(), and schedule_alarm().

 {
     TimestampTz diff = stop_time - start_time;
 
     if (diff <= 0)
     {
         *secs = 0;
         *microsecs = 0;
     }
     else
     {
         *secs = (long) (diff / USECS_PER_SEC);
         *microsecs = (int) (diff % USECS_PER_SEC);
     }
 }

◆ TimestampDifferenceExceeds()

bool TimestampDifferenceExceeds	(	TimestampTz	start_time,
		TimestampTz	stop_time,
		int	msec
	)

Definition at line 1711 of file timestamp.c.

References start_time.

Referenced by ApplyLauncherMain(), asyncQueueFillWarning(), autovac_refresh_stats(), AutoVacLauncherMain(), do_analyze_rel(), do_start_worker(), heap_vacuum_rel(), LockBufferForCleanup(), logicalrep_worker_launch(), maybe_start_bgworkers(), pgstat_report_stat(), pgstat_send_wal(), process_syncing_tables_for_apply(), ProcSleep(), ResolveRecoveryConflictWithVirtualXIDs(), send_feedback(), WaitForWALToBecomeAvailable(), WalSndUpdateProgress(), XLogBackgroundFlush(), XLogWalRcvSendHSFeedback(), and XLogWalRcvSendReply().

 {
     TimestampTz diff = stop_time - start_time;
 
     return (diff >= msec * INT64CONST(1000));
 }

◆ TimestampDifferenceMilliseconds()

long TimestampDifferenceMilliseconds	(	TimestampTz	start_time,
		TimestampTz	stop_time
	)

Definition at line 1693 of file timestamp.c.

References start_time.

Referenced by autoprewarm_main(), do_analyze_rel(), GetReplicationApplyDelay(), GetReplicationTransferLatency(), LogCheckpointEnd(), pgfdw_get_cleanup_result(), recoveryApplyDelay(), WaitForWALToBecomeAvailable(), and WalSndComputeSleeptime().

 {
     TimestampTz diff = stop_time - start_time;
 
     if (diff <= 0)
         return 0;
     else
         return (long) ((diff + 999) / 1000);
 }

◆ TimestampTimestampTzRequiresRewrite()

bool TimestampTimestampTzRequiresRewrite ( void )

Definition at line 5490 of file timestamp.c.

References pg_get_timezone_offset(), and session_timezone.

Referenced by ATColumnChangeRequiresRewrite().

 {
     long        offset;
 
     if (pg_get_timezone_offset(session_timezone, &offset) && offset == 0)
         return false;
     return true;
 }

◆ timestamptz_to_str()

const char* timestamptz_to_str ( TimestampTz t )

Definition at line 1774 of file timestamp.c.

References buf, EncodeDateTime(), EncodeSpecialTimestamp(), MAXDATELEN, snprintf, strlcpy(), timestamp2tm(), TIMESTAMP_NOT_FINITE, timestamptz_to_time_t(), tm, USE_ISO_DATES, and USECS_PER_SEC.

Referenced by backend_read_statsfile(), CreateRestartPoint(), pg_decode_commit_prepared_txn(), pg_decode_commit_txn(), pg_decode_prepare_txn(), pg_decode_rollback_prepared_txn(), pg_decode_stream_commit(), pg_decode_stream_prepare(), pgstat_recv_inquiry(), ProcessStandbyHSFeedbackMessage(), ProcessStandbyReplyMessage(), ProcessWalSndrMessage(), recoveryStopsAfter(), recoveryStopsBefore(), StartupXLOG(), xact_desc_abort(), xact_desc_commit(), xact_desc_prepare(), and xlog_desc().

 {
     static char buf[MAXDATELEN + 1];
     int         tz;
     struct pg_tm tt,
                *tm = &tt;
     fsec_t      fsec;
     const char *tzn;
 
     if (TIMESTAMP_NOT_FINITE(t))
         EncodeSpecialTimestamp(t, buf);
     else if (timestamp2tm(t, &tz, tm, &fsec, &tzn, NULL) == 0)
         EncodeDateTime(tm, fsec, true, tz, tzn, USE_ISO_DATES, buf);
     else
         strlcpy(buf, "(timestamp out of range)", sizeof(buf));
 
     return buf;
 }

◆ timestamptz_to_time_t()

pg_time_t timestamptz_to_time_t ( TimestampTz t )

Definition at line 1754 of file timestamp.c.

References POSTGRES_EPOCH_JDATE, SECS_PER_DAY, UNIX_EPOCH_JDATE, and USECS_PER_SEC.

Referenced by DetermineTimeZoneAbbrevOffsetTS(), InitProcessGlobals(), and timestamptz_to_str().

 {
     pg_time_t   result;
 
     result = (pg_time_t) (t / USECS_PER_SEC +
                           ((POSTGRES_EPOCH_JDATE - UNIX_EPOCH_JDATE) * SECS_PER_DAY));
 
     return result;
 }

◆ tm2interval()

int tm2interval	(	struct pg_tm *	tm,
		fsec_t	fsec,
		Interval *	span
	)

Definition at line 1994 of file timestamp.c.

References Interval::day, Interval::month, MONTHS_PER_YEAR, Interval::time, pg_tm::tm_hour, pg_tm::tm_mday, pg_tm::tm_min, pg_tm::tm_mon, pg_tm::tm_sec, pg_tm::tm_year, and USECS_PER_SEC.

Referenced by interval_in(), interval_trunc(), pg_timezone_abbrevs(), pg_timezone_names(), timestamp_age(), and timestamptz_age().

 {
     double      total_months = (double) tm->tm_year * MONTHS_PER_YEAR + tm->tm_mon;
 
     if (total_months > INT_MAX || total_months < INT_MIN)
         return -1;
     span->month = total_months;
     span->day = tm->tm_mday;
     span->time = (((((tm->tm_hour * INT64CONST(60)) +
                      tm->tm_min) * INT64CONST(60)) +
                    tm->tm_sec) * USECS_PER_SEC) + fsec;
 
     return 0;
 }

◆ tm2timestamp()

int tm2timestamp	(	struct pg_tm *	tm,
		fsec_t	fsec,
		int *	tzp,
		Timestamp *	dt
	)

Definition at line 1918 of file timestamp.c.

References date2j(), dt2local(), IS_VALID_JULIAN, IS_VALID_TIMESTAMP, POSTGRES_EPOCH_JDATE, time2t(), pg_tm::tm_hour, pg_tm::tm_mday, pg_tm::tm_min, pg_tm::tm_mon, pg_tm::tm_sec, pg_tm::tm_year, and USECS_PER_DAY.

Referenced by check_recovery_target_time(), parse_datetime(), PGTYPEStimestamp_add_interval(), PGTYPEStimestamp_current(), PGTYPEStimestamp_defmt_scan(), PGTYPEStimestamp_from_asc(), SetEpochTimestamp(), timestamp_in(), timestamp_pl_interval(), timestamp_trunc(), timestamp_zone(), timestamptz2timestamp(), timestamptz_in(), timestamptz_pl_interval(), timestamptz_trunc_internal(), timestamptz_zone(), and to_timestamp().

 {
     TimeOffset  date;
     TimeOffset  time;
 
     /* Prevent overflow in Julian-day routines */
     if (!IS_VALID_JULIAN(tm->tm_year, tm->tm_mon, tm->tm_mday))
     {
         *result = 0;            /* keep compiler quiet */
         return -1;
     }
 
     date = date2j(tm->tm_year, tm->tm_mon, tm->tm_mday) - POSTGRES_EPOCH_JDATE;
     time = time2t(tm->tm_hour, tm->tm_min, tm->tm_sec, fsec);
 
     *result = date * USECS_PER_DAY + time;
     /* check for major overflow */
     if ((*result - time) / USECS_PER_DAY != date)
     {
         *result = 0;            /* keep compiler quiet */
         return -1;
     }
     /* check for just-barely overflow (okay except time-of-day wraps) */
     /* caution: we want to allow 1999-12-31 24:00:00 */
     if ((*result < 0 && date > 0) ||
         (*result > 0 && date < -1))
     {
         *result = 0;            /* keep compiler quiet */
         return -1;
     }
     if (tzp != NULL)
         *result = dt2local(*result, -(*tzp));
 
     /* final range check catches just-out-of-range timestamps */
     if (!IS_VALID_TIMESTAMP(*result))
     {
         *result = 0;            /* keep compiler quiet */
         return -1;
     }
 
     return 0;
 }

Variable Documentation

◆ PgReloadTime

TimestampTz PgReloadTime

Definition at line 55 of file timestamp.c.

Referenced by pg_conf_load_time(), and PostmasterMarkPIDForWorkerNotify().

◆ PgStartTime

TimestampTz PgStartTime

Definition at line 52 of file timestamp.c.

Referenced by pg_postmaster_start_time(), PostgresMain(), PostmasterMain(), and PostmasterMarkPIDForWorkerNotify().

Macros

Functions

Variables

Macro Definition Documentation

◆ DatumGetIntervalP

◆ DatumGetTimestamp

◆ DatumGetTimestampTz

◆ INTERVAL_FULL_PRECISION

◆ INTERVAL_FULL_RANGE

◆ INTERVAL_MASK

◆ INTERVAL_PRECISION

◆ INTERVAL_PRECISION_MASK

◆ INTERVAL_RANGE

◆ INTERVAL_RANGE_MASK

◆ INTERVAL_TYPMOD

◆ IntervalPGetDatum

◆ PG_GETARG_INTERVAL_P

◆ PG_GETARG_TIMESTAMP

◆ PG_GETARG_TIMESTAMPTZ

◆ PG_RETURN_INTERVAL_P

◆ PG_RETURN_TIMESTAMP

◆ PG_RETURN_TIMESTAMPTZ

◆ TIMESTAMP_MASK

◆ TimestampGetDatum

◆ timestamptz_cmp_internal

◆ TimestampTzGetDatum

◆ TimestampTzPlusMilliseconds

Function Documentation

◆ anytimestamp_typmod_check()

◆ date2isoweek()

◆ date2isoyear()

◆ date2isoyearday()

◆ dt2time()

◆ GetCurrentTimestamp()

◆ GetEpochTime()

◆ GetSQLCurrentTimestamp()

◆ GetSQLLocalTimestamp()

◆ interval2tm()

◆ isoweek2date()

◆ isoweek2j()

◆ isoweekdate2date()

◆ SetEpochTimestamp()

◆ time_t_to_timestamptz()

◆ timestamp2timestamptz_opt_overflow()

◆ timestamp2tm()

◆ timestamp_cmp_internal()

◆ timestamp_cmp_timestamptz_internal()

◆ TimestampDifference()

◆ TimestampDifferenceExceeds()

◆ TimestampDifferenceMilliseconds()

◆ TimestampTimestampTzRequiresRewrite()

◆ timestamptz_to_str()

◆ timestamptz_to_time_t()

◆ tm2interval()

◆ tm2timestamp()

Variable Documentation

◆ PgReloadTime

◆ PgStartTime