luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-02-04 18:26:19 +01:00
Code Issues Packages Projects Releases Wiki Activity

g_date_time_format: clarify documentation

Browse Source 
Add some clarification to the documentation for %g, %G, %V and %u
formats (which all concern themselves with ISO 8601 week dates).
This commit is contained in:
Ryan Lortie 2011-09-02 20:53:02 -04:00
parent 46ce790772
commit b8c2fd7e05
1 changed files with 12 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
glib/gdatetime.c
View File

@ -2184,13 +2184,14 @@ get_numeric_format (gchar *fmt,
* <varlistentry><term> * <varlistentry><term>
* <literal>%%g</literal>: * <literal>%%g</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the last two digits of the ISO week-based year as a decimal number * the last two digits of the ISO 8601 week-based year as a decimal
* (00-99). * number (00-99). This works well with %%V and %%u.
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%G</literal>: * <literal>%%G</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the ISO week-based year as a decimal number * the ISO 8601 week-based year as a decimal number. This works well
* with %%V and %%u.
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%h</literal>: * <literal>%%h</literal>:
@ -2283,19 +2284,22 @@ get_numeric_format (gchar *fmt,
* <varlistentry><term> * <varlistentry><term>
* <literal>%%u</literal>: * <literal>%%u</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the day of the week as a decimal, range 1 to 7, Monday being 1 * the ISO 8601 standard day of the week as a decimal, range 1 to 7,
* Monday being 1. This works well with %%G and %%V.
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%V</literal>: * <literal>%%V</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the ISO 8601 week number of the current year as a decimal number, * the ISO 8601 standard week number of the current year as a decimal
* range 01 to 53, where week 1 is the first week that has at least * number, range 01 to 53, where week 1 is the first week that has at
* 4 days in the new year. See g_date_time_get_week_of_year(). * least 4 days in the new year. See g_date_time_get_week_of_year().
* This works well with %%G and %%u.
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%w</literal>: * <literal>%%w</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the day of the week as a decimal, range 0 to 6, Sunday being 0 * the day of the week as a decimal, range 0 to 6, Sunday being 0.
* This is not the ISO 8601 standard format -- use %%u instead.
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%W</literal>: * <literal>%%W</literal>: