fixed DateTime_get bugs and added FMT_DateTime

include/tlibc/time.h

@@ -29,18 +29,18 @@ void sleepMsec(msec_t time);
 
 
 typedef struct Time {
-    i32 nsec;
-    i8  sec;
-    i8  min;
-    i8  hour;
+    i32 nsec;   /* 0..999_999_999  */
+    i8  sec;    /* 0..60 leap second??? */
+    i8  min;    /* 0..59 */
+    i8  hour;   /* 0..23 */
 } Time;
 
 typedef struct Date {
-    i8  month_day;
-    i8  month;
-    i16 year;
-    i8  week_day;
-    i16 year_day;
+    i8  month_day;  /* 1..31 */
+    i8  month;      /* 1..12 */
+    i16 year;       /* 1900-xxxx */
+    i8  week_day;   /* 1..7 */
+    i16 year_day;   /* 1..366 */
 } Date;
 
 typedef struct DateTime {
@@ -52,6 +52,19 @@ void DateTime_get(DateTime* dt, bool utc_time);
 static inline void DateTime_getLocal(DateTime* dt) { DateTime_get(dt, false); }
 static inline void DateTime_getUTC(DateTime* dt) { DateTime_get(dt, true); }
 
+// yyyy.MM.dd_HH-mm-ss
+#define FMT_DateTime_fileName "%04i.%02i.%02i_%02i-%02i-%02i"
+// yyyy.MM.dd HH:mm:ss
+#define FMT_DateTime_text "%04i.%02i.%02i %02i:%02i:%02i"
+/* 
+USAGE:
+    DateTime dt;
+    DateTime_getLocal(&dt);
+    printf(FMT_DateTime_text, DT_expand(dt));
+*/
+#define DT_expand(dt) dt.d.year, dt.d.month, dt.d.month_day, dt.t.hour, dt.t.min, dt.t.sec
+
+
 #if __cplusplus
 }
 #endif