With ms_nstime2timestr_n() print "ERROR" for NSTERROR and "UNSET" for NSTUNSET

Author: chad-earthscope

ChangeLog

@@ -1,5 +1,6 @@
 2025.233:
 	- Add ms_nstime2timestr_n() with string size limit, deprecate ms_nstime2timestr().
+	- With ms_nstime2timestr_n() print "ERROR" for NSTERROR and "UNSET" for NSTUNSET.
 
 2025.227:
 	- Properly round negative values when converting floats to integers

genutils.c

@@ -1005,6 +1005,18 @@ ms_nstime2timestr_n (nstime_t nstime, char *timestr, size_t timestrsize,
     return NULL;
   }
 
+  if (nstime == NSTERROR)
+  {
+    snprintf (timestr, timestrsize, "ERROR");
+    return timestr;
+  }
+
+  if (nstime == NSTUNSET)
+  {
+    snprintf (timestr, timestrsize, "UNSET");
+    return timestr;
+  }
+
   /* Reduce to Unix/POSIX epoch time and fractional nanoseconds */
   isec = rawisec = MS_NSTIME2EPOCH (nstime);
   nanosec = rawnanosec = (int)(nstime - (isec * NSTMODULUS));

test/test-time.c

@@ -2,7 +2,7 @@
 #include <libmseed.h>
 #include <time.h>
 
-TEST (time, nstime)
+TEST (time, nstime2timestr)
 {
   char timestr[50];
   nstime_t nstime;
@@ -71,7 +71,18 @@ TEST (time, nstime)
   ms_nstime2timestr_n (nstime, timestr, sizeof(timestr), ISOMONTHDAY_Z, MICRO_NONE);
   CHECK_STREQ (timestr, "2004-05-12T07:08:09Z");
 
-  /* Time string variations */
+  /* Unset time */
+  ms_nstime2timestr_n (NSTUNSET, timestr, sizeof(timestr), ISOMONTHDAY_Z, NANO_MICRO_NONE);
+  CHECK_STREQ (timestr, "UNSET");
+
+  /* Error time */
+  ms_nstime2timestr_n (NSTERROR, timestr, sizeof(timestr), ISOMONTHDAY_Z, NANO_MICRO_NONE);
+  CHECK_STREQ (timestr, "ERROR");
+}
+
+TEST (time, timestr2nstime)
+{
+  nstime_t nstime;
 
   nstime = ms_timestr2nstime ("2004");
   CHECK (nstime == 1072915200000000000, "Failed to convert time string: '2004'");