API

`#time`

import: #time

counts: 26 函数, 36 方法, 7 类型, 0 常量, 0 方法集

Duration 为纳秒 int。now/sleep、Time、Timer/Ticker（xu+chan+sleep）。无 IANA 时区。

`nanosecond`

XuAPI

pub fn nanosecond() int

用途

nanosecond，返回 int。

参数

无

int — 该类型的值

`microsecond`

XuAPI

pub fn microsecond() int

用途

microsecond，返回 int。

参数

无

int — 该类型的值

`millisecond`

XuAPI

pub fn millisecond() int

用途

millisecond，返回 int。

参数

无

int — 该类型的值

`second`

XuAPI

pub fn second() int

用途

秒。

参数

无

int — 该类型的值

`minute`

XuAPI

pub fn minute() int

用途

分。

参数

无

int — 该类型的值

`hour`

XuAPI

pub fn hour() int

用途

时。

参数

无

int — 该类型的值

`now`

XuAPI

pub fn now() int

用途

当前时间。

参数

无

int — 该类型的值

`sleep`

XuAPI

pub fn sleep(d int)

用途

阻塞等待一段时间。

参数

d int: d（int）

`since`

XuAPI

pub fn since(t int) int

用途

以来。

参数

t int: t（int）

int — 该类型的值

`struct Time`

XuAPI

pub struct Time {
    pub sec int
    pub nsec int
}

用途

公开结构体 `Time`。

参数

sec int: 字段（int）
nsec int: 字段（int）

`unix`

XuAPI

pub fn unix(sec int, nsec int) Time

用途

Unix 时间。

参数

sec int: sec（int）
nsec int: nsec（int）

Time — 该类型的值

`unix_from_ns`

XuAPI

pub fn unix_from_ns(ns int) Time

用途

Unix 时间从ns。

参数

ns int: ns（int）

Time — 该类型的值

`(Time) unix`

XuAPI

pub fn (t Time) unix() int

用途

`Time` 上的方法：Unix 时间。

参数

t Time: 接收者 Time（值接收者）

int — 该类型的值

`(Time) is_zero`

XuAPI

pub fn (t Time) is_zero() bool

用途

`Time` 上的方法：判断是否 zero。

参数

t Time: 接收者 Time（值接收者）

bool — 是否成立

`(Time) unix_nano`

XuAPI

pub fn (t Time) unix_nano() int

用途

`Time` 上的方法：Unix 时间nano。

参数

t Time: 接收者 Time（值接收者）

int — 该类型的值

`(Time) unix_milli`

XuAPI

pub fn (t Time) unix_milli() int

用途

`Time` 上的方法：Unix 时间milli。

参数

t Time: 接收者 Time（值接收者）

int — 该类型的值

`(Time) unix_micro`

XuAPI

pub fn (t Time) unix_micro() int

用途

`Time` 上的方法：Unix 时间micro。

参数

t Time: 接收者 Time（值接收者）

int — 该类型的值

`unix_milli`

XuAPI

pub fn unix_milli(ms int) Time

用途

Unix 时间milli。

参数

ms int: ms（int）

Time — 该类型的值

`unix_micro`

XuAPI

pub fn unix_micro(us int) Time

用途

Unix 时间micro。

参数

us int: us（int）

Time — 该类型的值

`(Time) add`

XuAPI

pub fn (t Time) add(d int) Time

用途

`Time` 上的方法：相加。

参数

t Time: 接收者 Time（值接收者）
d int: d（int）

Time — 该类型的值

`(Time) sub`

XuAPI

pub fn (t Time) sub(u Time) int

用途

`Time` 上的方法：相减。

参数

t Time: 接收者 Time（值接收者）
u Time: u（Time）

int — 该类型的值

`(Time) before`

XuAPI

pub fn (t Time) before(u Time) bool

用途

在 `Time` 上调用 `before`。

参数

t Time: 接收者 Time（值接收者）
u Time: u（Time）

bool — 是否成立

`(Time) after`

XuAPI

pub fn (t Time) after(u Time) bool

用途

在 `Time` 上调用 `after`。

参数

t Time: 接收者 Time（值接收者）
u Time: u（Time）

bool — 是否成立

`(Time) equal`

XuAPI

pub fn (t Time) equal(u Time) bool

用途

`Time` 上的方法：判断两值是否相等。

参数

t Time: 接收者 Time（值接收者）
u Time: u（Time）

bool — 是否成立

`now_time`

XuAPI

pub fn now_time() Time

用途

当前时间time。

参数

无

Time — 该类型的值

`parse_duration`

XuAPI

pub fn parse_duration(s &string) int

用途

解析为 duration。失败时 throw。

参数

s &string: 源字符串（借用，调用方仍持有；类型 &string）

int — 该类型的值

`format_duration`

XuAPI

pub fn format_duration(d int) string

用途

格式化为 duration。

参数

d int: d（int）

string — 结果字符串

`(Time) format_rfc3339`

XuAPI

