date (UNIX)

UNIXdateコマンド

UNIXのdateとは、日時にちじを表示ひょうじするコマンドである。スーパーユーザーはこのコマンドを利用りようしてシステム時刻じこくを設定せっていできる。

利用りよう法ほう

オプションなしで実行じっこうした場合ばあい、dateコマンドは現在げんざい日時にちじを表示ひょうじする。より正確せいかくには、標準ひょうじゅんCライブラリの関数かんすうgettimeofday()を用もちいて秒びょう単位たんいまたはマイクロ秒びょう単位たんい^[1]でオペレーティングシステム (OS) が保持ほじするシステム時刻じこくを呼よび出だし、「タイムゾーン情報じょうほう」（Unix系けいOSではtz databaseが良よく使つかわれる）を用もちいて設定せっていされた標準時ひょうじゅんじ（タイムゾーン）に変換へんかんして表示ひょうじする^[2]。表示ひょうじの形式けいしきは、月つき・曜日ようびは省略形しょうりゃくけいとなり、日付ひづけと月つき、コロン区切くぎりの時刻じこく、標準時ひょうじゅんじ、年としの順番じゅんばんで表示ひょうじされる。システム時刻じこくがEDTに設定せってい済ずみの上うえでdateコマンドを実行じっこうした例れいを挙あげる。

$date
Fri Jul 27 14:12:06 EDT 2007

dateコマンドの実装じっそうはUnix系けいのバリエーションによって違ちがいが大おおきいことには注意ちゅういしておきたい。移植いしょく性せいがある部分ぶぶんが少すくなかったためPOSIXでは-uオプションとフォーマット指定してい子こしか標準ひょうじゅん化かすることが出来できなかった。それ以外いがいはすべて拡張かくちょう機能きのうであり移植いしょく性せいがない。システム時刻じこくの設定せっていも拡張かくちょう機能きのうである。GNU Core Utilitiesをベースとするコマンドはより多おおくの拡張かくちょう機能きのうが実装じっそうされている。

フォーマット

dateコマンドに+で始はじまる以下いかの文字もじ列れつをオプションとして与あたえることで表示ひょうじ形式けいしき（フォーマット）を変更へんこうすることができる。表ひょうの通とおり、dateコマンドの出力しゅつりょく結果けっかはロケールによって変化へんかする（混乱こんらんしないよう述のべると、本稿ほんこうの表ひょうにおいて、出力しゅつりょく結果けっかはウィキペディアのシステム時刻じこくであり、それはUTCと一致いっちしている。また一部いちぶを除のぞいてロケールは「日本にっぽん」に設定せっていしたと仮定かていしている）。

