- Introduction to WorkXpress
- Building Your Application
- Examples and Best Practices
- Technical Manual
The date field stores a date. Internally, the stored value for all date/time fields is a timestamp which equals the number of seconds elapsed from January 1, 1970 to the time specified, which for a date field is 12:00 AM on the day specified. Outwardly, though, it appears as a calendar date. The display of this field is affected by Timezone and Locale settings.
Field features can be edited by clicking on the orange field icon when the presentation layer is displayed.
The date Field has 25 different output formats. The following are examples of output when 09/09/2009 is stored in a date Field:
Though a date is stored internally as a number, when interacting with the Field on a page, you must input a date through the calendar flyout.
The Calendar Flyout
Setting the date is done by clicking on the date part of the Field and clicking on a day from the calendar flyout which will appear.
When setting the Date field through actions, two different input formats may be used. As with other field types, the stored value from another Date field may be used to save into a Date field. Since the stored value for these fields is a timestamp, any timestamp value may also be used to save into a Date field (may be calculated from an expression or extracted from a Date & Time or Time field).
In addition to this, the text output of the Date field (e.g. 04/23/1985) may also be used to save into the Date field. Because of this, you may also construct such a text string and use it to save into the Date field. For instance, if I wanted to set a Date field with a date seven days after the date saved in a different Date field, I could use the arithmetic function to add 7 to the Day of the Month output, and set the mm/dd/yyyy format into the target field.
Ex. Suppose you have a Date field called Task Date and another Date field called Callback Date on an item called Task and you needed to set the callback date to exactly one week after the Task Date. To do this, you could set the expression ${Task - Task Date (Month)}/+=(${Task - Task Date (Day of the Month)}+7)/${Task - Task Date (Year 4 Digit)} into the Callback Date field.
The date field can be filtered with any of the time-type filters.
Date and Time settings should change automatically in non-US countries. For more information, read the Regionalization Field Settings page, or if you need to change your settings manually to simulate being in another country, try out these settings.