mirrors/zsh
1
0
Fork 0
mirror of git://git.code.sf.net/p/zsh/code synced 2025-10-26 04:30:27 +01:00
Code Releases Activity

22613: add strftime -r to use strptime() if available

Browse source
This commit is contained in:
Peter Stephenson 2006-08-17 15:28:11 +00:00
parent 1a42aadd81
commit d0b9eddd9a
4 changed files with 90 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

21
Doc/Zsh/mod_datetime.yo
View file

@ -6,12 +6,27 @@ The tt(zsh/datetime) module makes available one builtin command:
startitem()
findex(strftime)
cindex(date string, printing)
item(tt(strftime) [ tt(-s) var(scalar) ] var(format) var(epochtime) )(
xitem(tt(strftime) [ tt(-s) var(scalar) ] var(format) var(epochtime) )
item(tt(strftime) tt(-r) [ tt(-q) ] [ tt(-s) var(scalar) ] var(format) var(timestring) )(
Output the date denoted by var(epochtime) in the var(format)
specified.
If tt(-s) var(scalar) is given, assign the date to var(scalar) instead
of printing it.
With the option tt(-r) (reverse), use the format var(format) to parse the
input string var(timestring) and output the number of seconds since the
epoch at which the time occurred. If no timezone is parsed, the current
timezone is used; other parameters are set to zero if not present. If
var(timestring) does not match var(format) the command returns status 1; it
will additionally print an error message unless the option tt(-q) (quiet)
is given. If var(timestring) matches var(format) but not all characters in
var(timestring) were used, the conversion succeeds; however, a warning is
issued unless the option tt(-q) is given. The matching is implemented by
the system function tt(strptime); see manref(strptime)(3). This means that
zsh format extensions are not available, however for reverse lookup they
are not required. If the function is not implemented, the command returns
status 2 and (unless tt(-q) is given) prints a message.
If tt(-s) var(scalar) is given, assign the date string (or epoch time
in seconds if tt(-r) is given) to var(scalar) instead of printing it.
)
enditem()