sometime

Get timestamp, formatted date, and perform date/time operations.

Official Release

Sometime v1.2.0

pip install sometime -U

Basic Usage

from sometime import Sometime

# Default initialization
ts = Sometime()

# Custom initialization
ts = Sometime(1650614778, utc=True)

# Set timestamp in seconds
ts.timestamp(seconds)
ts["timestamp"] = seconds

# Set date/time based on date/time string
# https://help.gnome.org/users/gthumb/stable/gthumb-date-formats.html.en"
ts.from_iso("2022-04-22", "%Y-%m-%d")
print("Timestamp:", ts.timestamp())

Get Unix Timestamp

print("Timestamp:", ts.timestamp())

Get current Unix Timestamp

print("Current Timestamp:", ts.now())

Add or subtract years

ts = Sometime(seconds)
ts.year(years=-25)
ts.year(years=100)
print("Year:", ts.year())
print("Year:", ts["%Y"])

Get name of the month

ts = Sometime(seconds)
ts.name_of_month()
print("Date of the Month:", ts.name_of_month())

Add or subtract months

ts = Sometime(seconds)
ts.month(months=-1)
ts.month(months=12)
print("Month:", ts.month())

Add or subtract days

ts = Sometime(seconds)
ts.day(days=-7)
ts.day(days=14)
print("Day:", ts.day())

Add or subtract hours

ts = Sometime(seconds)
ts.hour(hours=-8)
ts.hour(hours=24)
hour = ts.hour()
print("Hour:", ts.hour())

Add or subtract minutes

ts = Sometime(seconds)
ts.minute(minutes=-5)
ts.minute(minutes=30)
minute = ts.minute()
print("Minute:", ts.minute())

Add or subtract seconds

ts = Sometime(seconds)
ts.second(seconds=-1)
ts.second(seconds=30)
second = ts.second()
print("Second:", ts.second())

Get if AM/PM

ts = Sometime(seconds)
ts.period()
print("Period:", ts.period())

Get the Day of the Week

ts = Sometime(seconds)
print("Day of the Week:", ts.day_of_week())

Add or subtract to date/time

ts = Sometime(seconds)
print("Timestamp:", ts.timestamp())
ts.add(years=1, months=2, days=3, hours=4, minutes=5, seconds=6)
print("Timestamp:", ts.timestamp())

Format date/time into string representation

ts = Sometime(seconds)
print("Timestamp:", ts.custom("%Y-%m-%d %H:%M:%S %p"))

Get yesterday's on custom formatting

ts = Sometime(seconds)
print("Yesterday:", ts.yesterday("%Y-%m-%d %H:%M:%S %p"))