setDateTime
Creates a new variable holding a DateTime value representing a specified date and time.
Attributes
var | ||
---|---|---|
Required | Value type | EL-evaluated |
Yes | String | No |
Name of the variable that holds the created DateTime value. |
timeZone | ||
---|---|---|
Required | Value type | EL-evaluated |
No | String | Yes |
This attribute can be used to specify a time zone for the created DateTime value. The resolved String should be a time zone name such as "Europe/London", "America/New_York" or "Etc/GMT+2". If not defined, the created DateTime will use the current user's time zone. |
year | ||
---|---|---|
Required | Value type | EL-evaluated |
No | Number | Yes |
Specifies the created DateTime value's year. If not defined, the created DateTime represents the current year. |
month | ||
---|---|---|
Required | Value type | EL-evaluated |
No | Number | Yes |
Specifies the created DateTime value's month. The resolved value is expected to be an integer from 1 (January) to 12 (December). If not defined, the created DateTime represents the current month. |
day | ||
---|---|---|
Required | Value type | EL-evaluated |
No | Number | Yes |
Specifies the created DateTime value's day. The resolved value is expected be an integer specifying the day within its month, so from 1 to 28, 30 or 31, depending on the month. If not defined, the created DateTime represents the current day. |
hour | ||
---|---|---|
Required | Value type | EL-evaluated |
No | Number | Yes |
Specifies the created DateTime value's hour. The resolved value should be an integer from 0 to 23. If not defined, the created DateTime represents the current hour. |
minute | ||
---|---|---|
Required | Value type | EL-evaluated |
No | Number | Yes |
Specifies the created DateTime value's minute. The resolved value should be an integer from 0 to 59. If not defined, the created DateTime represents the current minute. |
second | ||
---|---|---|
Required | Value type | EL-evaluated |
No | Number | Yes |
Specifies the created DateTime value's second. The resolved value should be an integer from 0 to 59. If not defined, the created DateTime represents the current second. |
Examples
The setDateTime
command works exactly like setDate, but with the additional time components. So, to create a DateTime representing the exact moment the command is evaluated, only define the var
attribute:
<setDateTime var="rightNow">
The methods of DateTime values can be used to create more or less altered versions of the base value. To create a DateTime 5 minutes ahead, for example, there is the plusMinutes()
method:
<set var="in5Mins" value="${rightNow.plusMinutes(5)}">