El package date contains the group of functions for the data treatment which includes the managing of the sql date, time and timestamp types. It has several dates builders for the differents subtypes of data which includes the management of the time zone. The following table shows the builders for the differents types of date objects with examples of its utilization.

1 Xsql date


The examples have been represented in a server located in Barcelona [CET] and therefore it is executed in the time zone GMT+1 which corresponds to a offset timezone of 3600000 milliseconds. So, 12:16 in Barcelona will correspond to 11:16 in London [GMT]. In the example, we can see how 12:16 in London is visualized in a server which is being executed in Barcelona as 13:16. It means that all the examples shows the date in GMT+1.

Builders date type
Builder Resulting type Examples
date java.util.Date

<date dd='12' MM='10' yy='2005' />


<date format='dd-MM-yyyy'>12-10-2005</date>


date.time java.sql.Time

<date.time hh='12' mm='16' ss='55' />


<date.time hh='12' mm='16' ss='55' Z='0'/>


<date.time format='HH:mm:ss'>12:16:55</date.time>




date.timestamp java.sql.Timestamp

<date.timestamp dd='12' MM='10' yy='2005' hh='12' mm='16' ss='55' />

2005-10-12 12:16:55.0

<date.timestamp dd='12' MM='10' yy='2005' hh='12' mm='16' ss='55' Z='0'/>

2005-10-12 13:16:55.0

<date.timestamp dd='12' MM='10' yy='2005' Z='0' />

2005-10-12 01:00:00.0

<date.timestamp dd='12' MM='10' yy='2005' Z='3600000' />

2005-10-12 00:00:00.0

<date.timestamp dd='12' MM='10' yy='2005' Z='-3600000' />

2005-10-12 02:00:00.0

<date.timestamp format='dd-MM-yyyy HH:mm:ss'>12-10-2005 12:16:55</date.timestamp>

2005-10-12 12:16:55.0

<date.timestamp>12-10-2005 12:16:55</date.timestamp>

2005-10-12 12:16:55.0

date.mdy java.sql.Date



date.today java.sql.Date

<date.today />


date.current java.sql.Timestamp

<date.current />

2006-06-30 13:04:55.343

XSQL-Script follows the same agreement for the date and time formats which can be founded in the java.text.SimpleDateFormat type. The date and time formats can use a format to be built or converted. With this formats, the characters of 'A' to 'Z' and of 'a' to 'z' are interpreted as representations of components of the time in a date or time string.

The patterns of date and time in the format attribute.
Letter Date and time component Presentation Examples
G Era designador Text AD
yyyy; yy Year Year 1996; 96
M; MMM; MM Month of the year Month July; Jul; 07
w Week of the year Number 27
W Week of the month Number 2
D Day of the year Number 189
d; dd Day of the month Number 8; 08
F Day of the week in a month Number 2
E Day of the week Text Tuesday; Tue
a Marker AM/PM Text PM
H; HH Time of day (0-23) Number 0; 00
k Time of day (1-24) Number 24
K Time in AM/PM (0-11) Number 0
h Time in AM/PM (1-12) Number 12
m Minute of the hour Number 30
s Second of the minute Number 55
S Millisecond Number 978
z Time zone General Time Zone Pacific Standard Time; PST; GMT-08:00
Z Time zone Time zone RFC 822 -0800