TimestampUtils类

用于处理时间和日期值的其他实用程序。

convertToDate

功能描述

从时间戳中提取日期部分。

语法格式

public Date convertToDate(long millis,             
TimeZone tz)

参数说明

millis：从中提取日期的时间戳。

tz：日期的时区。

返回值

返回提取的日期。

convertToTime

功能描述

从时间戳中提取时间部分。 此方法可确保输出时间戳的日期部分在给定时区中看起来像 1970-01-01。

语法格式

public Time convertToTime(long millis,             TimeZone tz)

参数说明

millis：从中提取时间的时间戳。

tz：要使用的时区。

返回值

返回提取的时间。

getSharedCalendar

功能描述

获取共享日历，应用提供的时区或默认时区（如果为空）。

语法格式

public Calendar getSharedCalendar(TimeZone timeZone)

参数说明

timeZone：要为日历设置的时区。

返回值

返回共享日历。

hasFastDefaultTimeZone

功能描述

获取是否具有快速默认时区。

语法格式

public boolean hasFastDefaultTimeZone()

参数说明

无。

返回值

若具有快速默认时区，则返回true，否则为false。

parseBackendTimeZone

功能描述

将后端的 TimeZone 参数转换为 java 格式。

语法格式

public static TimeZone parseBackendTimeZone(String timeZone)

参数说明

timeZone：要使用的时区。

返回值

返回java时区。

timeToString

功能描述

以字符串形式返回给定的时间值，与当前服务器在文本模式下发送的内容相匹配。

语法格式

public String timeToString(Date time,              
boolean withTimeZone)

参数说明

time：时间值。

withTimeZone：是否应添加时区。

返回值

返回给定时间值作为字符串。

toBinDate

功能描述

将 SQL 日期转换为 Oid.DATE 的二进制表示。

语法格式

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

参数说明

tz：使用的时区。

bytes：二进制编码的日期值。

value：日期值。

返回值

无。

toDate

功能描述

解析一个字符串并返回一个表示其值的Date类型。

语法格式

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

参数说明

cal：用于解析输入字符串的日历。

s：要解析的 ISO 格式的日期字符串。

返回值

返回已解析字符串 s 的日期，当 s 为 null 时返回 null。

toDateBin

功能描述

返回与给定字节与 Oid.DATE 匹配的 SQL 日期对象。

语法格式

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

参数说明

tz：使用的时区。

bytes：二进制编码的日期值。

返回值

返回解析的日期对象。

toLocalDateTime

功能描述

解析一个字符串并返回一个表示其值的 LocalDateTime类型。

语法格式

public LocalDateTime toLocalDateTime(String s)               throws SQLException

参数说明

s：要解析的 ISO 格式的日期字符串。

返回值

返回已解析字符串 s 的LocalDateTime类型，当 s 为 null 时返回 null。

生命周期

支持JDBC4.2及以上版本。

toLocalDateTimeBin

功能描述

使用 Oid.TIMESTAMP 或 Oid.TIMESTAMPTZ 返回与给定字节匹配的本地日期时间对象。

语法格式

public LocalDateTime toLocalDateTimeBin(byte[] bytes)                 throws PSQLException

参数说明

bytes：二进制编码的本地日期时间值。

返回值

返回解析的本地日期时间对象。

生命周期

支持JDBC4.2及以上版本。

toLocalTime

功能描述

解析一个字符串并返回一个表示其值的 LocalTime类型。

语法格式

public LocalTime toLocalTime(String s)           throws SQLException

参数说明

s：要解析的 ISO 格式的日期字符串。

返回值

返回已解析字符串 s 的LocalTime类型，当 s 为 null 时返回 null。

生命周期

支持JDBC4.2及以上版本。

toLocalTimeBin

功能描述

返回与给定字节数组及 Oid.TIME 匹配的 SQL 时间对象。

语法格式

public LocalTime toLocalTimeBin(byte[] bytes)             throws PSQLException

参数说明

bytes： 二进制编码的时间值。

返回值

返回解析的时间对象。

toOffsetDateTime(String s)

功能描述

解析一个字符串并返回一个表示其值的 LocalDateTime类型。

语法格式

public OffsetDateTime toOffsetDateTime(String s)                
throws SQLException

参数说明

s：要解析的 ISO 格式的日期字符串。

返回值

返回已解析字符串 s 的LocalDateTime类型，当 s 为 null 时返回 null。

生命周期

支持JDBC4.2及以上版本。

toOffsetDateTime(Time t)

功能描述

使用 Oid.TIMETZ 返回与给定字节匹配的偏移日期时间对象。

语法格式

public OffsetDateTime toOffsetDateTime(Time t)

参数说明

t：时间的值。

返回值

返回匹配的偏移日期时间。

生命周期

支持JDBC4.2及以上版本。

toOffsetDateTimeBin

