@rivascva/dt-idl 1.1.184 → 1.1.186

package/go/models/constants.go

@@ -1,5 +1,7 @@
 package models
 
+import "time"
+
 // ContextKey is a type used to define keys for a request context.
 type ContextKey string
 
@@ -34,4 +36,6 @@ const (
 	// MarketCloseTime is the closing time of the market in a 24-hour format (HH:mm).
 	// Based on the timezone specified in MarketTimezone.
 	MarketCloseTime = "16:00"
+	// MarketCloseGracePeriod is a grace period added after the official close time to allow in-flight operations to finish.
+	MarketCloseGracePeriod = 45 * time.Second
 )

package/go/utils/market.go

@@ -0,0 +1,78 @@
+package utils
+
+import (
+	"fmt"
+	"slices"
+	"strconv"
+	"strings"
+	"time"
+
+	"github.com/RivasCVA/dt-idl/go/models"
+)
+
+// IsMarketHours determines if the given time falls within the preset market hours.
+func IsMarketHours(now time.Time) (bool, error) {
+	return isMarketHoursWithOpenAndCloseOffsets(now, 0, 0)
+}
+
+// IsMarketHoursWithCloseGracePeriod determines if the given time falls within the preset market hours with a close grace period added after the official close time.
+// This is useful for in-flight operations to complete after the market officially closes.
+func IsMarketHoursWithCloseGracePeriod(now time.Time) (bool, error) {
+	return isMarketHoursWithOpenAndCloseOffsets(now, 0, models.MarketCloseGracePeriod)
+}
+
+// isMarketHoursWithOpenAndCloseOffsets determines if the given time falls within the preset market hours.
+// The given open and close offsets are used as buffer window on market open and close:
+//
+// - If the open offset is 5 seconds and the market opens at 9:30:00:
+//   - The function will only return true if the current time is 9:30:05 or later
+//
+// - If the close offset is 20 seconds and the market closes at 16:00:00:
+//   - The function will only return true if the current time is 16:00:20 or earlier
+func isMarketHoursWithOpenAndCloseOffsets(now time.Time, openOffset time.Duration, closeOffset time.Duration) (bool, error) {
+	// load the market timezone
+	loc, err := time.LoadLocation(models.MarketTimezone)
+	if err != nil {
+		return false, fmt.Errorf("unable to load the market timezone: %w", err)
+	}
+
+	// convert the now time to the market timezone
+	now = now.In(loc)
+
+	// check if on weekend
+	if slices.Contains([]time.Weekday{time.Saturday, time.Sunday}, now.Weekday()) {
+		return false, nil
+	}
+
+	// parse the open time
+	openTimeParts := strings.Split(models.MarketOpenTime, ":")
+	openHour, err := strconv.Atoi(openTimeParts[0])
+	if err != nil {
+		return false, fmt.Errorf("unable to parse the open hour: %w", err)
+	}
+	openMinute, err := strconv.Atoi(openTimeParts[1])
+	if err != nil {
+		return false, fmt.Errorf("unable to parse the open minute: %w", err)
+	}
+
+	// parse the close time
+	closeTimeParts := strings.Split(models.MarketCloseTime, ":")
+	closeHour, err := strconv.Atoi(closeTimeParts[0])
+	if err != nil {
+		return false, fmt.Errorf("unable to parse the close hour: %w", err)
+	}
+	closeMinute, err := strconv.Atoi(closeTimeParts[1])
+	if err != nil {
+		return false, fmt.Errorf("unable to parse the close minute: %w", err)
+	}
+
+	// create the open time with the offset
+	openTime := time.Date(now.Year(), now.Month(), now.Day(), openHour, openMinute, 0, 0, loc)
+	openWithOffset := openTime.Add(openOffset)
+
+	// create the close time with the offset
+	closeTime := time.Date(now.Year(), now.Month(), now.Day(), closeHour, closeMinute, 0, 0, loc)
+	closeWithOffset := closeTime.Add(closeOffset)
+
+	return !now.Before(openWithOffset) && !now.After(closeWithOffset), nil
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rivascva/dt-idl",
-  "version": "1.1.184",
+  "version": "1.1.186",
   "description": "Dream Trade - Interface Definition Language",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",