A2osX/SYS/KERNEL.S.TIME.txt

NEW
  AUTO 3,1
*/--------------------------------------
* # Time
* Get System Time in Buffer
* ## C
* `void time (struct tm* timeptr);`
* ## ASM
* `>PUSHW timer`
* `>SYSCALL time`
* ## RETURN VALUE
* S.TIME filled with System date/time
*\--------------------------------------
K.Time			>PULLW FORPNT
				>MLICALL MLI.GETTIME
				>LDYAI GP.DATE
				>STYA TXTPTR
				ldx #_PTime2Time
				jmp JMP.X
*/--------------------------------------
* # StrFTime
* ## C
* Convert S.TIME struct to CSTR
* `void strftime (char* str, const char* format, const struct tm* timeptr );`
* ## ASM
* `>PUSHW str`
* `>PUSHW format`
* + %a : Abbreviated weekday name : Thu
* + %A : Full weekday name : Thursday 
* + %b : Abbreviated month name : Aug 
* + %B : Full month name : August 
* + %d : Day of the month, zero-padded (01-31)
* + %H : Hour in 24h format (00-23) 14 
* + %I : Hour in 12h format (01-12) 02 
* + %m : Month as a decimal number (01-12) 08 
* + %M : Minute (00-59) 55 
* + %p : AM or PM designation PM 
* + %S : Second (00-61) 02 
* + %w : Weekday as a decimal number with Sunday as 0 (0-6) 
* + %y : Year, last two digits (00-99)
* + %Y : Year four digits 2001 
* `>PUSHW timeptr`
* `>SYSCALL strftime`
* ## RETURN VALUE
*   none. always succeed.
*\--------------------------------------
K.StrFTime		>PULLW ZPPtr3			S.TIME
				>PULLW TXTPTR			format
				>PULLW FORPNT			str
				jmp JMP.X
*/--------------------------------------
* # PTime2Time
*  Convert ProDOS Time To S.TIME
* ## C
* `void PTime2Time (long* ptime, const struct tm* timeptr );`
* ## ASM
* `>PUSHW ptime`
* `>PUSHW timer`
* `>SYSCALL PTime2Time`
* ## RETURN VALUE
*\--------------------------------------
K.PTime2Time	.EQ JMP.X2

*				>PULLW FORPNT			S.TIME
*				>PULLW TXTPTR			ptime
*				jmp JMP.X
*/--------------------------------------
* # CTime2Time
*  Convert CTime Time To S.TIME
* ## C
* `void CTime2Time (long* ctime, const struct tm* timeptr );`
* ## ASM
* `>PUSHW ctime`
* `>PUSHW timer`
* `>SYSCALL CTime2Time`
* ## RETURN VALUE
*\--------------------------------------
K.CTime2Time	.EQ JMP.X2

*				>PULLW FORPNT			S.TIME
*				>PULLW TXTPTR			ctime
*				jmp JMP.X
*--------------------------------------
MAN
SAVE usr/src/sys/kernel.s.time
LOAD usr/src/sys/kernel.s
ASM
-												Kernel 0.9.1 : Move To S-C MASM 3.0
											
										
										
											2017-12-22 21:24:30 +00:00
+								NEW
-												Kernel 0.93
											
										
										
											2019-05-25 19:24:07 +00:00
+								  AUTO 3,1
-												Kernel 0.9.1 : Code reorganization & move to CSTR (LS & many API bug fixes)
											
										
										
											2017-09-22 15:25:21 +00:00
+								*/--------------------------------------
-												Kernel 0.9.2
											
										
										
											2018-06-18 06:22:50 +00:00
+								* # Time
 								* Get System Time in Buffer
-												Kernel 0.9.2
											
										
										
											2018-06-18 08:44:02 +00:00
+								* ## C
-												SH:new ALIAS cmd, new && operator
MKDIR:completely implemented
LS/RM/MV/CP: combined switches
KERNEL:SList API now handle options to handle several languages/parsers

											
										
										
											2022-10-07 19:21:37 +00:00
