Date And Time Property Type
The date and time property type stores a value consisting of a calendar date and time of day. This value is stored internally as the number of seconds before or after the Agentry epoch date of January 1st, 2001 12:00:00 am. Negative values reflect dates prior to epoch. A date and time property is displayed on the Agentry Client in the format MM/DD/YYYY HH:MM:SS am/pm by default.
A date and time property may contain an unset or invalid value. This is indicated by the year portion of the value, which is set to the year zero (0000). This condition may be checked to determine if the date and time property is invalid.
Date And Time Property Attributes
- Name: This is the unique identifier for the property definition. This value must be unique among all properties within the same parent definition.
- Display Name: This attribute sets the default display name to label or otherwise identify the property value on the Agentry Client. This will also be the default label for any screen control that displays this property.
- Blank: This attribute specifies whether or not to display a blank field when the date and time property does not contain a valid date and time (year is 0000).
- Display Order: This attribute specifies the order in which to display the date and time components of the property value. This may be set to either “Date - Time” or “Time - Date”.
- Time Zone Adjust: This attribute specifies whether or not to adjust the date and time value of the property during synchronization based on differences in time zones. For object properties the value retrieved from the back end system may be adjusted from the back end systems local or standard time, or from universal time, to the client device’s time zone. For transaction properties the date and time value can be adjusted from the client device’s time zone to the local or standard time of the system connection or to universal time. The default for this attribute is “Do not adjust”, which will not modify the date and time value during synchronization.