mirror of
git://git.code.sf.net/p/zsh/code
synced 2025-10-30 17:50:58 +01:00
41 lines
1.7 KiB
Text
41 lines
1.7 KiB
Text
COMMENT(!MOD!zsh/datetime
|
|
Some date/time commands and parameters.
|
|
!MOD!)
|
|
The tt(zsh/datetime) module makes available one builtin command:
|
|
|
|
startitem()
|
|
findex(strftime)
|
|
cindex(date string, printing)
|
|
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.
|
|
|
|
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()
|
|
|
|
The tt(zsh/datetime) module makes available one parameter:
|
|
|
|
startitem()
|
|
vindex(EPOCHSECONDS)
|
|
item(tt(EPOCHSECONDS))(
|
|
An integer value representing the number of seconds since the
|
|
epoch.
|
|
)
|
|
enditem()
|