Add features

Add utilities
Add Unix method to fetch Unix time as int64

Author: codebyzen

.gitignore

@@ -0,0 +1,2 @@
+.gitignore
+.idea/

go.mod

@@ -1,3 +1,6 @@
 module github.com/codebyzen/lotime
 
+//retract v0.0.6
+//retract v0.0.4
+
 go 1.21

loctime.go

@@ -28,6 +28,10 @@ func SetGlobalTimeZone(name string) error {
 	return nil
 }
 
+func Date(year int, month time.Month, day, hour, minute, second, nSecond int) time.Time {
+	return time.Date(year, month, day, hour, minute, second, nSecond, globalLocation)
+}
+
 // SetFixedTimeZone set timezone to fixed value with specified hours offset
 func SetFixedTimeZone(name string, hours int) {
 	loc := time.FixedZone(name, hours*60*60)
@@ -50,13 +54,45 @@ func Now() time.Time {
 	return time.Now().In(globalLocation)
 }
 
-// Parse parse date string in global timezone
+// Parse date string in global timezone
+//
+//	Year: "2006" "06"
+//	Month: "Jan" "January" "01" "1"
+//	Day of the week: "Mon" "Monday"
+//	Day of the month: "2" "_2" "02"
+//	Day of the year: "__2" "002"
+//	Hour: "15" "3" "03" (PM or AM)
+//	Minute: "4" "04"
+//	Second: "5" "05"
+//	AM/PM mark: "PM"
+//
+// Numeric time zone offsets format as follows:
+//
+//	"-0700"     ±hhmm
+//	"-07:00"    ±hh:mm
+//	"-07"       ±hh
+//	"-070000"   ±hhmmss
+//	"-07:00:00" ±hh:mm:ss
+//
+// Replacing the sign in the format with a Z triggers
+// the ISO 8601 behavior of printing Z instead of an
+// offset for the UTC zone. Thus:
+//
+//	"Z0700"      Z or ±hhmm
+//	"Z07:00"     Z or ±hh:mm
+//	"Z07"        Z or ±hh
+//	"Z070000"    Z or ±hhmmss
+//	"Z07:00:00"  Z or ±hh:mm:ss
 func Parse(layout, value string) (time.Time, error) {
 	mu.RLock()
 	defer mu.RUnlock()
 	return time.ParseInLocation(layout, value, globalLocation)
 }
 
+func Unix() int64 {
+	return int64(Now().UnixNano() / 1e9)
+}
+
 // Location return current timezone
 func Location() *time.Location {
 	mu.RLock()

loctime_test.go

@@ -0,0 +1 @@
+package lotime

utils.go

@@ -0,0 +1,98 @@
+package lotime
+
+import (
+	"fmt"
+	"time"
+)
+
+// GetWeekOfMonth returns the week number as int in month by date
+func GetWeekOfMonth(dt time.Time, isFirstDayMon bool) int {
+	// Get the first day of the month
+	firstDayOfMonth := time.Date(dt.Year(), dt.Month(), 1, 0, 0, 0, 0, dt.Location())
+
+	// Get offset for first weekday
+	adjustedWeekday := 0
+	if isFirstDayMon {
+		adjustedWeekday = (int(firstDayOfMonth.Weekday()) + 6) % 7
+	}
+
+	// Day of month
+	dayOfMonth := dt.Day()
+
+	// Calculate adjusted day
+	adjustedDay := dayOfMonth + adjustedWeekday - 1
+
+	// Calculate week number
+	return (adjustedDay / 7) + 1
+}
+
+// GetDayOfYear return day of year by date
+func GetDayOfYear(year int, month int, day int) int {
+	monthName := time.Month(month)
+	date := time.Date(year, monthName, day, 0, 0, 0, 0, time.UTC)
+	return date.YearDay()
+}
+
+// DateIsPassedInCurrentYear Проверяем, прошла ли дата в текущем году
+func DateIsPassedInCurrentYear(dt time.Time) bool {
+	now := time.Now().Local()
+
+	date := time.Date(now.Year(), dt.Month(), dt.Day(), 0, 0, 0, 0, time.Local)
+
+	if now.After(date) {
+		return true
+	}
+	return false
+}
+
+// DateYearsSince Amount of years since the given date
+func DateYearsSince(dt time.Time) int {
+	now := time.Now()
+
+	years := now.Year() - dt.Year()
+
+	// If current date is before dt by day or month, then year is not complete
+	if now.Month() < dt.Month() || (now.Month() == dt.Month() && now.Day() < dt.Day()) {
+		years--
+	}
+
+	return years
+}
+
+// NthOrLastWeekdayOfMonth Calculate the nth or last weekday of a given month and year.
+func NthOrLastWeekdayOfMonth(year int, month time.Month, userWeekday int, weekNum int, isFirstDayMon bool) (time.Time, error) {
+	if userWeekday < 1 || userWeekday > 7 {
+		return time.Time{}, fmt.Errorf("invalid weekday: %d", userWeekday)
+	}
+	if weekNum < 0 || weekNum > 5 {
+		return time.Time{}, fmt.Errorf("invalid week number: %d", weekNum)
+	}
+
+	targetWeekday := time.Weekday(0)
+	if isFirstDayMon {
+		targetWeekday = time.Weekday(userWeekday % 7) // Sunday=0 ... Saturday=6
+	}
+
+	if weekNum == 0 {
+		// Search for the last weekday of the month
+		firstOfNextMonth := time.Date(year, month+1, 1, 0, 0, 0, 0, time.UTC)
+		lastDayOfMonth := firstOfNextMonth.AddDate(0, 0, -1)
+
+		for lastDayOfMonth.Weekday() != targetWeekday {
+			lastDayOfMonth = lastDayOfMonth.AddDate(0, 0, -1)
+		}
+		return lastDayOfMonth, nil
+	}
+
+	// Search for the nth weekday of the month
+	firstOfMonth := time.Date(year, month, 1, 0, 0, 0, 0, time.UTC)
+	offset := (int(targetWeekday) - int(firstOfMonth.Weekday()) + 7) % 7
+	day := 1 + offset + (weekNum-1)*7
+
+	// Check if the date is valid
+	if day > 31 || time.Date(year, month, day, 0, 0, 0, 0, time.UTC).Month() != month {
+		return time.Time{}, fmt.Errorf("no such weekday occurrence in this month")
+	}
+
+	return time.Date(year, month, day, 0, 0, 0, 0, time.UTC), nil
+}