example CP24Time2a reconstruction

example_test.go

@@ -0,0 +1,40 @@
+package part5_test
+
+import (
+	"io"
+	"log"
+	"os"
+	"testing"
+	"time"
+
+	"github.com/pascaldekloe/part5"
+	"github.com/pascaldekloe/part5/info"
+)
+
+func TestMain(m *testing.M) {
+	// Logging documents intend in examples.
+	// Not interested in the output though.
+	log.SetOutput(io.Discard)
+
+	os.Exit(m.Run())
+}
+
+// Time tag reconstruction with some leeway comes recommended.
+func ExampleCP24Time2a_WithinHourBefore() {
+	m := part5.NewMonitor[info.Cause8, info.ComAddr16, info.Addr16]()
+
+	// Listener to short floating-points with time tag.
+	m.FloatWithTime = func(u info.DataUnit[info.Cause8, info.ComAddr16, info.Addr16],
+		addr info.Addr16, f float32, q info.Qual, tag part5.CP24Time2a) {
+		// The time tag is relative to the now.
+		received := time.Now()
+
+		// Allow up to 5 seconds into the future to
+		// account for time synchronisation issues.
+		const leeway = 5 * time.Second
+
+		t := tag.WithinHourBefore(received.Add(leeway))
+		log.Println("timestamp reconstructed to", t)
+	}
+	// Output:
+}