Zeitgeist.Timestamp
Description:
Convenience functions for dealing with timestamps and dates
include: zeitgeist.h
A suite of convenience functions for dealing with timestamps and dates.
Zeitgeist timestamps are represented as gint64s with the number of milliseconds since the Unix Epoch.
Content:
Constants:
- public const
int64
SECOND
A second represented as a Zeitgeist timestamp (ie. 1000ms)
- public const
int64
MINUTE
A minute represented as a Zeitgeist timestamp (ie. 60000ms)
- public const
int64
HOUR
An hour represented as a Zeitgeist timestamp (ie. 3600000ms)
- public const
int64
DAY
A day represented as a Zeitgeist timestamp (ie. 86400000ms)
- public const
int64
WEEK
A week represented as a Zeitgeist timestamp (ie. 604800000ms)
- public const
int64
YEAR
A year represented as a Zeitgeist timestamp (ie. 31556952000ms). Be
warned that a year is not 365 days, but in fact 365.2425 days, to account for leap years.
Functions:
- public
int64
from_timeval (TimeVal
timeval)
Convert a GLib.TimeVal
to an amount of milliseconds since
the Unix Epoch
- public
TimeVal
to_timeval (int64
timestamp)
Write a Zeitgeist timestamp to a GLib.TimeVal
instance.
Note that Zeitgeist uses only a millisecond resolution, whereas GLib.TimeVal
has microsecond resolution. This means that
the lower three digits of @tv.tv_usec will always be 0.
- public
int64
from_now ()
Return the current timestamp in milliseconds.
- public
int64
from_iso8601 (string
datetime)
Parse a timestamp from an ISO8601-encoded string.
- public
string
to_iso8601 (int64
timestamp)
Convert a timestamp to a human-readable ISO8601 format
- public
int64
from_date (Date
date)
Convert a GDate to a Zeitgeist timestamp
- public
int64
from_dmy (DateDay
day, DateMonth
month, DateYear
year)
Convert a day, month, year tuple into a Zeitgeist timestamp
- public
Date
to_date (int64
timestamp)
Write a timestamp to a GLib.Date
structure
- public
int64
next_midnight (int64
timestamp)
Calculate the timestamp for the next midnight after the given
timestamp.
- public
int64
prev_midnight (int64
timestamp)
Calculate the timestamp for the midnight just before the given
timestamp.