+								* `void time (struct tm* timeptr);`
-												Kernel 0.9.2
											
										
										
											2018-10-04 15:30:14 +00:00
+								* ## ASM
-												Kernel 0.93++
											
										
										
											2020-01-18 19:37:32 +00:00
+								* `>PUSHW timer`
-												Kernel 0.9.2
											
										
										
											2018-10-11 15:23:06 +00:00
+								* `>SYSCALL time`
 								* ## RETURN VALUE
-												Kernel 0.9.2
											
										
										
											2018-06-18 06:22:50 +00:00
+								* S.TIME filled with System date/time
-												Kernel 0.9.1 : Code reorganization & move to CSTR (LS & many API bug fixes)
											
										
										
											2017-09-22 15:25:21 +00:00
+								*\--------------------------------------
-												Kernel 0.93++
											
										
										
											2020-01-18 19:37:32 +00:00
+								K.Time			>PULLW FORPNT
-												ProDOS.FX 8M (required for KRNL8M)

											
										
										
											2023-11-04 14:42:28 +00:00
+												>MLICALL MLI.GETTIME
 												>LDYAI GP.DATE
-												Kernel 0.93++
											
										
										
											2020-01-18 19:37:32 +00:00
+												>STYA TXTPTR
-												KERNEL:bugfix for ReadDir on directory blocks filled by deleted entries

											
										
										
											2024-02-03 07:25:29 +00:00
+												ldx #_PTime2Time
-												PRODOS.FX : major bug removed

											
										
										
											2023-11-12 13:20:15 +00:00
+												jmp JMP.X
-												Kernel 0.9.1 : Code reorganization & move to CSTR
											
										
										
											2017-08-24 06:47:31 +00:00
+								*/--------------------------------------
 								* # StrFTime
-												Kernel 0.9.2
											
										
										
											2018-06-18 06:22:50 +00:00
+								* ## C
-												Kernel 0.9.1 : Code reorganization & move to CSTR
											
										
										
											2017-08-24 06:47:31 +00:00
+								* Convert S.TIME struct to CSTR
-												SH:new ALIAS cmd, new && operator
MKDIR:completely implemented
LS/RM/MV/CP: combined switches
KERNEL:SList API now handle options to handle several languages/parsers

											
										
										
											2022-10-07 19:21:37 +00:00
+								* `void strftime (char* str, const char* format, const struct tm* timeptr );`
-												Kernel 0.9.2
											
										
										
											2018-06-18 06:22:50 +00:00
+								* ## ASM
-												Kernel 0.93++
											
										
										
											2020-01-21 11:06:59 +00:00
+								* `>PUSHW str`
-												Kernel 0.93++
											
										
										
											2020-01-18 19:37:32 +00:00
+								* `>PUSHW format`
-												Kernel 0.9.2
											
										
										
											2018-06-18 08:44:02 +00:00
+								* + %a : Abbreviated weekday name : Thu
 								* + %A : Full weekday name : Thursday
 								* + %b : Abbreviated month name : Aug
 								* + %B : Full month name : August
 								* + %d : Day of the month, zero-padded (01-31)
 								* + %H : Hour in 24h format (00-23) 14
 								* + %I : Hour in 12h format (01-12) 02
 								* + %m : Month as a decimal number (01-12) 08
 								* + %M : Minute (00-59) 55
 								* + %p : AM or PM designation PM
 								* + %S : Second (00-61) 02
 								* + %w : Weekday as a decimal number with Sunday as 0 (0-6)
 								* + %y : Year, last two digits (00-99)
 								* + %Y : Year four digits 2001
-												Kernel 0.93++
											
										
										
											2020-01-20 07:23:51 +00:00
+								* `>PUSHW timeptr`
-												Kernel 0.9.2
											
										
										
											2018-10-11 15:23:06 +00:00
