Date & Time Variables
Documentation on using date and time replacement variables in HS4Touch. See Replacement Variables for information on all replacement variables.
Overview
HSTouch includes a built-in function to display the current date and time. To use this function, simply add a text element to the screen and enter the appropriate date and time variables in that element's text property (as shown below).
Standard Date and Time Variables
Use the standard date and time variables to display date and time as shown below.
Variable | Display |
|---|---|
[$DATETIME]: | 10/4/2008 12:51:30 PM |
[$DATE]: | October 4 2008 |
[$TIME]: | 12:51 PM |
Custom Date and Time Variables and Formats
To customize the format of the date or time displayed, use these variables with the appropriate characters listed in the table below.
- [$DATE=dd MM yy] (where dd=day, MM=month, yy=year)
- [$TIME=hh:mm tt] (where hh=hour, mm=minute, tt=AM/PM)
Note: When using custom formats, it makes no difference which variable you use [$DATETIME], [$DATE], or [$TIME] as they will all display the same thing. You can mix formats specifiers to display the date and time such as: [$DATE] [$TIME].
Custom Format Characters
| Character | Description |
|---|---|
(:) | Time separator. In some locales, other characters may be used to represent the time separator. The time separator separates hours, minutes, and seconds when time values are formatted. The actual character used as the time separator in formatted output is determined by your application's current culture value. |
(/) | Date separator. In some locales, other characters may be used to represent the date separator. The date separator separates the day, month, and year when date values are formatted. The actual character used as the date separator in formatted output is determined by your application's current culture. |
(%) | Used to indicate that the following character should be read as a single-letter format without regard to any trailing letters. Also used to indicate that a single-letter format is read as a user-defined format. See below for further details. |
d | Displays the day as a number without a leading zero (for example, 1). Use %d if this is the only character in your user-defined numeric format. |
dd | Displays the day as a number with a leading zero (for example, 01). |
ddd | Displays the day as an abbreviation (for example, Sun). |
dddd | Displays the day as a full name (for example, Sunday). |
M | Displays the month as a number without a leading zero (for example, January is represented as 1). Use %M if this is the only character in your user-defined numeric format. |
MM | Displays the month as a number with a leading zero (for example, 01/12/01). |
MMM | Displays the month as an abbreviation (for example, Jan). |
MMMM | Displays the month as a full month name (for example, January). |
gg | Displays the period/era string (for example, A.D.). |
h | Displays the hour as a number without leading zeros using the 12-hour clock (for example, 1:15:15 PM). Use %h if this is the only character in your user-defined numeric format. |
hh | Displays the hour as a number with leading zeros using the 12-hour clock (for example, 01:15:15 PM). |
H | Displays the hour as a number without leading zeros using the 24-hour clock (for example, 1:15:15). Use %H if this is the only character in your user-defined numeric format. |
HH | Displays the hour as a number with leading zeros using the 24-hour clock (for example, 01:15:15). |
m | Displays the minute as a number without leading zeros (for example, 12:1:15). Use %m if this is the only character in your user-defined numeric format. |
mm | Displays the minute as a number with leading zeros (for example, 12:01:15). |
s | Displays the second as a number without leading zeros (for example, 12:15:5). Use %s if this is the only character in your user-defined numeric format. |
ss | Displays the second as a number with leading zeros (for example, 12:15:05). |
t | Uses the 12-hour clock and displays an uppercase A for any hour before noon; displays an uppercase P for any hour between noon and 11:59 P.M. Use %t if this is the only character in your user-defined numeric format. |
tt | For locales that use a 12-hour clock, displays an uppercase AM with any hour before noon; displays an uppercase PM with any hour between noon and 11:59 P.M. For locales that use a 24-hour clock, displays nothing. |
y | Displays the year number (0-9) without leading zeros. Use %y if this is the only character in your user-defined numeric format. |
yy | Displays the year in two-digit numeric format with a leading zero, if applicable. |
yyy | Displays the year in four-digit numeric format. |
yyyy | Displays the year in four-digit numeric format. |
z | Displays the timezone offset without a leading zero (for example, -8). Use %z if this is the only character in your user-defined numeric format. |
zz | Displays the timezone offset with a leading zero (for example, -08). |
zzz | Displays the full timezone offset (for example, -08:00). |
Examples
| Format | Display |
|---|---|
d-MMM | 7-Dec |
d-MMMM-yy | 7-December-58 |
d MMMM | 7 December |
MMMM yy | December 58 |
hh:mm tt | 08:50 PM |
h:mm:ss t | 8:50:35 P |
H:mm | 20:50 |
H:mm:ss | 20:50:35 |
M/d/yyyy H:mm | 12/7/1958 20:50 |