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 onthe 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 valueshould 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)}">