rclone/docs/content/commands/rclone_touch.md

56 lines
1.7 KiB
Markdown
Raw Normal View History

2017-12-23 21:07:45 +08:00
---
title: "rclone touch"
description: "Create new file or change file modification time."
2017-12-23 21:07:45 +08:00
slug: rclone_touch
url: /commands/rclone_touch/
# autogenerated - DO NOT EDIT, instead edit the source code in cmd/touch/ and as part of making a release run "make commanddocs"
2017-12-23 21:07:45 +08:00
---
# rclone touch
2017-12-23 21:07:45 +08:00
Create new file or change file modification time.
## Synopsis
2017-12-23 21:07:45 +08:00
2021-11-01 23:42:05 +08:00
Set the modification time on file(s) as specified by remote:path to
have the current time.
2021-11-01 23:42:05 +08:00
If remote:path does not exist then a zero sized file will be created,
unless `--no-create` or `--recursive` is provided.
2021-11-01 23:42:05 +08:00
If `--recursive` is used then recursively sets the modification
time on all existing files that is found under the path. Filters are supported,
and you can test with the `--dry-run` or the `--interactive` flag.
If `--timestamp` is used then sets the modification time to that
time instead of the current time. Times may be specified as one of:
2021-02-02 21:42:35 +08:00
- 'YYMMDD' - e.g. 17.10.30
- 'YYYY-MM-DDTHH:MM:SS' - e.g. 2006-01-02T15:04:05
- 'YYYY-MM-DDTHH:MM:SS.SSS' - e.g. 2006-01-02T15:04:05.123456789
2021-11-01 23:42:05 +08:00
Note that value of `--timestamp` is in UTC. If you want local time
then add the `--localtime` flag.
2017-12-23 21:07:45 +08:00
```
rclone touch remote:path [flags]
```
## Options
2017-12-23 21:07:45 +08:00
```
-h, --help help for touch
2021-11-01 23:42:05 +08:00
--localtime Use localtime for timestamp, not UTC
-C, --no-create Do not create the file if it does not exist (implied with --recursive)
-R, --recursive Recursively touch all files
-t, --timestamp string Use specified time instead of the current time of day
2017-12-23 21:07:45 +08:00
```
See the [global flags page](/flags/) for global options not listed here.
## SEE ALSO
2017-12-23 21:07:45 +08:00
2018-10-15 18:03:08 +08:00
* [rclone](/commands/rclone/) - Show help for rclone commands, flags and backends.
2018-03-19 18:06:13 +08:00