function::ctime

名前

function::ctime — エポックからの経過時間 (秒単位) を、人が判読できる日付/時間の文字列に変換します。

概要

ctime:string(epochsecs:long)

引数

epochsecs
gettimeofday_s によって返される、エポックからの経過時間 (秒数)。

説明

gettimeofday_s によって返されるエポックからの経過時間 (秒数) の引数を取ります。フォームの文字列を返します。
「Wed Jun 30 21:49:08 1993」
文字列は常に 24 文字になります。時間が大幅に過去のものである場合 (エポックからの経過時間 (秒単位) の 32 ビットオフセットで表すことができる値よりも前の場合) は、エラーが発生します (try/catch で回避できます)。時間が大幅に未来のものである場合も、エラーが発生します。
エポック (ゼロ) は以下になります。
「Thu Jan 1 00:00:00 1970」
ctime によって提供される最も古い日付は、epochsecs 2147483648 に対応する 「Fri Dec 13 20:45:52 1901」 です。ctime によって提供される最も新しい日付は、epochsecs 2147483647 に対応する 「Tue Jan 19 03:14:07 2038」 です。
曜日の省略形は、‘Sun’、‘Mon’、‘Tue’、‘Wed’、‘Thu’、‘Fri’、および ‘Sat’ です。月の省略形は ‘Jan’、‘Feb’、‘Mar’、‘Apr’、‘May’、‘Jun’、‘Jul’、‘Aug’、‘Sep’、‘Oct’、‘Nov’、および ‘Dec’ です。
実際の C ライブラリーの ctime 関数は文字列の最後に改行文字 (\n) を挿入しますが、この関数は挿入しません。また、カーネルにはタイムゾーンの概念がないため、時間は常に GMT で返されます。