41.10 時間の計算

以下の関数はtime値を使用して暦計算を行います(Time of Dayを参照)。これらの関数でtime値を受け取るすべての引数では、他のtime値と同じようにnil値はカレントシステム時刻、単一の数値はエポックからの経過秒数を意味します。

Function: time-less-p t1 t2

これはtime値t1がtime値t2より小ならtをリターンする。引数のいずれかがNaNなら結果はnil。

Function: time-equal-p t1 t2

これはt1とt2が等しいtime値ならtをリターンする。引数のいずれかがNaNなら結果はnil。

Function: time-subtract t1 t2

これは2つのtime値の差t1 - t2をLisptime値としてリターンする。結果は正確であり、そのクロック解像度が2つの引数の解像度より劣ることはない。結果が無限またはNaNの場合のみ浮動小数点数。経過秒の単位の差が必要なら、time-convertやfloat-timeで変換できる。Time Conversionを参照のこと。

Function: time-add t1 t2

これはtime-subtractのようないくつかの変換ルールを使用して、2つのtime値の和をtime値としてリターンする。ここで引数のうち1つはある時点での時刻ではなく時間差を表すこと(time値は経過秒数という単一の数値であることがよくある)。以下はあるtime値に秒数を加算する方法:

(time-add time seconds)

Function: time-to-days time-value

この関数はAC. 1年元日からtime-valueまでの間の日数をデフォルトタイムゾーンとみなしてリターンする。timeの範囲およびzoneの値はオペレーティングシステムが制限する。

Function: time-to-day-in-year time-value

これはtime-valueに対応する年内の日数をデフォルトタイムゾーンとみなしてリターンする。timeの範囲およびzoneの値はオペレーティングシステムが制限する。

Function: date-leap-year-p year

この関数はyearが閏年ならtをリターンする。

Function: date-days-in-month year month

yearのmonthの日数をリターンする。たとえば2020年2月は29日。

Function: date-ordinal-to-time year ordinal

yearの序数日ordinalをデコード済み構造としてリターンする。たとえば2004年の120日目は2004年4月29日。