フォーマット指示しじ子こ（フォーマット文字もじ列れつは+から始はじまる）
指示しじ子こ	記述きじゅつ	値ね/例れい	備考びこう
日ひ
%a	曜日ようび（省略形しょうりゃくけい。例れい: Sun.）	木き	ロケールによって結果けっかは変かわる
%A	曜日ようび（完全かんぜんな表記ひょうき）	木曜日もくようび	ロケールによって結果けっかは変かわる
%d	日ひ（ゼロ埋うめされたdd表記ひょうき）	14
%e	日ひ（ゼロ埋うめしないdd表記ひょうき）	14
%j	その年としの経過けいか日数にっすう（ゼロ埋うめ表記ひょうき）	001-366
%u	月曜日げつようびを1日にち目めとした時ときの1週間しゅうかんにおける経過けいか日数にっすう（mtwtfss）	4
%w	日曜日にちようびを0日にち目めとした時ときの1週間しゅうかんにおける経過けいか日数にっすう（smtwtfs）	4
週しゅう
%U	日曜日にちようびを週しゅうの最初さいしょの日ひとみなしたときの、その年としでの経過けいか週しゅう数すう（0から開始かいし）	00–53
%W	月曜日げつようびを週しゅうの最初さいしょの日ひとみなしたときの、その年としでの経過けいか週しゅう数すう（0から開始かいし）	00–53
%V	月曜日げつようびを週しゅうの最初さいしょの日ひとみなしたときの、その年としでの経過けいか週しゅう数すう（1から開始かいし）	01–53
月つき
%m	月数げっすう（mm表記ひょうき）	11
%h	月つき名めい	11月	ロケールによって結果けっかは変かわる
%b	月つき名めい（ロケールによっては省略しょうりゃく系けい。例れい: Jan.）	11月	ロケールによって結果けっかは変かわる
%B	月つき名めい（%b指示しじ子こにて省略しょうりゃくされたロケールでも、本ほん指示しじ子この場合ばあいは完全かんぜんに表記ひょうきされるが、可変長かへんちょうである）	11月	ロケールによって結果けっかは変かわる
年とし
%y	2桁けた年数ねんすう（yy表記ひょうき）	00–99
%Y	年数ねんすう（ccyy表記ひょうき）	2024
%g	2桁けた年数ねんすう（%V指示しじ子この週しゅう数すうに対応たいおうする表記ひょうき）
%G	4桁けた年数ねんすう（%V指示しじ子この週しゅう数すうに対応たいおうする表記ひょうき）
世紀せいき
%C	世紀せいき（cc表記ひょうき）	00–99
日付ひづけ
%D	mm/dd/yy表記ひょうき	11/14/24
%x	mm/dd/yy表記ひょうき（ただし、ロケール固有こゆうの表現ひょうげん）	11/14/2024
%F	%Y-%m-%d	2024-11-14
時とき
%l (小文字こもじのL)	12時じ間あいだ表記ひょうき（ゼロ埋うめせず）	4
%I (大文字おおもじのI)	12時じ間あいだ表記ひょうき（ゼロ埋うめ）	04
%k	24時じ間あいだ表記ひょうき（ゼロ埋うめせず）	4
%H	24時じ間あいだ表記ひょうき（ゼロ埋うめ）	04
%p	AM/PM表記ひょうき（ロケールによるが、大文字おおもじ表記ひょうき。空白くうはくをおいて「時じ」が表記ひょうきされることが多おおい）	AM
%P	am/pm表記ひょうき（ロケールによるが、小文字こもんじ表記ひょうき。）	am
分ぶん
%M	分ぶん（MM表記ひょうき）	40
秒びょう
%s	1970年ねん1月がつ1日にち0時じ0分ふん0秒びょうUTCからの秒びょう数すう（UNIX時間じかん）	1731559215
%S	秒びょう（SS表記ひょうき）	00–60 （60というのは閏うるう秒びょうによる）
%N	ナノ秒びょう	000000000–999999999
時刻じこく
%r	時とき、分ぶん、秒びょう（12時じ間あいだ表記ひょうき）	04:40:15 AM
%R	時とき、分ぶん（24時じ間あいだ表記ひょうき）	hh:mm、例たとえば04:40
%T	時とき、分ぶん、秒びょう（24時じ間あいだ表記ひょうき）	04:40:15
%X	%H:%M:%S（ロケール固有こゆうの表現ひょうげん）
日時にちじ
%c	ロケール固有こゆうの日時にちじ表記ひょうき	Sat Nov 04 12:02:33 EST 1989
標準時ひょうじゅんじ・タイムゾーン
%z	RFC-822方式ほうしきの数値すうち表記ひょうき（-zzzz）	-0500
%Z	英字えいじ表記ひょうきのタイムゾーン。未決みけつならば空白くうはく。	EST

文字もじ出力しゅつりょく: %n 改行かいぎょう %% パーセント %t 水平すいへいタブ

デフォルトではdateは数値すうちフィールドをゼロ埋うめする。

GNU dateは%と数値すうち指定してい子この間あいだにあるフィールドに対たいして、-（ハイフン）を置おくと空白くうはくを埋うめずフィールドを詰つめないが、 _（アンダースコア）は空白くうはくでフィールドを埋うめる。この動作どうさはBSDベースのdateコマンドには当あてはまらない。

環境かんきょう変数へんすうTZはタイムゾーンを指定していする。ただしこの値ねはコマンドラインパラメータで上書うわがきできる。TZに何なにも指定していされていない場合ばあい、デフォルトでは/etc/localtimeの設定せっていが利用りようされる（詳細しょうさいは記事きじ"tz database"を参照さんしょう）。