+								* `>SYSCALL strftime`
 								* ## RETURN VALUE
-												Kernel 0.9.1 : Code reorganization & move to CSTR
											
										
										
											2017-08-24 06:47:31 +00:00
+								*   none. always succeed.
 								*\--------------------------------------
-												Kernel 0.93++
											
										
										
											2020-01-21 11:06:59 +00:00
+								K.StrFTime		>PULLW ZPPtr3			S.TIME
 												>PULLW TXTPTR			format
 												>PULLW FORPNT			str
-												PRODOS.FX : major bug removed

											
										
										
											2023-11-12 13:20:15 +00:00
+												jmp JMP.X
-												Kernel 0.93++
											
										
										
											2020-01-21 07:34:32 +00:00
+								*/--------------------------------------
 								* # PTime2Time
 								*  Convert ProDOS Time To S.TIME
 								* ## C
-												SH:new ALIAS cmd, new && operator
MKDIR:completely implemented
LS/RM/MV/CP: combined switches
KERNEL:SList API now handle options to handle several languages/parsers

											
										
										
											2022-10-07 19:21:37 +00:00
+								* `void PTime2Time (long* ptime, const struct tm* timeptr );`
-												Kernel 0.93++
											
										
										
											2020-01-21 07:34:32 +00:00
+								* ## ASM
 								* `>PUSHW ptime`
 								* `>PUSHW timer`
 								* `>SYSCALL PTime2Time`
 								* ## RETURN VALUE
 								*\--------------------------------------
-												PRODOS.FX : major bug removed

											
										
										
											2023-11-12 13:20:15 +00:00
+								K.PTime2Time	.EQ JMP.X2
-												Kernel 0.94++
											
										
										
											2021-05-09 12:39:40 +00:00
 								*				>PULLW FORPNT			S.TIME
 								*				>PULLW TXTPTR			ptime
-												PRODOS.FX : major bug removed

											
										
										
											2023-11-12 13:20:15 +00:00
+								*				jmp JMP.X
-												Kernel 0.93++
											
										
										
											2020-01-21 07:34:32 +00:00
+								*/--------------------------------------
 								* # CTime2Time
 								*  Convert CTime Time To S.TIME
 								* ## C
-												SH:new ALIAS cmd, new && operator
MKDIR:completely implemented
LS/RM/MV/CP: combined switches
KERNEL:SList API now handle options to handle several languages/parsers

											
										
										
											2022-10-07 19:21:37 +00:00
+								* `void CTime2Time (long* ctime, const struct tm* timeptr );`
-												Kernel 0.93++
											
										
										
											2020-01-21 07:34:32 +00:00
+								* ## ASM
 								* `>PUSHW ctime`
 								* `>PUSHW timer`
 								* `>SYSCALL CTime2Time`
 								* ## RETURN VALUE
 								*\--------------------------------------
-												PRODOS.FX : major bug removed

											
										
										
											2023-11-12 13:20:15 +00:00
+								K.CTime2Time	.EQ JMP.X2
-												Kernel 0.94++
											
										
										
											2021-05-09 12:39:40 +00:00
 								*				>PULLW FORPNT			S.TIME
 								*				>PULLW TXTPTR			ctime
-												PRODOS.FX : major bug removed

											
										
										
											2023-11-12 13:20:15 +00:00
+								*				jmp JMP.X
-												Kernel 0.9.1 : Code reorganization & move to CSTR
											
										
										
											2017-08-24 06:47:31 +00:00
+								*--------------------------------------
-												TODO:Time API (developers wanted, i said ;-)
											
										
										
											2016-08-30 20:26:19 +00:00
+								MAN
-												Kernel 0.94+
											
										
										
											2020-12-15 13:23:22 +00:00
+								SAVE usr/src/sys/kernel.s.time
 								LOAD usr/src/sys/kernel.s
-												TODO:Time API (developers wanted, i said ;-)
											
										
										
											2016-08-30 20:26:19 +00:00
+								ASM