time

type DSTInfo struct {
	Start  time.Time     `json:"start"`
	End    time.Time     `json:"end"`
	Saving time.Duration `json:"saving"`
}

type DSTTransitionInfo struct {
	NextTransition time.Time `json:"next_transition"`
	TransitionType string    `json:"transition_type"` // "enter_dst" or "exit_dst"
	OffsetChange   int       `json:"offset_change"`   // seconds
}

type FormatTimeInput struct {
	Timestamp interface{} `json:"timestamp"` // can be string, int, or time.Time
	Format    string      `json:"format"`
	Timezone  string      `json:"timezone,omitempty"`
}

type FormatTimeResult struct {
	FormattedTime string `json:"formatted_time"`
	Timezone      string `json:"timezone"`
	Format        string `json:"format"`
	UnixTimestamp int64  `json:"unix_timestamp"`
}

type FormatType string

type GetTimeInput struct {
	Timezone string `json:"timezone,omitempty"`
	Format   string `json:"format,omitempty"`
}

type GetTimeResult struct {
	FormattedTime string `json:"formatted_time"`
	Timezone      string `json:"timezone"`
	Format        string `json:"format"`
	UnixTimestamp int64  `json:"unix_timestamp"`
}

type ParseTimeInput struct {
	TimeString string `json:"time_string"`
	Format     string `json:"format,omitempty"`
	Timezone   string `json:"timezone,omitempty"`
}

type ParseTimeResult struct {
	UnixTimestamp int64  `json:"unix_timestamp"`
	RFC3339       string `json:"rfc3339"`
	Timezone      string `json:"timezone"`
	IsDST         bool   `json:"is_dst"`
}

type TimeService interface {
	// GetCurrentTime returns the current time in the specified timezone and format
	GetCurrentTime(input GetTimeInput) (GetTimeResult, error)

	// FormatTime formats a timestamp using the specified format and timezone
	FormatTime(input FormatTimeInput) (FormatTimeResult, error)

	// ParseTime parses a time string and returns timestamp information
	ParseTime(input ParseTimeInput) (ParseTimeResult, error)

	// GetTimezoneInfo returns information about a timezone
	GetTimezoneInfo(input TimezoneInfoInput) (TimezoneInfo, error)

	// ConvertTimezone converts a time from one timezone to another (kept for internal use)
	ConvertTimezone(t time.Time, fromTZ, toTZ string) (time.Time, error)

	// IsFormatSupported checks if a format is supported
	IsFormatSupported(format string) bool

	// GetSupportedFormats returns a list of supported formats
	GetSupportedFormats() []string
}

type TimezoneInfo struct {
	Name          string             `json:"name"`
	Abbreviation  string             `json:"abbreviation"`
	Offset        string             `json:"offset"`
	OffsetSeconds int                `json:"offset_seconds"`
	IsDST         bool               `json:"is_dst"`
	DST           *DSTInfo           `json:"dst,omitempty"`
	DSTTransition *DSTTransitionInfo `json:"dst_transition,omitempty"` // Keep for backward compatibility
}

type TimezoneInfoInput struct {
	Timezone      string    `json:"timezone"`
	ReferenceTime time.Time `json:"reference_time,omitempty"`
}