.date

.date <conversion_specifier>

使用 .date 指令，並以一或多個轉換指定元字元作為引數，可在專案執行時產生現行日期 / 時間資訊。

.date 指令和其引數必須定義成環境中的環境變數。之後您便可以將環境指派給專案或步驟。

例如，在環境中定義一個 DayofWeek 環境變數，並指派 .date %A 值給它。然後再將環境指派給專案或步驟。如果專案是在星期三執行，工作會將「星期三」文字指派給 DayofWeek 環境變數。

重要： 在步驟的「指令」欄位中，無法直接參照 .date 指令。
註： .date 指令會重新評估每一個步驟。如果要保留特定的時間，使用 .date 時請搭配 .bset env。例如，使用 $ORIGTIMESTAMP = .date %d-%b-%Y.%H:%M:%S 然後使用 .bset env "TIMESTAMP=`echo $ORIGTIMESTAMP`"。

.date 指令建置在 POSIX strftime 函數上，可接受以 ANSI C89 標準識別的轉換指定元。下表提供轉換指定元的日期 / 時間值。

註： 並非所有的轉換指定元都可以在各個語言環境與作業系統之間使用。請在您打算使用 .date 指令的伺服器作業系統與語言環境上，測試這個指令的結果。

日期轉換指定元

說明

%a

依現行語言環境而定的平日名稱縮寫。

%A

依現行語言環境而定的完整平日名稱。

%b

依現行語言環境而定的月份名稱縮寫。

%B

依現行語言環境而定的完整月份名稱。

%c

現行偏好的語言環境日期和時間表示法。

%d

一個月中的第幾日，以十進位數表示（範圍從 01 至 31）。

%H

使用 24 小時表示法的小時數，以十進位數表示（範圍從 00 至 23）。

%I

使用 12 小時表示法的小時數，以十進位數表示（範圍從 01 至 12）。

%j

一年中的第幾日，以十進位數表示（範圍從 001 至 366）。

%m

月份，以十進位數表示（範圍從 01 至 12）。

%M

分鐘，以十進位數表示（範圍從 00 至 59）。

%p

"AM" 或 "PM"，需根據所給定的時間值，或是現行語言環境的對應字串。正午視為 "pm"，午夜則視為 "am"。

%S

秒數，以十進位數表示（範圍從 00 至 61）。

%U

該年的第幾週，以十進位數表示，範圍從 00 至 53，以第一個星期日作為第 01 週的第一天。

%w

星期幾，以十進位數表示，範圍從 0 至 6，星期日 0。

%W

該年的第幾週，以十進位數表示，範圍從 00 至 53，以第一個星期一作為第 01 週的第一天。

%y

年份，以十進位數表示，不含世紀（範圍從 00 至 99）。

%Y

年份，以十進位數表示，包含世紀。

%Z

時區或名稱或縮寫。

%%

"%" 字元。
意見