fasttime 0.2.3

Small UTC date/time library based on Ben Joffe's fast 64-bit date algorithm
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

"""
Basic usage examples for the fasttime library.

This example demonstrates common operations with dates, times,
datetimes, and durations.
"""

import fasttime


def main():
    print("=== Basic Usage Examples ===\n")

    # 1. Working with Dates
    print("1. Working with Dates")
    print("-" * 40)
    date = fasttime.Date(2024, 1, 15)
    print(f"Date: {date}")
    print(f"Year: {date.year}, Month: {date.month}, Day: {date.day}")
    print(f"Weekday: {date.weekday()}")
    print(f"Day of year: {date.ordinal()}")
    
    # Add/subtract days
    tomorrow = date.add_days(1)
    yesterday = date.add_days(-1)
    print(f"Tomorrow: {tomorrow}")
    print(f"Yesterday: {yesterday}")
    print()

    # 2. Working with Times
    print("2. Working with Times")
    print("-" * 40)
    time = fasttime.Time(14, 30, 45, nanosecond=123_456_789)
    print(f"Time: {time}")
    print(f"Hour: {time.hour}, Minute: {time.minute}, Second: {time.second}")
    print(f"Nanosecond: {time.nanosecond}")
    print(f"Seconds since midnight: {time.seconds_since_midnight()}")
    print(f"Nanos since midnight: {time.nanos_since_midnight()}")
    print()

    # 3. Working with DateTimes
    print("3. Working with DateTimes")
    print("-" * 40)
    dt = fasttime.DateTime(date, time)
    print(f"DateTime: {dt}")
    print(f"Date component: {dt.date}")
    print(f"Time component: {dt.time}")
    
    # Get current time
    now = fasttime.DateTime.now_utc()
    print(f"Current UTC time: {now}")
    print()

    # 4. Working with Durations
    print("4. Working with Durations")
    print("-" * 40)
    
    # Create durations
    one_hour = fasttime.Duration.seconds(3600)
    one_day = fasttime.Duration.seconds(86400)
    half_second = fasttime.Duration.milliseconds(500)
    
    print(f"One hour: {one_hour.total_seconds()} seconds")
    print(f"One day: {one_day.total_seconds()} seconds")
    print(f"Half second: {half_second.total_seconds()} seconds")
    
    # Add durations
    total = one_hour + half_second
    print(f"One hour + 500ms: {total.total_seconds()} seconds")
    
    # Add duration to datetime
    later = dt.add_duration(one_hour)
    print(f"Original: {dt}")
    print(f"One hour later: {later}")
    
    # Calculate difference
    diff = later.difference(dt)
    print(f"Difference: {diff.total_seconds()} seconds")
    print()

    # 5. Comparisons
    print("5. Comparisons")
    print("-" * 40)
    date1 = fasttime.Date(2024, 1, 1)
    date2 = fasttime.Date(2024, 12, 31)
    
    print(f"{date1} < {date2}: {date1 < date2}")
    print(f"{date1} == {date2}: {date1 == date2}")
    print(f"{date1} > {date2}: {date1 > date2}")
    print()

    # 6. Hash and Sets
    print("6. Hash and Sets")
    print("-" * 40)
    dates = {
        fasttime.Date(2024, 1, 1),
        fasttime.Date(2024, 6, 15),
        fasttime.Date(2024, 12, 31),
        fasttime.Date(2024, 1, 1),  # Duplicate
    }
    print(f"Unique dates: {len(dates)}")
    for d in sorted(dates):
        print(f"  {d}")
    print()

    # 7. Converting to/from days since epoch
    print("7. Days Since Unix Epoch")
    print("-" * 40)
    epoch = fasttime.Date.from_days_since_unix_epoch(0)
    print(f"Unix epoch (day 0): {epoch}")
    
    days = date.days_since_unix_epoch()
    print(f"{date} is {days} days since epoch")
    
    reconstructed = fasttime.Date.from_days_since_unix_epoch(days)
    print(f"Reconstructed: {reconstructed}")
    print(f"Match: {date == reconstructed}")
    print()


if __name__ == "__main__":
    main()