pub fn (t Time) format_rfc3339() string

用途

`Time` 上的方法：格式化为 rfc3339。

参数

t Time: 接收者 Time（值接收者）

string — 结果字符串

`(Time) format_log`

XuAPI

pub fn (t Time) format_log(date int, tod int, micro int) string

用途

`Time` 上的方法：格式化为 log。

参数

t Time: 接收者 Time（值接收者）
date int: date（int）
tod int: tod（int）
micro int: micro（int）

string — 结果字符串

`parse_rfc3339`

XuAPI

pub fn parse_rfc3339(s &string) Time

用途

解析为 rfc3339。失败时 throw。

参数

s &string: 源字符串（借用，调用方仍持有；类型 &string）

Time — 该类型的值

`(Time) add_date`

XuAPI

pub fn (t Time) add_date(years int, months int, days int) Time

用途

`Time` 上的方法：增加日期。

参数

t Time: 接收者 Time（值接收者）
years int: years（int）
months int: months（int）
days int: days（int）

Time — 该类型的值

`date`

XuAPI

pub fn date(year int, month int, day int, hour int, min int, sec int, nsec int) Time

用途

日期。

参数

year int: year（int）
month int: month（int）
day int: day（int）
hour int: hour（int）
min int: 下限（int）
sec int: sec（int）
nsec int: nsec（int）

Time — 该类型的值

`(Time) year`

XuAPI

pub fn (t Time) year() int

用途

`Time` 上的方法：年。

参数

t Time: 接收者 Time（值接收者）

int — 该类型的值

`(Time) month`

XuAPI

pub fn (t Time) month() int

用途

`Time` 上的方法：月。

参数

t Time: 接收者 Time（值接收者）

int — 该类型的值

`(Time) day`

XuAPI

pub fn (t Time) day() int

用途

`Time` 上的方法：日。

参数

t Time: 接收者 Time（值接收者）

int — 该类型的值

`(Time) year_day`

XuAPI

pub fn (t Time) year_day() int

用途

`Time` 上的方法：年日。

参数

t Time: 接收者 Time（值接收者）

int — 该类型的值

`struct Clock`

XuAPI

pub struct Clock {
    pub hour int
    pub min int
    pub sec int
}

用途

公开结构体 `Clock`。

参数

hour int: 字段（int）
min int: 下限
sec int: 字段（int）

`(Time) clock`

XuAPI

pub fn (t Time) clock() Clock

用途

在 `Time` 上调用 `clock`。

参数

t Time: 接收者 Time（值接收者）

Clock — 该类型的值

`(Time) nanosecond`

XuAPI

pub fn (t Time) nanosecond() int

用途

在 `Time` 上调用 `nanosecond`。

参数

t Time: 接收者 Time（值接收者）

int — 该类型的值

`struct DateParts`

XuAPI

pub struct DateParts {
    pub year int
    pub month int
    pub day int
}

用途

公开结构体 `DateParts`。

参数

year int: 字段（int）
month int: 字段（int）
day int: 字段（int）

`(Time) date_parts`

XuAPI

pub fn (t Time) date_parts() DateParts

用途

`Time` 上的方法：日期parts。

参数

t Time: 接收者 Time（值接收者）

DateParts — 该类型的值

`(Time) hour`

XuAPI

pub fn (t Time) hour() int

用途

`Time` 上的方法：时。

参数

t Time: 接收者 Time（值接收者）

int — 该类型的值

`(Time) minute`

XuAPI

pub fn (t Time) minute() int

用途

`Time` 上的方法：分。

参数

t Time: 接收者 Time（值接收者）

int — 该类型的值

`(Time) second`

XuAPI

pub fn (t Time) second() int

用途

`Time` 上的方法：秒。

参数

t Time: 接收者 Time（值接收者）

int — 该类型的值

`struct ISOWeek`

XuAPI

pub struct ISOWeek {
    pub year int
    pub week int
}

用途

公开结构体 `ISOWeek`。

参数

year int: 字段（int）
week int: 字段（int）

`(Time) iso_week`

XuAPI

pub fn (t Time) iso_week() ISOWeek

用途

`Time` 上的方法：isoweek。

参数

t Time: 接收者 Time（值接收者）

ISOWeek — 该类型的值

`(Time) weekday`

XuAPI

pub fn (t Time) weekday() int

用途

`Time` 上的方法：星期。

参数

t Time: 接收者 Time（值接收者）

int — 该类型的值

`weekday_name`

XuAPI

pub fn weekday_name(d int) string

用途

星期名称。

参数

d int: d（int）

string — 结果字符串

`month_name`

XuAPI

pub fn month_name(m int) string

用途

月名称。

参数

m int: m（int）

string — 结果字符串

`(Time) truncate`

XuAPI

pub fn (t Time) truncate(d int) Time

用途

`Time` 上的方法：截断。

参数

t Time: 接收者 Time（值接收者）
d int: d（int）

Time — 该类型的值

`(Time) round`

XuAPI

