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.