文档章节

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")。

建议阅读顺序

  1. 先造一个 Duration:字符串用 time.ParseDuration,「数量 + 单位」用 time.Duration。没有 Duration,本章的方法一个也用不上。
  2. Seconds —— 最常用的读数方法,先把「时长 → 数字」跑通。
  3. Hours 与 Minutes —— 换单位,注意返回浮点数。
  4. Milliseconds、Microseconds、Nanoseconds —— 需要整数时用,注意小数被截掉。
  5. Abs —— 只去符号,常用于「相差多久」。
  6. 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 整数倍后的结果。 (今天)