pub fn (t Time) round(d int) Time

用途

`Time` 上的方法：舍入。

参数

t Time: 接收者 Time（值接收者）
d int: d（int）

Time — 该类型的值

`until`

XuAPI

pub fn until(t Time) int

用途

直到。

参数

t Time: t（Time）

int — 该类型的值

`struct Timer`

XuAPI

pub struct Timer {
    pub c chan int
    pub stop chan int
}

用途

公开结构体 `Timer`。

参数

c chan int: 字节或字符码
stop chan int: 字段（通道；类型 chan int）

`new_timer`

XuAPI

pub fn new_timer(d int) Timer

用途

构造 timer。

参数

d int: d（int）

Timer — 该类型的值

`(Timer) stop`

XuAPI

pub fn (t Timer) stop()

用途

`Timer` 上的方法：停止。

参数

t Timer: 接收者 Timer（值接收者）

`struct Ticker`

XuAPI

pub struct Ticker {
    pub c chan int
    pub stop chan int
}

用途

公开结构体 `Ticker`。

参数

c chan int: 字节或字符码
stop chan int: 字段（通道；类型 chan int）

`new_ticker`

XuAPI

pub fn new_ticker(d int) Ticker

用途

构造 ticker。

参数

d int: d（int）

Ticker — 该类型的值

`(Ticker) stop`

XuAPI

pub fn (t Ticker) stop()

用途

`Ticker` 上的方法：停止。

参数

t Ticker: 接收者 Ticker（值接收者）

`struct Location`

XuAPI

pub struct Location {
    pub name string
    pub offset_sec int
    pub dst_offset_sec int
    pub has_dst int
    pub dst_sm int
    pub dst_sn int
    pub dst_sd int
    pub dst_st int
    pub dst_em int
    pub dst_en int
    pub dst_ed int
    pub dst_et int
    pub before_off int
    pub trans_sec []int
    pub trans_off []int
}

用途

公开结构体 `Location`。

参数

name string: 名字
offset_sec int: 字段（int）
dst_offset_sec int: 字段（int）
has_dst int: 字段（int）
dst_sm int: 字段（int）
dst_sn int: 字段（int）
dst_sd int: 字段（int）
dst_st int: 字段（int）
dst_em int: 字段（int）
dst_en int: 字段（int）
dst_ed int: 字段（int）
dst_et int: 字段（int）
before_off int: 字段（int）
trans_sec []int: 字段（[]int）
trans_off []int: 字段（[]int）

`utc`

XuAPI

pub fn utc() Location

用途

UTC。

参数

无

Location — 该类型的值

`fixed_zone`

XuAPI

pub fn fixed_zone(name string, offset_sec int) Location

用途

fixedzone。

参数

name string: 名字（string）
offset_sec int: offset_sec（int）

Location — 该类型的值

`load_location`

XuAPI

pub fn load_location(name string) Location

用途

读location。失败时 throw。

参数

name string: 名字（string）

Location — 该类型的值

`(Time) year_in`

XuAPI

pub fn (t Time) year_in(loc &Location) int

用途

`Time` 上的方法：年in。

参数

t Time: 接收者 Time（值接收者）
loc &Location: loc（借用，调用方仍持有；类型 &Location）

int — 该类型的值

`(Time) month_in`

XuAPI

pub fn (t Time) month_in(loc &Location) int

用途

`Time` 上的方法：月in。

参数

t Time: 接收者 Time（值接收者）
loc &Location: loc（借用，调用方仍持有；类型 &Location）

int — 该类型的值

`(Time) day_in`

XuAPI

pub fn (t Time) day_in(loc &Location) int

用途

`Time` 上的方法：日in。

参数

t Time: 接收者 Time（值接收者）
loc &Location: loc（借用，调用方仍持有；类型 &Location）

int — 该类型的值

`(Time) hour_in`

XuAPI

pub fn (t Time) hour_in(loc &Location) int

用途

`Time` 上的方法：时in。

参数

t Time: 接收者 Time（值接收者）
loc &Location: loc（借用，调用方仍持有；类型 &Location）

int — 该类型的值

`(Time) minute_in`

XuAPI

pub fn (t Time) minute_in(loc &Location) int

用途

`Time` 上的方法：分in。

参数

t Time: 接收者 Time（值接收者）
loc &Location: loc（借用，调用方仍持有；类型 &Location）

int — 该类型的值

`(Time) second_in`

XuAPI

pub fn (t Time) second_in(loc &Location) int

用途

`Time` 上的方法：秒in。

参数

t Time: 接收者 Time（值接收者）
loc &Location: loc（借用，调用方仍持有；类型 &Location）

int — 该类型的值

`(Time) format_rfc3339_in`

XuAPI

pub fn (t Time) format_rfc3339_in(loc &Location) string

用途

`Time` 上的方法：格式化为 rfc3339 in。

参数

t Time: 接收者 Time（值接收者）
loc &Location: loc（借用，调用方仍持有；类型 &Location）

string — 结果字符串