Format
返回根據布局字符串格式化的 time.Time 值的文本表示。
Syntax
TIME.Format LAYOUT
Returns
string
{{ $t := "2023-01-27T23:44:58-08:00" }}
{{ $t = time.AsTime $t }}
{{ $format := "2 Jan 2006" }}
{{ $t.Format $format }} → 27 Jan 2023要 本地化 返回值，請改用 time.Format 函數。
將 Format 方法與任何 time.Time 值一起使用，包括四個預定義的前言日期：
{{ $format := "2 Jan 2006" }}
{{ .Date.Format $format }}
{{ .PublishDate.Format $format }}
{{ .ExpiryDate.Format $format }}
{{ .Lastmod.Format $format }}使用 time.Format 函數來格式化日期的字符串表示，以及格式化不包含時間和時區偏移的原始 TOML 日期。
布局字符串
基於 Go 的參考時間 格式化 time.Time 值：
Mon Jan 2 15:04:05 MST 2006使用這些組件創建布局字符串：
| 描述 | 有效組件 |
|---|---|
| 年 | "2006" "06" |
| 月 | "Jan" "January" "01" "1" |
| 星期幾 | "Mon" "Monday" |
| 月份中的日期 | "2" "_2" "02" |
| 一年中的第幾天 | "__2" "002" |
| 小時 | "15" "3" "03" |
| 分鐘 | "4" "04" |
| 秒 | "5" "05" |
| 上午/下午標記 | "PM" |
| 時區偏移 | "-0700" "-07:00" "-07" "-070000" "-07:00:00" |
將布局字符串中的符號替換為 Z 以打印 Z 而不是 UTC 時區的偏移。
| 描述 | 有效組件 |
|---|---|
| 時區偏移 | "Z0700" "Z07:00" "Z07" "Z070000" "Z07:00:00" |
{{ $t := "2023-01-27T23:44:58-08:00" }}
{{ $t = time.AsTime $t }}
{{ $t = $t.Format "Jan 02, 2006 3:04 PM Z07:00" }}
{{ $t }} → Jan 27, 2023 11:44 PM -08:00諸如 PST 和 CET 之類的字符串不是時區。它們是時區 縮寫。
諸如 -07:00 和 +01:00 之類的字符串不是時區。它們是時區 偏移。
時區是具有相同本地時間的地理區域。例如，由 PST 和 PDT（取決於夏令時）縮寫的時區是 America/Los_Angeles。
示例
給定此外圍元數據：
---
date: 2023-01-27T23:44:58-08:00
title: About time
---+++
date = 2023-01-27T23:44:58-08:00
title = 'About time'
+++{
"date": "2023-01-27T23:44:58-08:00",
"title": "About time"
}
以下示例在 America/Los_Angeles 時區中渲染：
| 格式字符串 | 結果 |
|---|---|
Monday, January 2, 2006 |
Friday, January 27, 2023 |
Mon Jan 2 2006 |
Fri Jan 27 2023 |
January 2006 |
January 2023 |
2006-01-02 |
2023-01-27 |
Monday |
Friday |
02 Jan 06 15:04 MST |
27 Jan 23 23:44 PST |
Mon, 02 Jan 2006 15:04:05 MST |
Fri, 27 Jan 2023 23:44:58 PST |
Mon, 02 Jan 2006 15:04:05 -0700 |
Fri, 27 Jan 2023 23:44:58 -0800 |
UTC 和本地時間
將任何 time.Time 值轉換並格式化為協調世界時 (UTC) 或本地時間。
{{ $t := "2023-01-27T23:44:58-08:00" }}
{{ $t = time.AsTime $t }}
{{ $format := "2 Jan 2006 3:04:05 PM MST" }}
{{ $t.UTC.Format $format }} → 28 Jan 2023 7:44:58 AM UTC
{{ $t.Local.Format $format }} → 27 Jan 2023 11:44:58 PM PST序數表示
使用 humanize 函數將月份中的日期渲染為序數：
{{ $t := "2023-01-27T23:44:58-08:00" }}
{{ $t = time.AsTime $t }}
{{ humanize $t.Day }} of {{ $t.Format "January 2006" }} → 27th of January 2023