ClockGetDate
- Last UpdatedOct 29, 2026
- 2 minute read
ClockGetDate is a built-in function that calculates the date that corresponds to a specified number of seconds that have elapsed since 12:00 AM GMT on January 1, 1970.
|
Function |
Group |
Execution |
String Exp. |
Windows |
Windows Embedded |
IoT View |
Thin Clients |
Mobile Access |
|---|---|---|---|---|---|---|---|---|
|
ClockGetDate |
Date and Time |
Synchronous |
Yes |
Supported |
Supported |
Not supported |
Supported |
Executed on Server |
Syntax
ClockGetDate( numSeconds, optTimeZone )
ClockGetDate ( numSeconds { | ,optTimeZone } )
numSeconds
A number of seconds that have elapsed since 12:00 AM GMT on January 1, 1970. This number is typically provided by the function GetClock, but it can be any number.
optTimeZone
A time zone name (string) or index (integer).
|
Value |
Description |
|---|---|
|
-i |
A time zone index (i), up to the maximum index returned by the function GetTimeZoneCount. |
|
0 |
The current time zone in either the project runtime server or the project thin client, depending on where the function is called. This might be different from the current time zone in the local computer's system settings, if the function SetTimeZone was previously executed. |
|
1 |
Coordinated Universal Time (UTC). |
|
2 |
The current time zone in the local computer's system settings. |
|
"timezone" |
The full name of a time zone (for example, "Central Standard Time"). |
This parameter is optional; if no value is specified, the default value is 0.
Returned value
If this function is executed successfully, it returns a string that contains the date that corresponds to the specified number of seconds. If a time zone is specified, the date is adjusted to reflect the difference between the current time zone and the specified time zone.
The date string is formatted according to the current date format. For more information, see About the date format and how to change it.
If this function is not executed successfully โ for example, if the specified time zone is invalid โ it returns a value of 0.
Notes
If this function is called in a project screen on Mobile Access, it is executed using the system clock and date/time settings on the computer that hosts the project runtime server.
Examples
Get the date when the system clock started counting (that is, 01/01/1970):
ClockGetDate(0,"Greenwich Mean Time")
Get a returned value of 04/15/2002:
ClockGetDate(1018886359)
Get the current number of seconds elapsed since 12:00 AM GMT on January 1, 1970, then format that as a date, then adjust it from the current time zone to Central Standard Time:
ClockGetDate(GetClock(),"Central Standard Time")