Date/Time Setup

The following FCI commands are found in this chapter:

Command	Description
CH	Get hour.
CM	Get minutes.
CMD	Get day of month.
CO	Get month of the year.
CS	Get seconds.
CT	Get/Set date/time.
CWD	Get day of week.
CY	Get year.
CTZ	Get/Set Timezone.
CLTZ	Get list of Timezones

Table 81: Overview Commands Date/Time Setup

CH Get hour
Description	The CH command is a read only command to get the hour of the current date/time on the USC-Card.
Example	Command	Return	Note
	CH	0:	Get hour.
	CM 12	1:	Read only command. Too many parameters give the error message 1.
Notes	-
Save	N/A
Restriction	None
Errors	•1: Too many parameters

Table 82: CH

CM Get minutes
Description	The CM command is a read only command to get the minutes of the current date/time on the USC-Card.
Example	Command	Return	Note
	CM	0:	Get minutes.
	CM 12	1:	Read only command. Too many parameters give the error message 1.
Notes	-
Save	N/A
Restriction	None
Errors	•1: Too many parameters

Table 83: CM

CMD Get day of month
Description	The CMD command is a read only command to get the day of the month of the current date/time on the USC-Card.
Example	Command	Return	Note
	CMD	0:	Get day of month.
	CMD 12	1:	Read only command. Too many parameters give the error message 1.
Notes	-
Save	N/A
Restriction	None
Errors	•1: Too many parameters

Table 84: CMD

CO Get month of the year
Description	The CO command is a read only command to get the month of the of the current date/time on the USC-Card.
Example	Command	Return	Note
	CO	0:	Get month of year.
	CO 12	1:	Read only command. Too many parameters give the error message 1.
Notes	-
Save	N/A
Restriction	None
Errors	•1: Too many parameters

Table 85: CO

CS Get seconds
Description	The CS command is a read only command to get the seconds of the current date/time on the USC-Card.
Example	Command	Return	Note
	CS	0:	Get seconds.
	CS 12	1:	Read only command. Too many parameters give the error message 1.
Notes	-
Save	N/A
Restriction	None
Errors	•1: Too many parameters

Table 86: CS

CT [<Day> <Month> <Year> <Hour> <Minute> <Second>] Get/Set date/time
Description	Get and set the date and time of the internal clock on the USC-Card. The date/time is given as day month year hour minute second = dd mm yy hh mm ss.
<Day> [optional]	Value: <int>	Function
	empty	Without any parameters: get the date/time information of the clock on the USC card.
	Day [1; 31]	Set the day for the date/time.
<Month> [optional]	Value: <int>	Function
	empty	Without any parameters: get the date/time information of the clock on the USC card.
	Month [1; 12]	Set the month for the date/time.
<Year> [optional]	Value: <int>	Function
	empty	Without any parameters: get the date/time information of the clock on the USC card.
	Year [0; 38]	Set the year for the date/time.
<Hour> [optional]	Value: <int>	Function
	empty	Without any parameters: get the date/time information of the clock on the USC card.
	Hour [0; 23]	Set the hour for the date/time.
<Minute> [optional]	Value: <int>	Function
	empty	Without any parameters: get the date/time information of the clock on the USC card.
	Minute [0; 59]	Set the minutes for the date/time.
<Second> [optional]	Value: <int>	Function
	empty	Without any parameters: get the date/time information of the clock on the USC card.
	Second [0; 59]	Set the seconds for the date/time.
Example	Command	Return	Note
	CT	0:	Get the date/time of the USC card.
	CT 10 5 18 10 29 50	0:	Sets the date time to 10th of May 2018 the time is 10:29:50
Notes	•The range for the year is 0 to 99 which corresponds to the year 2000 to 2099. •For the USC-3, the time zone depends on the SD image: oSD image ≤ 2: Central European Summer Time (CEST). This time zone is a Daylight Saving Time (DST) zone. With DST, the clocks are set forward by one hour in spring and back by one hour in autumn. The one hour time change only takes effect on DateTime objects after a reboot of the USC-3. oSD image ≥ 3: the time zone is set to Greenwich Mean Time (GMT or UTC). This time zone is not a daylight saving time (DST) zone. This is also the case for USC-2 cards. •For the USC-2, the time zone is set to Greenwich Mean Time (GMT). This time zone is not a daylight saving time (DST) zone.
Save	N/A
Restriction	•Set: not allowed during marking
Errors	•1: Too many parameters •2: Too few parameters •5: Not allowed during marking •8: Parameter out of range •17: Wrong parameter type

Table 87: CT

CWD Get day of week
Description	The CWD command is a read only command to get the day of the week of the current date/time on the USC-Card.
Example	Command	Return	Note
	CWD	0:	Get day of week.
	CWD 12	1:	Read only command. Too many parameters give the error message 1.
Notes	-
Save	N/A
Restriction	None
Errors	•1: Too many parameters

Table 88: CWD

CY Get year
Description	The CY command is a read only command to get the year of the current date/time on the USC-Card.
Example	Command	Return	Note
	CY	0:	Get year.
	CY 12	1:	Read only command. Too many parameters give the error message 1.
Notes	-
Save	N/A
Restriction	None
Errors	•1: Too many parameters

Table 89: CY

CTZ Get/Set time zone
Description	Get and set the time zone on the card.
Example	Command	Return	Note
	CTZ	0:	Get time zone.
	CTZ Europe/Berlin	0:	Set the time zone "Europe/Berlin"
Notes	•This command is case-insensitive. •Depending on the selected time zone, winter and summer time is used.
Save	N/A
Restriction	None
Errors	•1: Too many parameters •8: Parameter out of range

Table 90: CTZ

CLTZ Get list of time zones
Description	Get a list of all available time zones of the USC card.
Example	Command	Return	Note
	CLTZ	0:	Get list of timezones
	CTZ 1	1:	Read only command. Too many parameters give the error message 1.
Notes	-
Save	N/A
Restriction	None
Errors	•1: Too many parameters

Table 91: CLTZ