文档章节
Duration 方法
在 time.Duration 值上使用这些方法。
这一章解决什么问题
time.Duration 是 Hugo 里表示「一段时长」的类型。time.ParseDuration(时长字符串)与 time.Duration(数量 + 单位)负责造出它,本章的九个方法负责把它读出来:算出多少小时、多少秒,或者按某个单位取整。
时长在模板里通常来自三个地方:两个 time.Time 相减(time.Time.Sub)的结果、配置项里的超时/间隔,以及 .ReadingTime 这类现成的 Duration 值。
读完本章你应该能够
- 分清两类方法:返回数字的
Hours、Minutes、Seconds、Milliseconds、Microseconds、Nanoseconds,与返回新 Duration 的Abs、Round、Truncate; - 记住哪些读数方法是浮点数(
Hours、Minutes、Seconds),哪些是整数且小数部分被丢掉(Milliseconds、Microseconds、Nanoseconds); - 用
Round与Truncate把时长对齐到整小时/整分钟,并说清两者对负时长的不同结果; - 认出最常见的两类报错:值还是字符串没解析成 Duration(
can't evaluate field Hours in type string)、参数忘了包成 Duration(expected integer; found "2h")。
建议阅读顺序
- 先造一个 Duration:字符串用
time.ParseDuration,「数量 + 单位」用time.Duration。没有 Duration,本章的方法一个也用不上。 - Seconds —— 最常用的读数方法,先把「时长 → 数字」跑通。
- Hours 与 Minutes —— 换单位,注意返回浮点数。
- Milliseconds、Microseconds、Nanoseconds —— 需要整数时用,注意小数被截掉。
- Abs —— 只去符号,常用于「相差多久」。
- Round 与 Truncate —— 对齐到整单位;两页对负时长的行为不同,建议对照阅读。
本章内容
- Abs 返回给定 time.Duration 值的绝对值。 (今天)
- Hours 以浮点数形式返回该 time.Duration 值对应的小时数。 (今天)
- Microseconds 以整数形式返回该 time.Duration 值对应的微秒数。 (今天)
- Milliseconds 以整数形式返回该 time.Duration 值对应的毫秒数。 (今天)
- Minutes 以浮点数形式返回该 time.Duration 值对应的分钟数。 (今天)
- Nanoseconds 以整数形式返回该 time.Duration 值对应的纳秒数。 (今天)
- Seconds 以浮点数形式返回该 time.Duration 值对应的秒数。 (今天)
- Round 返回把 DURATION1 舍入到最接近 DURATION2 整数倍后的结果。 (今天)
- Truncate 返回把 DURATION1 向零方向截断到 DURATION2 整数倍后的结果。 (今天)