org.apache.calcite.sql

Class SqlTimestampLiteral

java.lang.Object

org.apache.calcite.sql.SqlNode

org.apache.calcite.sql.SqlLiteral

org.apache.calcite.sql.SqlTimestampLiteral

All Implemented Interfaces:

Cloneable

public class SqlTimestampLiteral
extends SqlLiteral

A SQL literal representing a TIMESTAMP value, for example TIMESTAMP '1969-07-21 03:15 GMT'.

Create values using SqlLiteral.createTimestamp(java.util.Calendar, int, org.apache.calcite.sql.parser.SqlParserPos).

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.calcite.sql.SqlLiteral

SqlLiteral.SqlSymbol

Field Summary

Fields

Modifier and Type	Field and Description
protected String	formatString
protected boolean	hasTimeZone
protected int	precision

Fields inherited from class org.apache.calcite.sql.SqlLiteral

value

Fields inherited from class org.apache.calcite.sql.SqlNode

EMPTY_ARRAY, pos

Constructor Summary

Constructors

Constructor and Description
SqlTimestampLiteral(Calendar cal, int precision, boolean hasTimeZone, SqlParserPos pos)
SqlTimestampLiteral(Calendar cal, int precision, boolean hasTimeZone, String format, SqlParserPos pos)

Method Summary

Methods

Modifier and Type	Method and Description
SqlNode	clone(SqlParserPos pos) Clones a SqlNode with a different position.
RelDataType	createSqlType(RelDataTypeFactory typeFactory)
Calendar	getCal()
protected ZonelessDate	getDate() Converts this literal to a ZonelessDate object.
int	getPrec()
protected ZonelessTime	getTime() Converts this literal to a ZonelessTime object.
protected ZonelessTimestamp	getTimestamp() Converts this literal to a ZonelessTimestamp object.
TimeZone	getTimeZone() Returns timezone component of this literal.
String	toFormattedString() Returns e.g.
String	toString() Returns e.g.
String	toValue() For calc program builder - value may be different than SqlLiteral.unparse(org.apache.calcite.sql.SqlWriter, int, int) Typical values: Hello, world! 12.34 {null} 1969-04-29
void	unparse(SqlWriter writer, int leftPrec, int rightPrec) Writes a SQL representation of this node to a writer.

Methods inherited from class org.apache.calcite.sql.SqlLiteral

accept, bigDecimalValue, booleanValue, createApproxNumeric, createBinaryString, createBinaryString, createBoolean, createCharString, createCharString, createDate, createExactNumeric, createInterval, createNegative, createNull, createSample, createSymbol, createTime, createTimestamp, createUnknown, equals, equalsDeep, getKind, getMonotonicity, getStringValue, getTypeName, getValue, hashCode, intValue, longValue, sampleValue, signum, stringValue, symbolValue, unchain, unescapeUnicode, validate, valueMatchesType

Methods inherited from class org.apache.calcite.sql.SqlNode

clone, cloneArray, equalDeep, equalDeep, findValidOptions, getParserPosition, isA, toSqlString, toSqlString, validateExpr

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

hasTimeZone

protected final boolean hasTimeZone

formatString

protected final String formatString

precision

protected final int precision

Constructor Detail

SqlTimestampLiteral

public SqlTimestampLiteral(Calendar cal,
                   int precision,
                   boolean hasTimeZone,
                   SqlParserPos pos)

SqlTimestampLiteral

public SqlTimestampLiteral(Calendar cal,
                   int precision,
                   boolean hasTimeZone,
                   String format,
                   SqlParserPos pos)

Method Detail

clone

public SqlNode clone(SqlParserPos pos)

Description copied from class: SqlNode

Clones a SqlNode with a different position.

Overrides:

clone in class SqlLiteral

toString

public String toString()

Returns e.g. DATE '1969-07-21'.

toFormattedString

public String toFormattedString()

Returns e.g. '03:05:67.456'.

unparse

public void unparse(SqlWriter writer,
           int leftPrec,
           int rightPrec)

Description copied from class: SqlNode

Writes a SQL representation of this node to a writer.

The leftPrec and rightPrec parameters give us enough context to decide whether we need to enclose the expression in parentheses. For example, we need parentheses around "2 + 3" if preceded by "5 *". This is because the precedence of the "*" operator is greater than the precedence of the "+" operator.

The algorithm handles left- and right-associative operators by giving them slightly different left- and right-precedence.

If SqlWriter.isAlwaysUseParentheses() is true, we use parentheses even when they are not required by the precedence rules.

For the details of this algorithm, see SqlCall.unparse(org.apache.calcite.sql.SqlWriter, int, int).

Parameters:

writer - Target writer

leftPrec - The precedence of the SqlNode immediately preceding this node in a depth-first scan of the parse tree

rightPrec - The precedence of the SqlNode immediately

getPrec

public int getPrec()

toValue

public String toValue()

Description copied from class: SqlLiteral

For calc program builder - value may be different than SqlLiteral.unparse(org.apache.calcite.sql.SqlWriter, int, int) Typical values:

• Hello, world!
• 12.34
• {null}
• 1969-04-29

Overrides:

toValue in class SqlLiteral

Returns:

string representation of the value

getCal

public Calendar getCal()

getTimeZone

public TimeZone getTimeZone()

Returns timezone component of this literal. Technically, a sql date doesn't come with a tz, but time and ts inherit this, and the calendar object has one, so it seems harmless.

Returns:

timezone

createSqlType

public RelDataType createSqlType(RelDataTypeFactory typeFactory)

Overrides:

createSqlType in class SqlLiteral

getDate

protected ZonelessDate getDate()

Converts this literal to a ZonelessDate object.

getTime

protected ZonelessTime getTime()

Converts this literal to a ZonelessTime object.

getTimestamp

protected ZonelessTimestamp getTimestamp()

Converts this literal to a ZonelessTimestamp object.