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.md36
1 files changed, 36 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..ed49b72b5
--- /dev/null
+++ b/docs/content/en/functions/Unix.md
@@ -0,0 +1,36 @@
+---
+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.
+categories: [functions]
+menu:
+ docs:
+ parent: functions
+function:
+ aliases: []
+ returnType: int64
+ signatures:
+ - .Unix
+ - .UnixMilli
+ - .UnixMicro
+ - .UnixNano
+relatedFunctions: []
+---
+
+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
+```