TimeInterval関数について

Question

以下のコード(TimeInterval)関数について、分からないことがあります。

func convertTimeStamp(serverTimeStamp:CLong)->String{
        
        let x = serverTimeStamp / 1000
        let date = Date(timeIntervalSince1970: TimeInterval(x))
        let formatter = DateFormatter()
        formatter.dateStyle = .long
        formatter.timeStyle = .medium
        
        return formatter.string(from: date)
        
    }

TimeInterval関数を公式で確認しました所、以下のように記載がありました。

値は常に秒単位で指定します。10,000年の範囲でミリ秒未満の精度が得られます。

こちらの意味がよくわかりません。TimeInterval関数は何を返すのでしょうか？
どなたかお詳しい方いましたらご助言頂けましたら幸いです。

Answer 1

TimeInterval は主に「時間の長さ」を表現する型です.
時間の長さを扱う際に, 基本的に「秒」を単位として扱います.
1時間であれば 60 、1秒の半分であれば 0.5 という値です.

で, Swift では型名に括弧を付けて関数のように呼ぶのは,
基本的にはその型の値を作成することと同等です.
TimeInterval(x) は x を基に TimeInterval 型の値を作成することになるでしょう.

そして作成した値はすぐに Date(timeIntervalSince1970:) に渡されています. これも 1970 年 1 月 1 日 0 時 0 分 0 秒からの時間の長さを使って Date 型の値を作成するものです.

ところで, その文章はどこの翻訳でしょうか？
Apple の公式ドキュメントには英語で

A TimeInterval value is always specified in seconds; it yields sub-millisecond precision over a range of 10,000 years.

とあるので, 恐らくそこを翻訳したものだと思いますが...
自分も英語にそこまで詳しいわけではないのですが, 翻訳として微妙に分かりにくい表現になることはままあります.

Comments

[ruuuu]

ご回答ありがとうございます。
「TimeInterval」は「秒」を返す関数という訳ですね。
すみません。「1時間であれば 60」という部分なのですが、「１秒」が「0.5」だとした場合、「１分」に相当するのではないかと思ったのですが、「１分」ではありませんでしょうか...?

[kagilinn]

あわわわ、間違えました60秒は1分ですね