summaryrefslogtreecommitdiffstats
path: root/docs/content/en/functions/unix.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/content/en/functions/unix.md')
-rw-r--r--docs/content/en/functions/unix.md31
1 files changed, 31 insertions, 0 deletions
diff --git a/docs/content/en/functions/unix.md b/docs/content/en/functions/unix.md
new file mode 100644
index 000000000..98fcc74a4
--- /dev/null
+++ b/docs/content/en/functions/unix.md
@@ -0,0 +1,31 @@
+---
+title: .Unix
+description: Converts a time.Time value to the number of seconds elapsed since the Unix epoch, excluding leap seconds. The Unix epoch is 00:00:00 UTC on 1 January 1970.
+date: 2017-02-01
+keywords: [dates,time]
+categories: [functions]
+menu:
+ docs:
+ parent: "functions"
+signature: [".Unix",".UnixMilli",".UnixMicro",".UnixNano"]
+relatedfuncs: [Format,dateFormat,now,time]
+---
+
+The `Milli`, `Micro`, and `Nano` variants return the number of milliseconds, microseconds, and nanoseconds (respectively) elapsed since the Unix epoch.
+
+```go-html-template
+.Date.Unix --> 1637259694
+.ExpiryDate.Unix --> 1672559999
+.Lastmod.Unix --> 1637361786
+.PublishDate.Unix --> 1637421261
+
+("1970-01-01T00:00:00-00:00" | time.AsTime).Unix --> 0
+("1970-01-01T00:00:42-00:00" | time.AsTime).Unix --> 42
+("1970-04-11T01:48:29-08:00" | time.AsTime).Unix --> 8675309
+("2026-05-02T20:09:31-07:00" | time.AsTime).Unix --> 1777777771
+
+now.Unix --> 1637447841
+now.UnixMilli --> 1637447841347
+now.UnixMicro --> 1637447841347378
+now.UnixNano --> 1637447841347378799
+```