Date and Time Configurations
The Automation1 controller lets you get and set its date, time, and time zone.
On PC-based controllers:
- To get the date and time information, you can use the AeroScript DateTime Functions or the Console commands.
- To set the date and time information, you must use the standard Windows menus.
On Drive-based controllers:
- To get the date and time information, you can use the AeroScript DateTime Functions or the Console commands.
- To set the date and time information, you must use the Console commands.
Getting the Controller Date and Time
To get the date and time of a controller, use the datetime get Console command as follows:
datetime get
This command returns a time string in the sequence of:
[DayOfWeek] [Year] [Month] [Day] [HH:MM:SS] [TimeZone]
Table:
| Argument | Description |
|---|---|
|
[DayOfWeek] |
The name of the day of the week. |
|
[Year] |
The current year. |
|
[Month] |
The current month. |
|
[Day] |
The current day. |
|
[HH:MM:SS] |
The current time with zero-padded values. |
|
[TimeZone] |
The name of the time zone that applies to your current location. |
IMPORTANT: The names of time zones are different between the PC and Drive-based controllers.
To find the time zones that apply to your controllers:
- For PC-based controllers, Windows has a default list of time zones. But this list might change based on the version of Windows that you are using. See Default Time Zones.
- For drive-based controllers, see
Setting the Controller Date and Time
To set the date and time for a drive-based controller, use the datetime set Console command as follows:
WARNING: Use the datetime set Console command with drive-based controllers only. If you try to use it while you are connected to a PC-based controller, that controller returns an error. To set the date and time for a PC-based controller, you must use the standard Windows menus.
To Set the Controller Date and Time to the values that you specify
datetime set timestring month day year [timeZone]
Specify values for the controller date and time arguments that follow:
Table: datetime set Console Command Arguments (Positionals)
| Argument | Description |
|---|---|
|
timestring |
Required text argument. The time to set as a string in the form of hours:minutes:seconds. You must specify the time in 24-hour format. |
|
month |
Required integer argument. The month component of the date to set. It is one based with January as month 1. |
|
day |
Required integer argument. The day component of the date to set. It is one based. |
|
year |
Required integer argument. The year component of the date to set. You must specify a four-digit year. |
|
[timeZone] |
Optional text argument. The name of the time zone for the time that you set. If you do not specify a time zone, the time zone on the controller does not change. If you specify an invalid time zone name for this argument, the drive-based controller returns an error. For information about all the valid time zone names for drive-based controllers, see the Time Zones for Drive-Based Controllers section of this page. |
Time Zones for Drive-Based Controllers
You can set two types of time zones - ones that adjust for Daylight Savings Time and ones that do not.
IMPORTANT: When you use the datetime set Console command, you must supply the time zone name exactly as it appears in the table.
Table: Time Zones That Adjust for Daylight Savings Time
|
Africa/Abidjan |
America/Port-au-Prince |
Asia/Nicosia |
Europe/Minsk |
|
Africa/Accra |
America/Puerto_Rico |
Asia/Omsk |
Europe/Monaco |
|
Africa/Algiers |
America/Punta_Arenas |
Asia/Pyongyang |
Europe/Moscow |
|
Africa/Bissau |
America/Regina |
Asia/Qatar |
Europe/Oslo |
|
Africa/Cairo |
America/Rio_Branco |
Asia/Riyadh |
Europe/Paris |
|
Africa/Casablanca |
America/Santiago |
Asia/Seoul |
Europe/Prague |
|
Africa/Johannesburg |
America/Santo_Domingo |
Asia/Shanghai |
Europe/Riga |
|
Africa/Lagos |
America/Sao_Paulo |
Asia/Singapore |
Europe/Rome |
|
Africa/Maputo |
America/St_Johns |
Asia/Taipei |
Europe/Samara |
|
Africa/Monrovia |
America/Tegucigalpa |
Asia/Tashkent |
Europe/Simferopol |
|
Africa/Nairobi |
America/Tijuana |
Asia/Tbilisi |
Europe/Sofia |
|
Africa/Ndjamena |
America/Toronto |
Asia/Tehran |
Europe/Stockholm |
|
Africa/Sao_Tome |
America/Vancouver |
Asia/Thimphu |
Europe/Tallinn |
|
Africa/Tripoli |
America/Winnipeg |
Asia/Tokyo |
Europe/Tirane |
|
Africa/Tunis |
America/Yellowknife |
Asia/Tomsk |
Europe/Vienna |
|
America/Adak |
Antarctica/Casey |
Asia/Ulaanbaatar |
Europe/Vilnius |
|
America/Anchorage |
Antarctica/Davis |
Asia/Urumqi |
Europe/Warsaw |
|
America/Argentina/Buenos_Aires |
Antarctica/DumontD’Urville |
Asia/Vladivostok |
Europe/Zurich |
|
America/Asuncion |
Antarctica/Macquarie |
Asia/Yakutsk |
Indian/Chagos |
|
America/Bahia_Banderas |
Antarctica/Mawson |
Asia/Yangon |
Indian/Christmas |
|
America/Barbados |
Antarctica/Palmer |
Asia/Yekaterinburg |
Indian/Cocos |
|
America/Belize |
Antarctica/Rothera |
Asia/Yerevan |
Indian/Kerguelen |
|
America/Boa_Vista |
Antarctica/Syowa |
Atlantic/Azores |
Indian/Mahe |
|
America/Bogota |
Antarctica/Troll |
Atlantic/Bermuda |
Indian/Maldives |
|
America/Caracas |
Antarctica/Vostok |
Atlantic/Canary |
Indian/Mauritius |
|
America/Cayenne |
Asia/Almaty |
Atlantic/Cape_Verde |
Indian/Reunion |
|
America/Chicago |
Asia/Amman |
Atlantic/Faroe |
Pacific/Apia |
|
America/Chihuahua |
Asia/Ashgabat |
Atlantic/Reykjavik |
Pacific/Auckland |
|
America/Costa_Rica |
Asia/Atyrau |
Atlantic/South_Georgia |
Pacific/Bougainville |
|
America/Curacao |
Asia/Baghdad |
Atlantic/Stanley |
Pacific/Chatham |
|
America/Denver |
Asia/Baku |
Australia/Adelaide |
Pacific/Chuuk |
|
America/Edmonton |
Asia/Bangkok |
Australia/Brisbane |
Pacific/Easter |
|
America/El_Salvador |
Asia/Beirut |
Australia/Darwin |
Pacific/Efate |
|
America/Fort_Nelson |
Asia/Bishkek |
Australia/Eucla |
Pacific/Enderbury |
|
America/Grand_Turk |
Asia/Brunei |
Australia/Lindeman |
Pacific/Fakaofo |
|
America/Guatemala |
Asia/Colombo |
Australia/Lord_Howe |
Pacific/Fiji |
|
America/Guayaquil |
Asia/Damascus |
Australia/Melbourne |
Pacific/Funafuti |
|
America/Guyana |
Asia/Dhaka |
Australia/Perth |
Pacific/Galapagos |
|
America/Halifax |
Asia/Dili |
Australia/Sydney |
Pacific/Gambier |
|
America/Havana |
Asia/Dubai |
Europe/Amsterdam |
Pacific/Guadalcanal |
|
America/Hermosillo |
Asia/Dushanbe |
Europe/Andorra |
Pacific/Guam |
|
America/Jamaica |
Asia/Famagusta |
Europe/Athens |
Pacific/Honolulu |
|
America/La_Paz |
Asia/Gaza |
Europe/Belgrade |
Pacific/Kiritimati |
|
America/Lima |
Asia/Ho_Chi_Minh |
Europe/Berlin |
Pacific/Majuro |
|
America/Los_Angeles |
Asia/Hong_Kong |
Europe/Brussels |
Pacific/Marquesas |
|
America/Managua |
Asia/Hovd |
Europe/Bucharest |
Pacific/Nauru |
|
America/Martinique |
Asia/Irkutsk |
Europe/Budapest |
Pacific/Niue |
|
America/Mazatlan |
Asia/Jakarta |
Europe/Chisinau |
Pacific/Norfolk |
|
America/Mexico_City |
Asia/Jayapura |
Europe/Copenhagen |
Pacific/Noumea |
|
America/Miquelon |
Asia/Jerusalem |
Europe/Dublin |
Pacific/Pago_Pago |
|
America/Monterrey |
Asia/Kabul |
Europe/Gibraltar |
Pacific/Palau |
|
America/Montevideo |
Asia/Kamchatka |
Europe/Helsinki |
Pacific/Pitcairn |
|
America/Nassau |
Asia/Karachi |
Europe/Istanbul |
Pacific/Pohnpei |
|
America/New_York |
Asia/Kathmandu |
Europe/Kaliningrad |
Pacific/Port_Moresby |
|
America/Noronha |
Asia/Kolkata |
Europe/Kiev |
Pacific/Rarotonga |
|
America/Nuuk |
Asia/Kuala_Lumpur |
Europe/Lisbon |
Pacific/Tahiti |
|
America/Panama |
Asia/Macau |
Europe/London |
Pacific/Tarawa |
|
America/Paramaribo |
Asia/Magadan |
Europe/Luxembourg |
Pacific/Tongatapu |
|
America/Phoenix |
Asia/Makassar |
Europe/Madrid |
Pacific/Wake |
|
America/Port_of_Spain |
Asia/Manila |
Europe/Malta |
Pacific/Wallis |
Table: Time Zones That Do Not Adjust for Daylight Savings Time
|
Etc/UTC |
Etc/GMT-1 |
|
Etc/GMT |
Etc/GMT-2 |
|
Etc/GMT+1 |
Etc/GMT-3 |
|
Etc/GMT+2 |
Etc/GMT-4 |
|
Etc/GMT+3 |
Etc/GMT-5 |
|
Etc/GMT+4 |
Etc/GMT-6 |
|
Etc/GMT+5 |
Etc/GMT-7 |
|
Etc/GMT+6 |
Etc/GMT-8 |
|
Etc/GMT+7 |
Etc/GMT-9 |
|
Etc/GMT+8 |
Etc/GMT-10 |
|
Etc/GMT+9 |
Etc/GMT-11 |
|
Etc/GMT+10 |
Etc/GMT-12 |
|
Etc/GMT+11 |
Etc/GMT-13 |
|
Etc/GMT+12 |
Etc/GMT-14 |
