touch.1

TOUCH(1)

TOUCH(1)

FreeBSD General Commands Manual

TOUCH(1)

touch

更改文件访问和修改时间

touch [-A [-][[hh]mm]SS] [-achm] [-r file] [-t [[CC]YY]MMDDhhmm[.SS]] [-d YYYY-MM-DDThh:mm:SS[.frac][tz]] file ...

touch 实用程序设置文件的修改和访问时间。 如果任何文件不存在,则使用默认权限创建它。

默认情况下, touch 更改修改和访问时间。 -a-m 标志可用于单独选择访问时间或修改时间。 选择两者等同于默认设置。 默认情况下,时间戳设置为当前时间。 -d-t 标志明确指定不同的时间,而 -r 标志指定设置指定文件的时间。 -A 标志按指定量调整值。

可以使用以下选项:

-A

按指定值调整文件的访问和修改时间戳。 此标志用于修改时间戳设置不正确的文件。

参数的格式为 “[-][[hh]mm]SS” ,其中每对字母代表以下内容:

-

使调整为负:新时间戳设置在旧时间戳之前。

hh

小时数,从 00 到 99。

mm

分钟数,从 00 到 59。

SS

秒数,从 00 到 59。

-A 标志暗示 -c 标志:如果指定的任何文件不存在,它将被静默忽略。

-a

更改文件的访问时间。 除非还指定了 -m 标志,否则文件的修改时间不会更改。

-c

如果文件不存在,请不要创建该文件。 touch 实用程序不会将此视为错误。 不显示错误消息,退出值不受影响。

-d

将访问和修改时间更改为指定的日期时间,而不是当前时间。 参数的格式为 “YYYY-MM-DDThh:mm:SS[.frac][tz]” ,其中字母表示以下内容:

YYYY

至少四位十进制数字表示年份。

MM, DD, hh, mm, SS

-t 时间一样。

T

字母 T 或空格是时间指示符。

.frac

可选分数,由句点或逗号后跟一个或多个数字组成。 有效位数取决于内核配置和文件系统,并且可能为零。

tz

表示时间的可选字母 Z 采用 UTC 。 否则,时间假定为当地时间。 本地时间受 TZ 环境变量的值影响。

-h

如果文件是符号链接,请更改链接本身的时间,而不是链接指向的文件。 请注意, -h 意味着 -c ,因此不会创建任何新文件。

-m

更改文件的修改时间。 除非还指定了 -a 标志,否则文件的访问时间不会更改。

-r

使用指定文件中的访问和修改时间,而不是当前时间。

-t

将访问和修改时间更改为指定时间,而不是当前时间。 参数的格式为 “[[CC]YY]MMDDhhmm[.SS]” ,其中每对字母代表以下内容:

CC

年份的前两位数字(世纪)。

YY

年份的后两位数。 如果指定了 “YY” ,但未指定 “CC” ,则 “YY” 的值介于 69 和 99 之间时, “CC” 的值为 19。 否则,使用 20 的 “CC” 值。

MM

一年中的月份,从 01 到 12。

DD

月份中的某一天,从 01 到 31。

hh

一天中的小时,从 00 到 23。

mm

小时的分钟,从 00 到 59。

SS

分钟的秒数,从 00 到 60。

如果未指定 “CC” 和 “YY” 字母对,则默认值为当前年份。 如果未指定 “SS” 字母对,则该值默认为 0。

The touch utility exits 0 on success, and >0 if an error occurs.

支持过时的 touch 形式,其中将时间格式指定为第一个参数。 如果未指定 -r-t 选项,则至少有两个参数,第一个参数是长度为 8 或 10 个字符的数字字符串,第一个参数被解释为 “MMDDhhmm[YY]” 。

“MM”, “DD”, “hh” 和 “mm” 字母对被视为指定给 -t 选项的对应项。 如果 “YY” 字母对在 39 到 99 范围内,则年份设置为 1939 到 1999,否则,年份设置为 21 世纪。

utimensat(2)

touch 实用程序预计将成为 IEEE Std 1003.2 (“POSIX.2”) 规范的超集。

touch 实用程序出现在 Version 7 AT&T UNIX 中。

June 1, 2018

FreeBSD 13.1-RELEASE

最后更新于

FreeBSD 中文社区