feat(quando-5ol): implement format presets and constants
Add Format type with preset constants (ISO, EU, US, Long, RFC2822) and Format() method for convenient date formatting. Key features: - Type-safe Format enum with 5 preset formats - ISO (2026-02-09), EU (09.02.2026), US (02/09/2026) - Long format with i18n support (EN: "February 9, 2026", DE: "9. Februar 2026") - RFC2822 email format - Language-independent formats (ISO, EU, US, RFC2822) ignore Lang setting - Language-dependent Long format respects WithLang() Implementation: - format.go: Format type, constants, Format() method, formatLong() helper - format_test.go: 26 tests covering all formats, edge cases, immutability - example_test.go: 8 example functions demonstrating usage Performance (exceeds targets): - ISO/EU/US: ~90 ns (target: <5 µs) - RFC2822: ~207 ns (target: <5 µs) - Long EN/DE: ~270 ns (target: <10 µs) All tests pass with comprehensive coverage of leap years, month boundaries, and language dependency.
This commit is contained in:
parent
8c9e0e725a
commit
06ad5d67d3
4 changed files with 506 additions and 1 deletions
152
format.go
Normal file
152
format.go
Normal file
|
|
@ -0,0 +1,152 @@
|
|||
package quando
|
||||
|
||||
import (
|
||||
"fmt"
|
||||
"time"
|
||||
)
|
||||
|
||||
// Format represents a preset date format for use with the Format method.
|
||||
// Each format produces a different string representation of a date.
|
||||
//
|
||||
// Language Dependency:
|
||||
// - ISO, EU, US, RFC2822: Always language-independent
|
||||
// - Long: Uses the Date's Lang setting for month and weekday names
|
||||
//
|
||||
// Example:
|
||||
//
|
||||
// date := quando.From(time.Date(2026, 2, 9, 12, 30, 45, 0, time.UTC))
|
||||
// iso := date.Format(quando.ISO) // "2026-02-09"
|
||||
// long := date.Format(quando.Long) // "February 9, 2026" (EN)
|
||||
// longDE := date.WithLang(quando.DE).Format(quando.Long) // "9. Februar 2026"
|
||||
type Format int
|
||||
|
||||
const (
|
||||
// ISO represents the ISO 8601 date format: "2026-02-09" (YYYY-MM-DD).
|
||||
// This format is always language-independent and is the standard international format.
|
||||
ISO Format = iota
|
||||
|
||||
// EU represents the European date format: "09.02.2026" (DD.MM.YYYY).
|
||||
// This format is always language-independent and uses dots as separators.
|
||||
// Common in Germany, Austria, Switzerland, and many other European countries.
|
||||
EU
|
||||
|
||||
// US represents the US date format: "02/09/2026" (MM/DD/YYYY).
|
||||
// This format is always language-independent and uses slashes as separators.
|
||||
// Common in the United States and some other countries.
|
||||
US
|
||||
|
||||
// Long represents a human-readable long format with full month name.
|
||||
// This format is language-dependent and uses the Date's Lang setting.
|
||||
//
|
||||
// Examples:
|
||||
// - EN: "February 9, 2026"
|
||||
// - DE: "9. Februar 2026"
|
||||
//
|
||||
// The format varies by language to match local conventions.
|
||||
Long
|
||||
|
||||
// RFC2822 represents the RFC 2822 email date format.
|
||||
// Example: "Mon, 09 Feb 2026 12:30:45 +0000"
|
||||
// This format is always language-independent and includes time and timezone.
|
||||
RFC2822
|
||||
)
|
||||
|
||||
// Format formats the date using the specified preset format.
|
||||
//
|
||||
// Supported formats:
|
||||
// - ISO: "2026-02-09" (YYYY-MM-DD)
|
||||
// - EU: "09.02.2026" (DD.MM.YYYY)
|
||||
// - US: "02/09/2026" (MM/DD/YYYY)
|
||||
// - Long: "February 9, 2026" (language-dependent)
|
||||
// - RFC2822: "Mon, 09 Feb 2026 12:30:45 +0000"
|
||||
//
|
||||
// The Long format respects the Date's Lang setting:
|
||||
// - EN: "February 9, 2026"
|
||||
// - DE: "9. Februar 2026"
|
||||
//
|
||||
// All other formats are language-independent.
|
||||
//
|
||||
// Example:
|
||||
//
|
||||
// date := quando.From(time.Date(2026, 2, 9, 12, 30, 45, 0, time.UTC))
|
||||
// fmt.Println(date.Format(quando.ISO)) // "2026-02-09"
|
||||
// fmt.Println(date.Format(quando.EU)) // "09.02.2026"
|
||||
// fmt.Println(date.Format(quando.US)) // "02/09/2026"
|
||||
// fmt.Println(date.Format(quando.Long)) // "February 9, 2026"
|
||||
// fmt.Println(date.Format(quando.RFC2822)) // "Mon, 09 Feb 2026 12:30:45 +0000"
|
||||
func (d Date) Format(format Format) string {
|
||||
t := d.t
|
||||
|
||||
switch format {
|
||||
case ISO:
|
||||
// ISO 8601 format: YYYY-MM-DD
|
||||
return t.Format("2006-01-02")
|
||||
|
||||
case EU:
|
||||
// European format: DD.MM.YYYY
|
||||
return t.Format("02.01.2006")
|
||||
|
||||
case US:
|
||||
// US format: MM/DD/YYYY
|
||||
return t.Format("01/02/2006")
|
||||
|
||||
case Long:
|
||||
// Long format with full month name (language-dependent)
|
||||
// EN: "February 9, 2026"
|
||||
// DE: "9. Februar 2026"
|
||||
return d.formatLong()
|
||||
|
||||
case RFC2822:
|
||||
// RFC 2822 email format
|
||||
return t.Format(time.RFC1123Z)
|
||||
|
||||
default:
|
||||
// Fallback to ISO format for unknown formats
|
||||
return t.Format("2006-01-02")
|
||||
}
|
||||
}
|
||||
|
||||
// formatLong formats the date in long format with language-specific conventions.
|
||||
// This is a helper method for Format(Long).
|
||||
func (d Date) formatLong() string {
|
||||
t := d.t
|
||||
lang := d.lang
|
||||
if lang == "" {
|
||||
lang = EN // Default to English if no language set
|
||||
}
|
||||
|
||||
// Get localized month name
|
||||
monthName := lang.MonthName(t.Month())
|
||||
|
||||
// Different formats for different languages
|
||||
switch lang {
|
||||
case DE:
|
||||
// German format: "9. Februar 2026"
|
||||
// Pattern: day without leading zero + ". " + month + " " + year
|
||||
return fmt.Sprintf("%d. %s %d", t.Day(), monthName, t.Year())
|
||||
|
||||
default:
|
||||
// English format (and fallback): "February 9, 2026"
|
||||
// Pattern: month + " " + day + ", " + year
|
||||
return fmt.Sprintf("%s %d, %d", monthName, t.Day(), t.Year())
|
||||
}
|
||||
}
|
||||
|
||||
// String returns the string representation of the Format type.
|
||||
// This is used for better test output and debugging.
|
||||
func (f Format) String() string {
|
||||
switch f {
|
||||
case ISO:
|
||||
return "ISO"
|
||||
case EU:
|
||||
return "EU"
|
||||
case US:
|
||||
return "US"
|
||||
case Long:
|
||||
return "Long"
|
||||
case RFC2822:
|
||||
return "RFC2822"
|
||||
default:
|
||||
return "Unknown"
|
||||
}
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue