From: Eli Zaretskii Date: Sat, 12 Aug 2006 12:55:07 +0000 (+0000) Subject: (Time Parsing): Add %z to format-time-string, per docstring. X-Git-Tag: emacs-pretest-22.0.90~1023 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=78e5d54902a455900943b3cb9327104cfd8f7cb4;p=emacs.git (Time Parsing): Add %z to format-time-string, per docstring. Add cross reference to glibc manual for strftime. --- diff --git a/lispref/os.texi b/lispref/os.texi index 30f66889387..ab277afdce6 100644 --- a/lispref/os.texi +++ b/lispref/os.texi @@ -1256,7 +1256,9 @@ This stands for the year without century (00-99). @item %Y This stands for the year with century. @item %Z -This stands for the time zone abbreviation. +This stands for the time zone abbreviation (e.g., @samp{EST}). +@item %z +This stands for the time zone numerical offset (e.g., @samp{-0500}). @end table You can also specify the field width and type of padding for any of @@ -1286,12 +1288,14 @@ If @var{universal} is non-@code{nil}, that means to describe the time as Universal Time; @code{nil} means describe it using what Emacs believes is the local time zone (see @code{current-time-zone}). -This function uses the C library function @code{strftime} to do most of -the work. In order to communicate with that function, it first encodes -its argument using the coding system specified by -@code{locale-coding-system} (@pxref{Locales}); after @code{strftime} -returns the resulting string, @code{format-time-string} decodes the -string using that same coding system. +This function uses the C library function @code{strftime} +(@pxref{Formatting Calendar Time,,, libc, The GNU C Library Reference +Manual}) to do most of the work. In order to communicate with that +function, it first encodes its argument using the coding system +specified by @code{locale-coding-system} (@pxref{Locales}); after +@code{strftime} returns the resulting string, +@code{format-time-string} decodes the string using that same coding +system. @end defun @defun seconds-to-time seconds