macOS에서 touch -d yesterday가 out of range or illegal time specification 오류를 낼 때: 며칠 전 시각으로 파일 시간을 맞추는 맥의 방법을 GNU touch와 나란히 시험한 결과When touch -d yesterday fails with out of range or illegal time specification on macOS: how to backdate a file on a Mac, tested side by side with GNU touch
리눅스식 touch -d "3 days ago" 줄을 맥에서 돌려 오류를 만났거나, 오류를 숨긴 시험 스크립트가 낡은 파일 없이 지나간 독자가 맥에서 파일 시각을 과거로 맞추는 방법을 고르게 돕는다.
이 맥(26.6.2)의 touch -d 는 초까지 쓴 YYYY-MM-DDThh:mm:SS 모양(소수초 가능)만 받고 yesterday·1 day ago·@0·날짜만·초 없는 시각·+09:00 오프셋과 --date= 를 종료 코드 1로 거부하며 파일도 만들지 않는다. 대신 date -v 로 계산한 값을 -t 에 넘기는 bash 3.2 함수는 GNU touch 9.11 의 N units ago 와 일곱 단위에서 5초 이내로 같은 시각을 냈다.
스크립트의 touch -d "N days ago" 줄을 아래 touch_ago 호출이나 date -v 로 계산한 touch -t 로 바꾸고, touch 의 오류를 2>/dev/null 로 버리거나 || true 로 덮는 곳이 없는지 확인하라.
목차
한 줄 요약: 맥의 touch -d 는 완성된 시각만 받고 yesterday 나 3 days ago 는 종료 코드 1로 거부하므로, date -v 로 계산한 값을 touch -t 에 넘기는 아래 함수를 쓴다.
리눅스에서 touch -d "3 days ago" old.log 로 사흘 묵은 시험 파일을 만들던 줄을 맥 터미널에서 돌리면 파일 시각은 그대로이고 오류 한 줄만 남는다. 이 글은 맥의 touch -d 가 무엇을 받고 무엇을 거부하는지, 오류를 버린 스크립트에서 어떤 일이 생기는지, 맥에서 “N일 전” 시각을 만드는 방법이 GNU touch -d 와 같은 시각을 내는지를 이 맥에서 직접 돌려 보인다.
touch: out of range or illegal time specification: YYYY-MM-DDThh:mm:SS[.frac][tz]확인한 환경은 macOS 26.6.2 arm64 의 /usr/bin/touch 와 bash 3.2.57 이고 날짜는 2026-11-01 이다. 시간대는 시험 스크립트에서 Asia/Seoul 로 고정했다. 비교 기준인 GNU touch 는 Homebrew 의 coreutils 9.11 이 gtouch 라는 이름으로 이 맥에 있어 직접 돌렸다. 시험 스크립트 두 개를 두 번씩 돌렸고 두 번째 출력은 첫 번째와 글자까지 같았다. 같은 계열의 사연은 2020년 tz 메일링 리스트에도 있다. 애플 주소로 글을 보낸 사람이 최신 macOS 에서 빌드가 깨진 이유를 “the touch command on Darwin does not have a -d option” 이라고 적었다. 지금 이 맥의 touch 는 -d 를 받지만 받는 모양이 좁다.
용어 몇 개. 파일 시각은 파일에 적힌 마지막 수정 시각(mtime)과 마지막 접근 시각(atime)이다. 종료 코드는 명령이 끝나며 남기는 숫자로 0이 정상이다. GNU 는 많은 리눅스 배포판이 쓰는 명령 모음이고 맥의 명령은 BSD 계열이라 이름이 같아도 옵션이 다르다.
맥의 touch -d 가 받는 모양과 거부하는 모양
입력을 하나씩 바꿔 가며 종료 코드와 오류 첫 줄, 파일이 생겼는지, 파일 시각이 어떻게 됐는지를 쟀다. 시험한 열네 입력 가운데 맥은 2026-10-31 12:00:00, 2026-10-31T12:00:00, 2026-10-31T12:00:00Z 와 소수초를 붙인 두 입력, 모두 다섯 개만 받았고 나머지 아홉 개는 종료 코드 1에 파일이 만들어지지 않았다. 오류 문구는 -d 가 기대하는 모양을 보여 주지만 입력의 어느 글자가 문제인지는 알려 주지 않는다.
| 입력 | 맥 /usr/bin/touch |
gtouch (GNU 9.11) |
|---|---|---|
-d yesterday |
1, 파일 없음 | 0, 지금보다 1일 전 |
-d "1 day ago", -d "3 days ago" |
1, 파일 없음 | 0, 1일 전, 3일 전 |
-d tomorrow |
1, 파일 없음 | 0, 지금보다 1일 뒤 |
-d @0 |
1, 파일 없음 | 0, 1970-01-01 09:00:00 (서울 시각) |
-d 2026-10-31 |
1, 파일 없음 | 0, 2026-10-31 00:00:00 |
-d "2026-10-31 12:00" |
1, 파일 없음 | 0, 2026-10-31 12:00:00 |
-d "2026-10-31 12:00:00", -d 2026-10-31T12:00:00 |
0, 2026-10-31 12:00:00 | 0, 같음 |
-d 2026-10-31T12:00:00Z |
0, 2026-10-31 21:00:00 (서울 시각) | 0, 같음 |
-d 2026-10-31T12:00:00.5, -d "2026-10-31 12:00:00,25" |
0, 2026-10-31 12:00:00 (초 아래는 표시 안 함) | 0, 같음 |
-d 2026-10-31T12:00:00+09:00 |
1, 파일 없음 | 0, 2026-10-31 12:00:00 |
--date="2026-10-31 12:00:00" |
1, illegal option -- - |
0, 2026-10-31 12:00:00 |
날짜만 쓴 2026-10-31 이나 초를 뺀 12:00 도 맥에서는 거부된다. 끝에 Z 를 붙이면 UTC 로 읽어 서울 시각 21시가 됐고, 붙이지 않으면 지역 시각이었다. 시간대만 Asia/Seoul, UTC, America/Los_Angeles 로 바꿔 같은 2026-10-31 12:00:00 을 넣었을 때 맥과 gtouch 가 저장한 시각(epoch 초)은 세 시간대 모두 같았다.
GNU 쪽 설명서는 -d 의 표준 형식을 yyyy-mm-ddThh:mm:ss[.frac][Z] 로 적고, 그 밖에 yesterday 같은 단어를 받는 “Date input formats” 를 참조하라고 적는다(확인한 설명서 페이지는 coreutils 9.12 판이고 비교에 쓴 gtouch 는 9.11 이다). 맥의 man touch 는 -d 를 YYYY-MM-DDThh:mm:SS[.frac][tz] 한 가지로만 적는다.
오류를 버리면 낡은 파일이 생기지 않고, 있는 파일은 새 시각 그대로다
이 오류가 번거로워 2>/dev/null 을 붙인 스크립트가 어떻게 되는지 쟀다. 사흘 전 파일을 만들고 find . -name old.log -mtime +2 로 찾는 시험이다. 없던 파일에 touch -d "3 days ago" old.log 2>/dev/null 을 돌리자 종료 코드는 1이고 파일은 만들어지지 않았다. 방금 만든 파일에 같은 줄을 돌려도 종료 코드 1이었고 find 는 0줄을 찾았다. 같은 입력을 gtouch 로 돌리면 종료 코드 0에 find 가 1줄을 찾았다. 뒤에 || true 를 붙이면 종료 코드가 0이 됐다.
set -e 를 켠 스크립트에서는 touch -d "3 days ago" old.log 2>/dev/null 다음 줄의 echo 가 실행되지 않고 종료 코드 1로 아무 말 없이 멈췄다. || true 로 덮은 스크립트는 echo 까지 가서 종료 코드 0으로 끝났다. 정리 스크립트를 시험하려고 낡은 파일을 만들었는데 아무것도 지워지지 않으면 이 줄부터 의심한다. 방금 만든 파일 다섯 개에 오류를 버린 touch -d "3 days ago" 를 한 번씩 돌린 묶음에서 find -mtime +1 은 0줄이었다.
맥이 받는 다른 입력: -t, -A, -r, -m
맥의 touch 에는 -d 말고도 시각을 정하는 길이 있다. -t 는 [[CC]YY]MMDDhhmm[.SS] 모양의 숫자를 받는다. 202610311200, 202610311200.30, 연도를 두 자리로 줄인 2610311200, 연도를 뺀 10311200(이 경우 올해 2026년으로 읽혔다)이 모두 종료 코드 0이었고 각각 2026-10-31 12:00:00, 12:00:30, 12:00:00, 12:00:00 이 됐다. 한 자리가 모자란 20261031120 은 종료 코드 1이었다.
-A 는 지금이 아니라 그 파일의 현재 시각을 기준으로 옮긴다. 2026-10-31 12:00:00 으로 맞춰 둔 파일에 -A -010000 은 11:00:00, -A 020000 은 14:00:00, -A -250000 은 하루 하고 1시간 전인 2026-10-30 11:00:00, -A -0030(분 자리 00, 초 자리 30)은 11:59:30 이 됐고 수정 시각과 접근 시각이 같이 바뀌었다. 없는 파일에 -A -010000 을 주면 종료 코드 0인데 파일은 만들어지지 않았다. man touch 는 -A 가 -c 를 포함한다고 적는다. 그래서 -A 로 “이미 있는 파일을 N시간 묵히기”는 되지만 새 시험 파일을 만들 수는 없다.
-m 은 수정 시각만 바꿔서 12:00:00 이던 접근 시각이 그대로 남았고, -r ref f2 는 ref 의 시각을 f2 로 복사했다.
며칠 전 시각을 계산해 넘기는 bash 함수
“N 단위 전” 을 맥에서 만들려면 date -v 로 시각을 계산해 touch -t 에 넘기면 된다. 아래 함수는 3d, 12H, 30M 같은 인자를 받는다. 단위는 S 초, M 분, H 시, d 일, w 주, m 달, y 해이고, 분(M)과 달(m)의 대소문자가 다른 것에 주의한다.
touch_ago() {
local spec=$1 n u t
shift
n=${spec%?}; u=${spec#"$n"}
case $n in ''|*[!0-9]*) echo "touch_ago: bad spec '$spec' (e.g. 3d 12H 30M)" >&2; return 2;; esac
case $u in S|M|H|d|w|m|y) ;; *) echo "touch_ago: bad unit '$u' (S M H d w m y)" >&2; return 2;; esac
t=$(/bin/date -v-"$n$u" +%Y%m%d%H%M.%S) || return 1
/usr/bin/touch -t "$t" "$@"
}touch_ago 3d old.log 처럼 쓴다. 파일을 여러 개 주어도 되고 이름에 공백이 있어도 됐다. 형식이 틀리면(3, d, 3x, "3 d") 종료 코드 2에 설명을 내고 파일을 만들지 않으며, 파일 이름이 없으면 touch 의 usage 가 나오고 종료 코드 1이다.
gtouch -d "N units ago" 와 나란히 만들어 두 파일의 시각이 5초 안에 있는지 쟀다. 90S, 30M, 12H, 3d, 2w, 1m, 1y 일곱 가지가 모두 5초 이내로 같았다. 달과 해는 2026-11-01 한 날짜에서만 쟀다.
더 실용적인 시험으로 touch_ago 로 0·1·2·3·10일 전 파일 다섯 개를 만든 폴더와 gtouch 로 만든 폴더에서 find -type f 를 돌렸다. -mtime +1 은 둘 다 f10 f2 f3, -mtime +2 는 f10 f3, -mtime 1 은 f1, -mmin +1500 은 f10 f2 f3 으로 두 폴더의 결과가 같았다.
시험하지 못한 것
리눅스에서 GNU touch 를 직접 돌린 대조(이 맥의 gtouch 9.11 로 대신함), 다른 macOS 버전, zsh, 서머타임이 있는 시간대에서 하루 전·한 달 전이 만드는 시각, 달 말일 계산, 밀리초 이하 시각, 하드 링크와 심볼릭 링크에 거는 -h 는 시험하지 않았다. touch_ago 는 BSD date -v 를 쓰므로 리눅스에서는 쓸 수 없고 그쪽에서는 touch -d 를 그대로 쓰면 된다. 공개 기록은 2020년 한 건이고 검색량은 확인하지 않았다.
세 줄 요약
- 맥(26.6.2)의 touch -d 는 초까지 쓴 시각(소수초 가능)만 받고 yesterday·N days ago·@0·날짜만·초 없는 시각·+09:00 오프셋·–date= 는 종료 코드 1로 거부하며 파일도 만들지 않는다.
- 오류를 2>/dev/null 로 버리면 낡은 파일이 없거나 새 파일 그대로여서 find -mtime 시험이 0줄로 조용히 지나가고, set -e 스크립트는 문구 없이 멈춘다.
- date -v 로 계산해 touch -t 에 넘기는 touch_ago 함수는 gtouch 와 일곱 단위에서 5초 이내로 같았고, -A 는 파일의 현재 시각 기준이며 없는 파일은 만들지 않는다.
To help a reader who ran a Linux-style touch -d "3 days ago" line on a Mac and hit an error, or whose test script hid the error and went on without an old file, choose a way to set a file time in the past on the Mac.
The touch -d on this Mac (26.6.2) accepts only the YYYY-MM-DDThh:mm:SS shape written down to the second (fractional seconds allowed). It rejected yesterday, 1 day ago, @0, a date alone, a time without seconds, a +09:00 offset and --date= with exit code 1 and created no file. A bash 3.2 function that computes the time with date -v and passes it to -t gave the same instant as GNU touch 9.11 N units ago within five seconds for seven units.
Replace the touch -d "N days ago" lines in your scripts with the touch_ago call below or with a touch -t computed by date -v, and check that nothing discards the touch error with 2>/dev/null or covers it with || true.
Contents
One-line summary: The Mac’s touch -d accepts only a complete time such as 2026-10-31 12:00:00 and rejects yesterday or 3 days ago with exit code 1, so replace it with the function below, which computes the time with date -v and passes it to touch -t to get the same instant as GNU touch.
On Linux you might create a three-day-old test file with touch -d "3 days ago" old.log. Run that line in a Mac terminal and the file time stays as it was; only one error line is left. This article shows, by running things on this Mac, what the Mac’s touch -d accepts and rejects, what happens in a script that discards the error, and whether the ways of building an “N units ago” time on a Mac give the same instant as GNU touch -d.
touch: out of range or illegal time specification: YYYY-MM-DDThh:mm:SS[.frac][tz]The environment was /usr/bin/touch on macOS 26.6.2 arm64 and bash 3.2.57, on 2026-11-01. The test scripts fix the time zone to Asia/Seoul. The GNU touch used as the comparison is coreutils 9.11 from Homebrew, which is on this Mac under the name gtouch, and I ran it directly. I ran each of the two test scripts twice, and the second output matched the first character for character. A related story appears on the tz mailing list in 2020, where someone writing from an Apple address reported on the latest macOS that a build broke because “the touch command on Darwin does not have a -d option”. The touch on this Mac does accept -d now, but the shape it accepts is narrow.
A few terms. A file time is the last modification time (mtime) and last access time (atime) recorded on the file. An exit code is the number a command leaves when it ends; 0 means success. GNU is the command set many Linux distributions use, while the Mac’s commands are BSD-family, so the same name can take different options.
The shapes the Mac’s touch -d accepts and rejects
I changed the input one at a time and measured the exit code, the first line of the error, whether a file was created, and what the file time became. Of the fourteen inputs I tried, the Mac accepted only five: 2026-10-31 12:00:00, 2026-10-31T12:00:00, 2026-10-31T12:00:00Z and two inputs with fractional seconds. The other nine ended with exit code 1 and no file was created. The error text shows the shape -d expects but does not say which character of the input is the problem.
| Input | Mac /usr/bin/touch |
gtouch (GNU 9.11) |
|---|---|---|
-d yesterday |
1, no file | 0, one day before now |
-d "1 day ago", -d "3 days ago" |
1, no file | 0, one day and three days before now |
-d tomorrow |
1, no file | 0, one day after now |
-d @0 |
1, no file | 0, 1970-01-01 09:00:00 (Seoul time) |
-d 2026-10-31 |
1, no file | 0, 2026-10-31 00:00:00 |
-d "2026-10-31 12:00" |
1, no file | 0, 2026-10-31 12:00:00 |
-d "2026-10-31 12:00:00", -d 2026-10-31T12:00:00 |
0, 2026-10-31 12:00:00 | 0, same |
-d 2026-10-31T12:00:00Z |
0, 2026-10-31 21:00:00 (Seoul time) | 0, same |
-d 2026-10-31T12:00:00.5, -d "2026-10-31 12:00:00,25" |
0, 2026-10-31 12:00:00 (below the second not shown) | 0, same |
-d 2026-10-31T12:00:00+09:00 |
1, no file | 0, 2026-10-31 12:00:00 |
--date="2026-10-31 12:00:00" |
1, illegal option -- - |
0, 2026-10-31 12:00:00 |
On the Mac, a date alone such as 2026-10-31 or a time without seconds such as 12:00 is also rejected. A trailing Z was read as UTC and became 21:00 Seoul time; without it the time was read as local. When I changed only the time zone to Asia/Seoul, UTC and America/Los_Angeles and gave the same 2026-10-31 12:00:00, the stored times (epoch seconds) from the Mac and from gtouch were identical in all three zones.
The GNU manual gives the standard -d shape as yyyy-mm-ddThh:mm:ss[.frac][Z] and refers to “Date input formats” for words such as yesterday (the manual page I checked is the coreutils 9.12 edition, while the gtouch I compared against is 9.11). The Mac’s man touch documents only the single shape YYYY-MM-DDThh:mm:SS[.frac][tz] for -d.
Discard the error and no old file appears, and an existing file keeps its new time
I measured what happens in a script that adds 2>/dev/null because the error is annoying. The test creates a three-day-old file and looks for it with find . -name old.log -mtime +2. Running touch -d "3 days ago" old.log 2>/dev/null on a file that did not exist gave exit code 1 and created no file. Running the same line on a file I had just created also gave exit code 1, and find found 0 lines. The same input through gtouch gave exit code 0 and find found 1 line. Adding || true turned the exit code into 0.
In a script with set -e, the line touch -d "3 days ago" old.log 2>/dev/null stopped the script with exit code 1 and no message, so the echo on the next line never ran. The script covered with || true reached the echo and ended with exit code 0. If you made old files to test a cleanup script and nothing gets deleted, suspect this line first. On a batch of five just-created files, each given one touch -d "3 days ago" with the error discarded, find -mtime +1 found 0 lines.
Other inputs the Mac accepts: -t, -A, -r, -m
The Mac’s touch has other ways to set a time besides -d. -t takes a number of the shape [[CC]YY]MMDDhhmm[.SS]. 202610311200, 202610311200.30, the two-digit-year 2610311200, and 10311200 with the year left out (read as this year, 2026) all exited 0 and gave 2026-10-31 12:00:00, 12:00:30, 12:00:00 and 12:00:00 respectively. 20261031120, one digit short, exited 1.
-A shifts from the file’s current time, not from now. On a file set to 2026-10-31 12:00:00, -A -010000 gave 11:00:00, -A 020000 gave 14:00:00, -A -250000 gave 2026-10-30 11:00:00 (one day and one hour earlier), and -A -0030 (minutes field 00, seconds field 30) gave 11:59:30, with the modification time and the access time changing together. Giving -A -010000 to a file that does not exist exited 0 but created no file. man touch says -A implies -c. So -A can age an existing file by N hours, but it cannot create a new test file.
-m changed only the modification time, so the access time that had been 12:00:00 stayed, and -r ref f2 copied the time of ref onto f2.
A bash function that computes the time N days ago
To get “N units ago” on a Mac, compute the time with date -v and pass it to touch -t. The function below takes arguments such as 3d, 12H and 30M. The units are S seconds, M minutes, H hours, d days, w weeks, m months and y years; note that minutes (M) and months (m) differ by case.
touch_ago() {
local spec=$1 n u t
shift
n=${spec%?}; u=${spec#"$n"}
case $n in ''|*[!0-9]*) echo "touch_ago: bad spec '$spec' (e.g. 3d 12H 30M)" >&2; return 2;; esac
case $u in S|M|H|d|w|m|y) ;; *) echo "touch_ago: bad unit '$u' (S M H d w m y)" >&2; return 2;; esac
t=$(/bin/date -v-"$n$u" +%Y%m%d%H%M.%S) || return 1
/usr/bin/touch -t "$t" "$@"
}Use it as touch_ago 3d old.log. Several files can be given, and names with spaces worked. A malformed spec (3, d, 3x, "3 d") exits 2 with a message and creates no file, and with no file name you get touch’s usage and exit code 1.
I made two files side by side, one with the function and one with gtouch -d "N units ago", and measured whether their times were within five seconds. All seven specs, 90S, 30M, 12H, 3d, 2w, 1m and 1y, agreed within five seconds. The month and year were measured on one date only, 2026-11-01.
For a more practical test I used touch_ago to create five files aged 0, 1, 2, 3 and 10 days in one folder and made the same five with gtouch in another, then ran find -type f in both. -mtime +1 gave f10 f2 f3 in both, -mtime +2 gave f10 f3, -mtime 1 gave f1, and -mmin +1500 gave f10 f2 f3; the results of the two folders were the same.
What I did not test
I did not test GNU touch run directly on Linux (the gtouch 9.11 on this Mac stands in), other macOS versions, zsh, the times that “a day ago” and “a month ago” produce in a time zone with daylight saving, month-end calculations, sub-millisecond times, or -h on hard and symbolic links. touch_ago uses BSD date -v, so it cannot be used on Linux; there you can keep using touch -d as it is. The public record is one item from 2020, and I did not check search volume.
Three-line summary
- The touch -d on macOS (26.6.2) accepts only a time written down to the second (fractional seconds allowed) and rejects yesterday, N days ago, @0, a date alone, a time without seconds, a +09:00 offset and –date= with exit code 1, creating no file.
- Discarding the error with 2>/dev/null leaves the old file uncreated or at its new time, so a find -mtime test quietly finds 0 lines, and a set -e script stops without a message.
- The touch_ago function that computes with date -v and passes the result to touch -t agreed with gtouch within five seconds for seven units, and -A shifts from the file’s own current time and does not create a missing file.