org.postgresql.jdbc

Class TimestampUtils

java.lang.Object

org.postgresql.jdbc.TimestampUtils

public class TimestampUtils
extends Object

Misc utils for handling time and date values.

Method Summary

Methods

Modifier and Type	Method and Description
Date	convertToDate(long millis, TimeZone tz) Extracts the date part from a timestamp.
Time	convertToTime(long millis, TimeZone tz) Extracts the time part from a timestamp.
Calendar	getSharedCalendar(TimeZone timeZone) Get a shared calendar, applying the supplied time zone or the default time zone if null.
boolean	hasFastDefaultTimeZone()
static TimeZone	parseBackendTimeZone(String timeZone) Converts backend's TimeZone parameter to java format.
String	timeToString(Date time, boolean withTimeZone) Returns the given time value as String matching what the current postgresql server would send in text mode.
void	toBinDate(TimeZone tz, byte[] bytes, Date value) Converts the SQL Date to binary representation for Oid.DATE.
Date	toDate(Calendar cal, String s)
Date	toDateBin(TimeZone tz, byte[] bytes) Returns the SQL Date object matching the given bytes with Oid.DATE.
String	toString(Calendar cal, Date x)
String	toString(Calendar cal, Date x, boolean withTimeZone)
String	toString(Calendar cal, Time x)
String	toString(Calendar cal, Time x, boolean withTimeZone)
String	toString(Calendar cal, Timestamp x)
String	toString(Calendar cal, Timestamp x, boolean withTimeZone)
Time	toTime(Calendar cal, String s)
Time	toTimeBin(TimeZone tz, byte[] bytes) Returns the SQL Time object matching the given bytes with Oid.TIME or Oid.TIMETZ.
Timestamp	toTimestamp(Calendar cal, String s) Parse a string and return a timestamp representing its value.
Timestamp	toTimestampBin(TimeZone tz, byte[] bytes, boolean timestamptz) Returns the SQL Timestamp object matching the given bytes with Oid.TIMESTAMP or Oid.TIMESTAMPTZ.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

toTimestamp

public Timestamp toTimestamp(Calendar cal,
                    String s)
                      throws SQLException

Parse a string and return a timestamp representing its value.

Parameters:

cal - calendar to be used to parse the input string

s - The ISO formated date string to parse.

Returns:

null if s is null or a timestamp of the parsed string s.

Throws:

SQLException - if there is a problem parsing s.

toTime

public Time toTime(Calendar cal,
          String s)
            throws SQLException

Throws:

SQLException

toDate

public Date toDate(Calendar cal,
          String s)
            throws SQLException

Throws:

SQLException

getSharedCalendar

public Calendar getSharedCalendar(TimeZone timeZone)

Get a shared calendar, applying the supplied time zone or the default time zone if null.

Parameters:

timeZone - time zone to be set for the calendar

Returns:

The shared calendar.

toString

public String toString(Calendar cal,
              Timestamp x)

toString

public String toString(Calendar cal,
              Timestamp x,
              boolean withTimeZone)

toString

public String toString(Calendar cal,
              Date x)

toString

public String toString(Calendar cal,
              Date x,
              boolean withTimeZone)

toString

public String toString(Calendar cal,
              Time x)

toString

public String toString(Calendar cal,
              Time x,
              boolean withTimeZone)

toDateBin

public Date toDateBin(TimeZone tz,
             byte[] bytes)
               throws PSQLException

Returns the SQL Date object matching the given bytes with Oid.DATE.

Parameters:

tz - The timezone used.

bytes - The binary encoded date value.

Returns:

The parsed date object.

Throws:

PSQLException - If binary format could not be parsed.

hasFastDefaultTimeZone

public boolean hasFastDefaultTimeZone()

toTimeBin

public Time toTimeBin(TimeZone tz,
             byte[] bytes)
               throws PSQLException

Returns the SQL Time object matching the given bytes with Oid.TIME or Oid.TIMETZ.

Parameters:

tz - The timezone used when received data is Oid.TIME, ignored if data already contains Oid.TIMETZ.

bytes - The binary encoded time value.

Returns:

The parsed time object.

Throws:

PSQLException - If binary format could not be parsed.

toTimestampBin

public Timestamp toTimestampBin(TimeZone tz,
                       byte[] bytes,
                       boolean timestamptz)
                         throws PSQLException

Returns the SQL Timestamp object matching the given bytes with Oid.TIMESTAMP or Oid.TIMESTAMPTZ.

Parameters:

tz - The timezone used when received data is Oid.TIMESTAMP, ignored if data already contains Oid.TIMESTAMPTZ.

bytes - The binary encoded timestamp value.

timestamptz - True if the binary is in GMT.

Returns:

The parsed timestamp object.

Throws:

PSQLException - If binary format could not be parsed.

convertToDate

public Date convertToDate(long millis,
                 TimeZone tz)

Extracts the date part from a timestamp.

Parameters:

millis - The timestamp from which to extract the date.

tz - The time zone of the date.

Returns:

The extracted date.

convertToTime

public Time convertToTime(long millis,
                 TimeZone tz)

Extracts the time part from a timestamp. This method ensures the date part of output timestamp looks like 1970-01-01 in given timezone.

Parameters:

millis - The timestamp from which to extract the time.

tz - timezone to use.

Returns:

The extracted time.

timeToString

public String timeToString(Date time,
                  boolean withTimeZone)

Returns the given time value as String matching what the current postgresql server would send in text mode.

Parameters:

time - time value

withTimeZone - whether timezone should be added

Returns:

given time value as String

toBinDate

public void toBinDate(TimeZone tz,
             byte[] bytes,
             Date value)
               throws PSQLException

Converts the SQL Date to binary representation for Oid.DATE.

Parameters:

tz - The timezone used.

bytes - The binary encoded date value.

value - value

Throws:

PSQLException - If binary format could not be parsed.

parseBackendTimeZone

public static TimeZone parseBackendTimeZone(String timeZone)

Converts backend's TimeZone parameter to java format. Notable difference: backend's gmt-3 is GMT+03 in Java.

Parameters:

timeZone - time zone to use

Returns:

java TimeZone