npt-japanese

% Function DECODE-UNIVERSAL-TIME

UP


Function DECODE-UNIVERSAL-TIME

Function DECODE-UNIVERSAL-TIME

構文

decode-universal-time universal-time &optional time-zone
=> second, minute, hour, date, month, year, day, daylight-p, zone

引数と戻り値

universal-time - 普遍時間
time-zone - タイムゾーン
second, minute, hour, date, month, year, day, daylight-p, zone - デコード時間

定義

与えられた普遍時間によって表現されるデコード時間を返却します。

もしtime-zoneが指定されなかったとき、 現在のタイムゾーンでDaylight Saving Time(日光節約時間)によって 調整されたものをデフォルトとします。 もしtime-zoneが指定されたとき、Daylight Saving Timeの情報は無視されます。 もしtime-zoneが指定されたとき、Daylight Saving Timeのフラグはnilです。

例文

(decode-universal-time 0 0) =>  0, 0, 0, 1, 1, 1900, 0, false, 0

;; 次の2つの例は、Eastern Daylight Timeを仮定しています。
(decode-universal-time 2414296800 5) =>  0, 0, 1, 4, 7, 1976, 6, false, 5
(decode-universal-time 2414293200) =>  0, 0, 1, 4, 7, 1976, 6, true, 5

;; この例は、タイムゾーンがEastern Daylight Timeを仮定しています。
;; (そしてタイムゾーンは例を通して固定です)
(let* ((here (nth 8 (multiple-value-list (get-decoded-time)))) ;タイムゾーン
       (recently (get-universal-time))
       (a (nthcdr 7 (multiple-value-list (decode-universal-time recently))))
       (b (nthcdr 7 (multiple-value-list (decode-universal-time recently here)))))
  (list a b (equal a b))) =>  ((T 5) (NIL 5) NIL)

影響

Daylight Saving Timeが与えられたセッションで効果を持つとき、 実装依存の仕組みによって計算されます。

例外

なし。

参考

encode-universal-time, get-universal-time, 25.1.4. 時間

備考

なし。


TOP, Github