summaryrefslogtreecommitdiffstats
path: root/docs/content/en/functions/now.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/content/en/functions/now.md')
-rw-r--r--docs/content/en/functions/now.md41
1 files changed, 41 insertions, 0 deletions
diff --git a/docs/content/en/functions/now.md b/docs/content/en/functions/now.md
new file mode 100644
index 000000000..68d628f11
--- /dev/null
+++ b/docs/content/en/functions/now.md
@@ -0,0 +1,41 @@
+---
+title: now
+description: Returns the current local time
+categories: [functions]
+menu:
+ docs:
+ parent: functions
+keywords: [dates,time]
+signature: ["now"]
+relatedfuncs: [Unix,dateFormat]
+---
+
+See [`time.Time`](https://godoc.org/time#Time).
+
+For example, building your site on June 24, 2017, with the following templating:
+
+```go-html-template
+<div>
+ <small>&copy; {{ now.Format "2006" }}</small>
+</div>
+```
+
+would produce the following:
+
+```html
+<div>
+ <small>&copy; 2017</small>
+</div>
+```
+
+The above example uses the [`.Format` function](/functions/format), which page includes a full listing of date formatting using Go's layout string.
+
+{{% note %}}
+Older Hugo themes may still be using the obsolete Page’s `.Now` (uppercase with leading dot), which causes build error that looks like the following:
+
+ ERROR ... Error while rendering "..." in "...": ...
+ executing "..." at <.Now.Format>:
+ can't evaluate field Now in type *hugolib.PageOutput
+
+Be sure to use `now` (lowercase with _**no**_ leading dot) in your templating.
+{{% /note %}}