lib.time

 1from typing import Literal
 2from datetime import datetime
 3
 4
 5YEAR = datetime.now().year
 6"""Current year as integer, e.g. `2026`."""
 7MM_DD = datetime.now().strftime("%m-%d")
 8"""Current month and day in string format, e.g. `06-14`."""
 9
10
11def getDate(format: Literal["machine", "human"], includeYear: bool = True) -> str:
12    """Get current date in specified format. Include year if `includeYear` is `True` (default).
13
14    Example:
15        - `machine` => `2026-06-14`
16        - `human`   => `Jun 14, 2026`
17    """
18    now = datetime.now()
19    if format == "machine":
20        return now.strftime("%Y-%m-%d" if includeYear else "%m-%d")
21    else:
22        return now.strftime("%b %d, %Y" if includeYear else "%b %d")
23
24
25def getTime(clock: Literal["12-hour", "24-hour"], includeSeconds: bool) -> str:
26    """Get current time in specified format. Include seconds if `includeSeconds` is `True`.
27
28    Example:
29        - `12-hour` => `03:45 PM`
30        - `24-hour` => `15:45`
31    """
32    now = datetime.now()
33    if clock == "12-hour":
34        timeFormat = "%I:%M %p" if not includeSeconds else "%I:%M:%S %p"
35    else:
36        timeFormat = "%H:%M" if not includeSeconds else "%H:%M:%S"
37    return now.strftime(timeFormat)