Mercurial > pidgin.yaz
comparison src/util.h @ 13152:4bb701a8736f
[gaim-migrate @ 15515]
gaim_utf8_strftime() will now provide %z itself if your C library doesn't have it. I'm going to use this shortly.
committer: Tailor Script <tailor@pidgin.im>
author | Richard Laager <rlaager@wiktel.com> |
---|---|
date | Tue, 07 Feb 2006 07:25:45 +0000 |
parents | fcde3faa1f57 |
children | 15b3926e2147 |
comparison
equal
deleted
inserted
replaced
13151:1646cd4f00ad | 13152:4bb701a8736f |
---|---|
213 /** | 213 /** |
214 * Formats a time into the specified format. | 214 * Formats a time into the specified format. |
215 * | 215 * |
216 * This is essentially strftime(), but it has a static buffer | 216 * This is essentially strftime(), but it has a static buffer |
217 * and handles the UTF-8 conversion for the caller. | 217 * and handles the UTF-8 conversion for the caller. |
218 * | |
219 * This function also provides the GNU %z formatter if the underlying C | |
220 * library doesn't. However, the format string parser is very naive, which | |
221 * means that conversions specifiers to %z cannot be guaranteed. The GNU | |
222 * strftime(3) man page describes %z as: 'The time-zone as hour offset from | |
223 * GMT. Required to emit RFC822-conformant dates | |
224 * (using "%a, %d %b %Y %H:%M:%S %z"). (GNU)' | |
218 * | 225 * |
219 * @param format The format string | 226 * @param format The format string |
220 * @param tm The time to format, or @c NULL to use the current local time | 227 * @param tm The time to format, or @c NULL to use the current local time |
221 * | 228 * |
222 * @return The formatted time, in UTF-8. | 229 * @return The formatted time, in UTF-8. |