import “time”

時間の計測と表示機能を提供します。

パッケージファイル

sleep.go tick.go time.go zoneinfo.go

定数

const (
    Sunday = iota;
    Monday;
    Tuesday;
    Wednesday;
    Thursday;
    Friday;
    Saturday;
)

Nanoseconds関数

func Nanoseconds() int64

NanosecondsはUnix標準時間であるグリニッジ標準時1970年1月1日からの経過ナノ秒数を返します。

Seconds関数

func Seconds() int64

SecondsはUnix標準時間であるグリニッジ標準時1970年1月1日からの経過秒数を返します。

Sleep関数

func Sleep(ns int64) os.Error

Sleepはnsパラメータで指定したナノ秒間、カレントのゴルーチンを停止させます。
割り込みが発生したときはos.EINTRを返します。

Tick関数

func Tick(ns int64) <-chan int64

Tickは時刻送信チャネルのアクセスだけを提供する、NewTicker関数のコンビニエンスラッパーです。
時刻送信の停止が必要がない場合に使います。

Ticker型

Tickerは時計の刻みを出力する’ticks’同期チャネルを保持します。

type Ticker struct {
    C <-chan int64; // The channel on which the ticks are delivered.
    // contains unexported fields
}

NewTicker関数

func NewTicker(ns int64) *Ticker

Tickerはナノ秒ごとにナノ秒単位の時刻を配信する同期チャネルを持つ、新しいTickerを返します。
時刻配信が中断されたときは、それを取り戻すためにその間の時刻配信をスキップします。

(*Ticker) Stop関数

func (t *Ticker) Stop()

Stopはtickerを止めます。以降、時刻は配信されなくなります。

Time型

Timeは時刻を格納する構造体です。

type Time struct {
    Year                 int64; // 西暦2008年は2008
    Month, Day           int;   // 9月17日は9, 17
    Hour, Minute, Second int;   // 10:43:12は10, 43, 12
    Weekday              int;   // Sunday, Monday, ...
    ZoneOffset           int;   // UTCからの秒数
    Zone                 string;
}

LocalTime関数

func LocalTime() *Time

LocalTimeは現在時刻をローカルタイムゾーンで返します。

SecondsToLocalTime関数

func SecondsToLocalTime(sec int64) *Time

SecondsToUTC はUnix標準時間であるグリニッジ標準時1970年1月1日から、パラメータsecで指定した秒数経過した時刻をローカルタイムゾーンで返します。

SecondsToUTC関数

func SecondsToUTC(sec int64) *Time

SecondsToUTC はUnix標準時間であるグリニッジ標準時1970年1月1日から、パラメータsecで指定した秒数経過した時刻を返します。

UTC関数

func UTC() *Time

UTCは現在時刻をUTCタイムゾーンで返します。

(*Time) Asctime関数

func (t *Time) Asctime() string

Asctimeは時刻値をANSI C asctime形式で文字列にフォーマットします。
例:Sun Nov 6 08:49:37 1994

(*Time) RFC1123関数

func (t *Time) RFC1123() string

RFC1123は時刻値をRFC1123 形式で文字列にフォーマットします。
例:Sun, 06 Nov 1994 08:49:37 UTC

(*Time) RFC850関数

func (t *Time) RFC850() string

RFC850は時刻値をRFC1123 形式で文字列にフォーマットします。
例:Sunday, 06-Nov-94 08:49:37 UTC

(*Time) Seconds関数

func (t *Time) Seconds() int64

Secondsは時刻値の、Unix標準時間であるグリニッジ標準時1970年1月1日からの経過秒数を返します。

(*Time) String関数

func (t *Time) String() string

Stringは時刻値をdate(1)形式で文字列にフォーマットします。
例:Sun Nov 6 08:49:37 UTC 1994