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

gdatetime: Document that specific AM/PM formatting is discouraged

Browse Source 
Many locales have no concept of AM/PM notation, and it’s confusing to
them. It’s an Anglo-centric concept which doesn’t belong in the API at
this level — instead, programs should use more generic format specifiers
which leave the details of how to format a date/time to the locale.

Signed-off-by: Philip Withnall <withnall@endlessm.com>

Fixes: #2082
This commit is contained in:
Philip Withnall 2020-04-09 12:26:12 +01:00
parent 1a3a1865eb
commit 6e3b1e069d
1 changed files with 7 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
glib/gdatetime.c
View File

@ -3347,10 +3347,14 @@ g_date_time_format_utf8 (GDateTime *datetime,
* - \%M: the minute as a decimal number (range 00 to 59) * - \%M: the minute as a decimal number (range 00 to 59)
* - \%p: either "AM" or "PM" according to the given time value, or the * - \%p: either "AM" or "PM" according to the given time value, or the
* corresponding strings for the current locale. Noon is treated as * corresponding strings for the current locale. Noon is treated as
* "PM" and midnight as "AM". * "PM" and midnight as "AM". Use of this format specifier is discouraged, as
* many locales have no concept of AM/PM formatting. Use \%c or \%X instead.
* - \%P: like \%p but lowercase: "am" or "pm" or a corresponding string for * - \%P: like \%p but lowercase: "am" or "pm" or a corresponding string for
* the current locale * the current locale. Use of this format specifier is discouraged, as
* - \%r: the time in a.m. or p.m. notation * many locales have no concept of AM/PM formatting. Use \%c or \%X instead.
* - \%r: the time in a.m. or p.m. notation. Use of this format specifier is
* discouraged, as many locales have no concept of AM/PM formatting. Use \%c
* or \%X instead.
* - \%R: the time in 24-hour notation (\%H:\%M) * - \%R: the time in 24-hour notation (\%H:\%M)
* - \%s: the number of seconds since the Epoch, that is, since 1970-01-01 * - \%s: the number of seconds since the Epoch, that is, since 1970-01-01
* 00:00:00 UTC * 00:00:00 UTC