オプション

-d, -de=stringは、文字もじ列れつstringに適応てきおうする日時にちじを表示ひょうじする。例たとえば-d two days agoならばコマンド実行じっこう時点じてんから2日にち前まえの日時にちじを表示ひょうじする。ただし、nowは指定していできない。

-e=datefileは、deで指定していした文字もじ列れつを記述きじゅつしたdatefileを一いち行ぎょうずつ読よみ込こみ処理しょりする。

-s, --set=stringは、-d, -deと同様どうようの形式けいしきの文字もじ列れつstringを受うけ付つけ、時刻じこくを設定せっていする^{[注釈ちゅうしゃく 1]}。

-nは、timed(8)ユーティリティを利用りようしたマシンの時刻じこく同期どうきを行おこなわない。デフォルトでは、timedが稼動かどうしている場合ばあい、dateコマンドはローカル・グループに含ふくまれる全すべてのマシンの時刻じこくを同一どういつのものに設定せっていする。-nオプションはこれを抑制よくせいする。

-uは、UTCに時刻じこくを表示ひょうじ、もしくは設定せっていする。

date [-u|--utc|--universal] [mmddHHMM[[cc]yy][[.SS]]というオプションでのみ、その出力しゅつりょく結果けっかはUTCを指定していする適切てきせつな形式けいしきとなる。

-uは、GMTに指定していされたとみなす。出力しゅつりょく結果けっか例れい: Sat Feb 5 14:49:42 GMT 2005

--utc, --universalはTZを地方ちほう時じの代かわりにUTCに指定していされたとみなす。出力しゅつりょく結果けっか例れい: Sat Feb 5 09:49:59 EST 2005

-ITIMESPEC, --iso-8601[=TIMESPEC]は、ISO 8601形式けいしきで出力しゅつりょくする。TIMESPECには文字もじ列れつhours, minutes, secondsのいずれかを指定していでき、それぞれ時刻じこくの精度せいどを決定けっていする。autoと指定していすると時刻じこくを表示ひょうじしなくなる。

文字もじ列れつを何なにも指定していせず、ただ--iso-8601というオプションを指定していした場合ばあい、 `date'コマンドのデフォルトの表示ひょうじ、すなわち、時刻じこくを省略しょうりゃくしたISO 8601形式けいしきで出力しゅつりょくする。

-R, --rfc-822は、出力しゅつりょくをRFC-822準拠じゅんきょの日時にちじ文字もじ列れつで出力しゅつりょくする。例れい: Wed, 16 Dec 2009 15:18:11 +0100

--helpは、使用しよう方法ほうほうを表示ひょうじする。

Single UNIX Specification (SUS)は、たった一ひとつのオプション: -uのみを要求ようきゅうしている。前述ぜんじゅつしたとおり、これはタイムゾーンがあたかもUTC+0に指定していしたかのように日時にちじを表示ひょうじする。その他たのUNIX並ならびにUnix系けいオペレーティングシステムでは追加ついかのオプションが提供ていきょうされる場合ばあいもある。

実行じっこう例れい

date "+%m/%d/%y"
7/4/06

date "+%Y%m%d"
20060704

時刻じこくに変数へんすうを割わり当あてる場合ばあいは、

START=`date '+%r'`
echo $START
03:06:02 PM
sleep 5
echo $START
03:06:02 PM

ただし、変数へんすうは時刻じこくを割わり当あてた瞬間しゅんかんのものである。実行じっこうした瞬間しゅんかんではない。

dateコマンド実行じっこうからちょうど昨日きのうの日時にちじを変数へんすうに割わり当あてる場合ばあいは、

DATE=$(date -d yesterday +"%Y%m%d")
echo $DATE
20060704

異ことなるタイムゾーンの時刻じこくを表示ひょうじしたい場合ばあいは、環境かんきょう変数へんすうTZの値ねを上書うわがきする。様々さまざまなタイムゾーンは/usr/share/zoneinfoディレクトリ以下いかに存在そんざいする（詳細しょうさいは記事きじ"tz database"を参照さんしょう）。

OLDTZ=$TZ
export TZ=GMT; echo "GMT:               `date +\"%F %R (%Z)\"`"
GMT:               2008-10-31 12:30 (GMT)
export TZ=Europe/Stockholm; echo "Stockholm:    `date +\"%F %R (%Z)\"`"
Stockholm:    2008-10-31 13:30 (CET)
export TZ=Asia/Kuala_Lumpur; echo "Kuala Lumpur:        `date +\"%F %R (%Z)\"`"
Kuala Lumpur:        2008-10-31 20:30 (MYT)
export TZ=US/Central; echo "Dallas:             `date +\"%F %R (%Z)\"`"
Dallas:             2008-10-31 07:30 (CDT)
export TZ=$OLDTZ

その他たの利用りよう可能かのうな時刻じこく文字もじ列れつの例れい。

date +"%Y%m%d" -d sunday # GNU date
20060709

date +"%Y%m%d" -d last-sunday # GNU date
20060702

date +"%Y%m%d" -d last-week # GNU date
date -v -1m +"%Y%m%d" # BSD date
20060627

date +"%Y%m%d" -d last-month # GNU date
date -v -1w +"%Y%m%d" # BSD date
20060604

date +"%Y%m%d" -d last-year # GNU date
date -v -1y +"%Y%m%d" # BSD date
20050704

date +"%Y%m%d" -d next-week # GNU date
date -v 1w +"%Y%m%d" # BSD date
20060711

date +"%Y%m%d" -d next-month # GNU date
date -v 1m +"%Y%m%d" # BSD date
20060804

date +"%Y%m%d" -d next-year # GNU date
date -v 1y +"%Y%m%d" # BSD date
20070704

date +"%Y%m%d" -d "2 days ago" # GNU date
date -v -2d +"%Y%m%d" # BSD date
20060702

date +"%Y%m%d" -d "2 months ago" # GNU date
date -v -2m +"%Y%m%d" # BSD date
20060504

date +"%Y%m%d" -d "2 years ago" # GNU date
date -v -2y +"%Y%m%d" # BSD date
20040704

UNIX時間じかんを表示ひょうじするには、

date +"%s" -d "Fri Apr 24 13:14:39 CDT 2009"
1240596879

UNIX時間じかんから人間にんげんが可読かどくな形式けいしきに変換へんかんするには、

date -d "UTC 1970-01-01 1240596879 secs"
Fri Apr 24 13:14:39 CDT 2009

または、

date -ud @1000000000
Sun Sep  9 01:46:40 UTC 2001

システム時刻じこくの設定せってい

SUSのX/Open System Interfaces（XSI）拡張かくちょう仕様しようでは、dateコマンドは、日時にちじを設定せっていするためにも利用りよう可能かのうであると指定していされている。日時にちじを変更へんこうしたい場合ばあいは、dateと共ともに、MMddhhmm[[cc]yy]フォーマットのオプションを指定していする。ここで、MMとは2桁けた表示ひょうじでの月数げっすう、ddは2桁けた表示ひょうじでの日数にっすう、hhは2桁けた表示ひょうじでの時間じかん、mmは2桁けた表示ひょうじでの分ぶんを表あらわす。以下いかは補足ほそく的てきに利用りようされる。ccは年としの先頭せんとう2桁けた、yyは年としの後半こうはん2桁けたの数字すうじを表あらわす。

その他たのUNIXやUnix系けいオペレーティングシステムでは、dateコマンドのオプションまたは日時にちじフォーマットが異ことなっている可能かのう性せいがある。例たとえば、Linuxなど幾いくつかのシステムでは、現在げんざい日時にちじを2004年ねん9月がつ8日にち1時じ22分ふんに設定せっていする場合ばあいは、以下いかのようなコマンドラインで実行じっこうする。

date --set="20040908 01:22"

脚注きゃくちゅう

[脚注きゃくちゅうの使つかい方かた]

注釈ちゅうしゃく

^ 設定せっていにはsettimeofday()が利用りようされる。 “Manpage of GETTIMEOFDAY”. JM Project. linuxjm.sourceforge.jp (2009年ねん3月がつ25日にち). 2011年ねん8月がつ12日にち閲覧えつらん。

出典しゅってん

^ “Manpage of GETTIMEOFDAY”. JM Project. linuxjm.sourceforge.jp (2009年ねん3月がつ25日にち). 2011年ねん8月がつ12日にち閲覧えつらん。
^ 大竹おおたけ龍りゅう史し (2008年ねん12月26日にち). “暗記あんきに頼たよらずちゃんと理解りかい実践じっせんでも役立やくだつLPICドリル - 第だい8回かい Linux時刻じこく管理かんりの仕組しくみと設定せってい”. アットマーク・アイティ. jibun.atmarkit.co.jp. 2011年ねん8月がつ12日にち閲覧えつらん。

外部がいぶリンク

date: write the date and time – The Open Group基本きほん仕様しよう書しょ第だい7号ごう2018年版ねんばん「シェル及およびユーティリティ」
date(1): print or set the system date and time – Linux User Commands Manual (en)
Manpage of DATE - マニュアルの日本語にほんご訳やく。
Manpage of date - 同上どうじょう。
date(1) – FreeBSD General Commands Manual Pages (en)
UNIX dateコマンドの実行じっこう例れい。

[3] 設定せっていにはsettimeofday()が利用りようされる。 “Manpage of GETTIMEOFDAY”. JM Project. linuxjm.sourceforge.jp (2009年ねん3月がつ25日にち). 2011年ねん8月がつ12日にち閲覧えつらん。

[1] “Manpage of GETTIMEOFDAY”. JM Project. linuxjm.sourceforge.jp (2009年ねん3月がつ25日にち). 2011年ねん8月がつ12日にち閲覧えつらん。

[atmarkit-2] 大竹おおたけ龍りゅう史し (2008年ねん12月26日にち). “暗記あんきに頼たよらずちゃんと理解りかい実践じっせんでも役立やくだつLPICドリル - 第だい8回かい Linux時刻じこく管理かんりの仕組しくみと設定せってい”. アットマーク・アイティ. jibun.atmarkit.co.jp. 2011年ねん8月がつ12日にち閲覧えつらん。

[1]

[2]

[注釈ちゅうしゃく 1]

表ひょう話はなし編へん歴れき Unix コマンド
ファイルとファイルシステム管理かんり	cat chattr（英語えいご版ばん） chmod chown chgrp cksum cmp cp dd du df（英語えいご版ばん） file fsck fuser（英語えいご版ばん） ln ls lsof mkdir mount mv pax pwd rm rmdir size split tee touch type（英語えいご版ばん） umask（英語えいご版ばん）
プロセス管理かんり	at bg chroot cron fg kill killall nice pgrep pidof pkill ps pstree（英語えいご版ばん） reboot shutdown time top
ユーザ管理かんり/環境かんきょう	clear env exit finger history（英語えいご版ばん） id logname（英語えいご版ばん） mesg passwd su sudo uptime talk tput（英語えいご版ばん） uname w wall who whoami write
テキスト処理しょり	awk banner basename comm（英語えいご版ばん） csplit（英語えいご版ばん） cut diff dirname ed ex（英語えいご版ばん） fmt fold（英語えいご版ばん） head iconv join（英語えいご版ばん） less m4 more nkf nl paste（英語えいご版ばん） patch printf（英語えいご版ばん） read（英語えいご版ばん） sed sort spell（英語えいご版ばん） strings tail tr troff uniq vi wc xargs yes
シェルビルトイン	alias cd echo test（英語えいご版ばん） unset wait
通信つうしん	dig host（英語えいご版ばん） ifconfig inetd ip (iproute2) netcat netstat nslookup ping rdate（英語えいご版ばん） rlogin route ssh traceroute
検索けんさく	find grep locate（英語えいご版ばん） whatis（英語えいご版ばん） whereis（英語えいご版ばん）
マニュアル	apropos（英語えいご版ばん） help（英語えいご版ばん） man
ソフトウェア開発かいはつ	ar ctags lex make nm strip（英語えいご版ばん） yacc
その他た	bc dc cal date expr false lp（英語えいご版ばん） lpr od sl sleep stty true tty
Category:UNIXのソフトウェア UNIXユーティリティの一覧いちらん