luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-09-20 09:16:15 +02:00
Code Issues Packages Projects Releases Wiki Activity

Document exactly what g_time_val_to_iso8601() produces

Browse Source 
Bug: https://bugzilla.gnome.org/show_bug.cgi?id=537637
Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
This commit is contained in:
Simon McVittie 2011-10-18 11:14:20 +01:00 committed by Matthias Clasen
parent dc89b51c2d
commit a0c755710c
1 changed files with 20 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
glib/gtimer.c
View File

@ -475,8 +475,26 @@ g_time_val_from_iso8601 (const gchar *iso_date,
* g_time_val_to_iso8601:
* @time_: a #GTimeVal
*
* Converts @time_ into an ISO 8601 encoded string, relative to the
* Coordinated Universal Time (UTC).
* Converts @time_ into an RFC 3339 encoded string, relative to the
* Coordinated Universal Time (UTC). This is one of the many formats
* allowed by ISO 8601.
*
* ISO 8601 allows a large number of date/time formats, with or without
* punctuation and optional elements. The format returned by this function
* is a complete date and time, with optional punctuation included, the
* UTC time zone represented as "Z", and the @tv_usec part included if
* and only if it is nonzero, i.e. either
* "YYYY-MM-DDTHH:MM:SSZ" or "YYYY-MM-DDTHH:MM:SS.fffffZ".
*
* This corresponds to the Internet date/time format defined by
* <ulink url="https://www.ietf.org/rfc/rfc3339.txt">RFC 3339</ulink>, and
* to either of the two most-precise formats defined by
* <ulink url="http://www.w3.org/TR/NOTE-datetime-19980827">the W3C Note
* "Date and Time Formats"</ulink>. Both of these documents are profiles of
* ISO 8601.
*
* Use g_date_time_format() or g_strdup_printf() if a different
* variation of ISO 8601 format is required.
*
* Return value: a newly allocated string containing an ISO 8601 date
*