功能描述

使用 Oid.TIMESTAMPTZ 返回与给定字节匹配的偏移日期时间对象。

语法格式

public OffsetDateTime toOffsetDateTimeBin(byte[] bytes)                  
throws PSQLException

参数说明

bytes： 二进制编码的本地日期时间值。

返回值

返回解析的本地日期时间对象。

生命周期

支持JDBC4.2及以上版本。

toString(Calendar cal, Date x)

功能描述

将date类型转换成字符串类型。

语法格式

public String toString(Calendar cal,            
Date x)

参数说明

cal：用于解析输入字符串的日历。

x：要转换的日期。

返回值

返回日期转化后的字符串。

toString(Calendar cal, Date x, boolean withTimeZone)

功能描述

将date类型转换成字符串类型。

语法格式

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

参数说明

cal：用于解析输入字符串的日历。

x：要转换的日期。

withTimeZone：是否应添加时区。

返回值

返回日期转化后的字符串。

toString(Calendar cal, Time x)

功能描述

将Time类型转换成字符串类型。

语法格式

public String toString(Calendar cal,            Time x)

参数说明

cal：用于解析输入字符串的日历。

x：要转换的时间。

返回值

返回时间转化后的字符串。

toString(Calendar cal, Time x, boolean withTimeZone)

功能描述

将Time类型转换成字符串类型。

语法格式

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

参数说明

cal：用于解析输入字符串的日历。

x：要转换的时间。

withTimeZone：是否应添加时区。

返回值

返回时间转化后的字符串。

toString(Calendar cal, Timestamp x)

功能描述

将Timestamp类型转换成字符串类型。

语法格式

public String toString(Calendar cal,            Timestamp x)

参数说明

cal：用于解析输入字符串的日历。

x：要转换的时间戳。

返回值

返回Timestamp转化后的字符串。

toString(Calendar cal, Timestamp x, boolean withTimeZone)

功能描述

将Timestamp类型转换成字符串类型。

语法格式

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

参数说明

cal：用于解析输入字符串的日历。

x：要转换的时间戳。

withTimeZone：是否应添加时区。

返回值

返回Timestamp转化后的字符串。

toString(LocalDate localDate)

功能描述

将localDate转换成字符串类型。

语法格式

public String toString(LocalDate localDate)

参数说明

localDate：本地的日期。

返回值

返回localDate转化后的字符串。

生命周期

支持JDBC4.2及以上版本。

toString(LocalDateTime localDateTime)

功能描述

将LocalDateTime转换成字符串类型。

语法格式

public String toString(LocalDateTime localDateTime)

参数说明

localDateTime：本地的日期时间。

返回值

返回LocalDateTime转化后的字符串。

生命周期

支持JDBC4.2及以上版本。

toString(LocalTime localTime)

功能描述

将LocalTime转换成字符串类型。

语法格式

public String toString(LocalTime localTime)

参数说明

localTime：本地的时间。

返回值

返回LocalTime转化后的字符串。

生命周期

支持JDBC4.2及以上版本。

toString(OffsetDateTime offsetDateTime)

功能描述

将OffsetDateTime转换成字符串类型。

语法格式

public String toString(OffsetDateTime offsetDateTime)

参数说明

offsetDateTime：本地的偏移日期时间。

返回值

返回OffsetDateTime转化后的字符串。

生命周期

支持JDBC4.2及以上版本。

toTime

功能描述

解析一个字符串并返回一个表示其值的Time类型。

语法格式

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

参数说明

cal：用于解析输入字符串的日历。

s：要解析的 ISO 格式的日期字符串。

返回值

返回已解析字符串 s 的时间，当 s 为 null 时返回 null。

toTimeBin

功能描述

使用 Oid.TIME 或 Oid.TIMETZ 返回匹配给定字节的 SQL 时间对象。

语法格式

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

参数说明

tz：接收数据时使用的时区为Oid.TIME，如果数据已经包含Oid.TIMETZ则忽略。

bytes：二进制编码的时间值。

返回值

返回解析的时间对象。

toTimestamp

功能描述

解析一个字符串并返回一个表示其值的Timestamp类型。

语法格式

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

参数说明

cal：用于解析输入字符串的日历。

s：要解析的 ISO 格式的日期字符串。

返回值

返回已解析字符串 s 的时间戳，当 s 为 null 时返回 null。

toTimestampBin

功能描述

使用 Oid.TIMESTAMP 或 Oid.TIMESTAMPTZ 返回与给定字节匹配的 SQL 时间戳对象。

语法格式

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

参数说明

tz：接收数据时使用的时区是 Oid.TIMESTAMP，如果数据已经包含 Oid.TIMESTAMPTZ，则忽略。

bytes：二进制编码的时间值。

timestamptz：如果二进制文件在 GMT中，则为真。

返回值

返回解析的时间对象。